!=============================================================================!
!  DIVISION   I	:				     HELP MODULE DECLARATION  !
!=============================================================================!
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 01 :					 INITIAL VERSION      !
!      -----------------------------------------------------------------      !
!									      !
!      File Specification: ACCSRC_HELPOPR:RSVOPR.HLP			      !
!      Author		 : Marlys A. Nelson				      !
!      Initial version	 : 01.00.00 15-OCT-1984	VMS 3.6			      !
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 02 :				    MODIFICATION HISTORY      !
!      -----------------------------------------------------------------      !
!									      !
!									      !
!=============================================================================!
!  DIVISION  II	:				  HELP MODULE SPECIFICATIONS  !
!=============================================================================!
!									      !
!      Key 1 (Command name)............	RSVOPR                                !
!	 Key 2 ........................	  Operation                           !
!	 Key 2 ........................	  Examples                            !
!	 Key 2 ........................	  Errors                              !
!	 Key 2 ........................   Qualifiers			      !
!	   /qualifier .................	    /DMBX                             !
!	   /qualifier .................     /HALT			      !
!	   /qualifier .................     /RESYNC			      !
!	   /qualifier .................     /START			      !
!	   /qualifier .................     /VERSION			      !
!									      !
!=============================================================================!
!  DIVISION III	:					       SPECIAL NOTES  !
!=============================================================================!
!									      !
!									      !
!=============================================================================!
!
!
!=============================================================================!
! Key 1								       RSVOPR !
!=============================================================================!
!
1 RSVOPR
Allows  the  system  operator  to  control  the  terminal  reservation
software system.

Format:

     RSVOPR
!
!=============================================================================!
! Key 2								    Operation !
!=============================================================================!
!
2 Operation
RSVOPR  allows  the  operator  to  start,  stop  and resynchronize the
terminal reservation program.  Also,  various  maintenance  functions,
such  as  deleting  the  permanent reservation software mailboxes, are
possible.

The  terminal  reservation  system  operates  as  a  detached process,
initially started at system startup time by  the  automatic  SYSTARTUP
procedure.   If  the  reservation  program  should  terminate, you can
restart it as a detached process using the  RSVOPR  qualifier  /START.
Even  though  it  is possible to initiate a detached process from DCL,
you should not attempt to  start  the  reservation  software  in  this
manner.   There  are  many  qualifiers necessary to start the terminal
reservation system successfully.

To  maintain  efficiency  and speed, the terminal reservation software
maintains much of the terminal reservation information in memory.   It
does  not  always  write  out complete reservation information to disk
while it is running.  When the reservation software is halted however,
it   updates   various   disk   files  with  the  current  reservation
information.  To properly halt the terminal reservation software,  you
should  always  use the RSVOPR command with the qualifier /HALT.  This
forces all  reservation  disk  files  to  be  updated.   The  terminal
reservation   software   is  capable  of  recovering  all  reservation
information not properly written  to  disk,  but  this  requires  5-15
minutes of extra time when the software is started the next time.

If  a  student  begins to enter a command at the reservation terminal,
but  does  not  complete  it  by  pressing  <RETURN>,   the   terminal
reservation  software can lose track of the current time of day.  This
will occur if the incomplete command remains  past  the  half-hour  or
hour time break.  You can determine if this has happened by entering a
simple SHOW command.  If the display does not begin with  the  current
time  period,  the terminal reservation software has lost track of the
time.  You can  force  the  software  to  correct  this  situation  by
entering the RSVOPR command with the /RESYNC qualifier.
!
!=============================================================================!
! Key 2								     Examples !
!=============================================================================!
!
2 Examples
To halt the terminal reservation software in an orderly manner,  enter
the command:

     $ RSVOPR/HALT
     %RSV-S-OPRHALT, 'Reserve' process halted

The terminal reservation program has halted.  To restart the software,
simply enter the command:

     $ RSVOPR/START
     %RSV-S-OPRSTART, 'Reserve' process started (00010033)

Someone  entered  a  command  to  reserve, but did not press <RETURN>.
This was 3 hours ago.  Reserve does not know the  correct  time.   You
can correct this situation by entering:

     $ RSVOPR/RESYNC
     %RSV-S-OPRRESYNC, 'Reserve' process resynchronized
!
!=============================================================================!
! Key 2								       Errors !
!=============================================================================!
!
2 Errors
Operational errors detected by RSVOPR  are  documented  below.   These
errors  are  identified  by  the  error facility code %RSV and are not
documented within any VAX/VMS manuals.  If RSVOPR encounters a  system
error  during  execution,  it  will  print  the  system error message.
System errors are  usually  identified  by  the  error  facility  code
%SYSTEM.   If  you  receive a system error, consult the VAX/VMS System
Error Message Manual.  Also, PASCAL  language  run-time  errors  could
cause  RSVOPR  to  abort.   These  are identified by the facility code
%PASCAL.  Please inform the system manager of these errors.
!
!=============================================================================!
! Key 3                                                             CONFLQUAL !
!=============================================================================!
!
3 CONFLQUAL
%RSV-E-CONFLQUAL, conflicting qualifiers specified on command

You have specified more than one qualifier  on  the  command  and  the
qualifiers  specify conflicting actions.  You cannot specify the /DMBX
qualifier with /HALT, /START or /RESYNC.  Also, you cannot specify the
qualifiers  /HALT and /START in the same command.  Reenter the desired
qualifiers as separate commands.
!
!=============================================================================!
! Key 3                                                             GETDVIERR !
!=============================================================================!
!
3 GETDVIERR
%RSV-F-GETDVIERR, unable to obtain device information

RSVOPR  attempts  to determine information about the device from which
it is run.  This information is necessary to  use  internal  routines.
RSVOPR  was  unable  to  successfully obtain the requested information
using the $GETDVI system service.  You will not  be  able  to  recover
from this error.  Please notify the system manager.
!
!=============================================================================!
! Key 3                                                             LCKGETERR !
!=============================================================================!
!
3 LCKGETERR
%RSV-F-LCKGETERR, resource lock get error

RSVOPR uses a system resource lock to  coordinate  access  to  various
terminal  reservation  software  items.   The  attempt  to  get such a
resource lock failed.  RSVOPR cannot proceed.  You will not be able to
recover from this error.  Please notify the system manager.
!
!=============================================================================!
! Key 3                                                             LCKRELERR !
!=============================================================================!
!
3 LCKRELERR
%RSV-F-LCKRELERR, resource lock release error

RSVOPR uses a system resource lock to  coordinate  access  to  various
terminal  reservation  software  items.  The attempt to release such a
resource lock failed.  If the /START qualifier was  specified,  RSVOPR
is  not  able  to  proceed.   Otherwise,  RSVOPR may have successfully
completed the requested function  even  though  this  error  occurred.
Please notify the system manager of this error.
!
!=============================================================================!
! Key 3                                                            LCKUNAVAIL !
!=============================================================================!
!
3 LCKUNAVAIL
%RSV-F-LCKUNAVAIL,  reservation  system resource lock not available at
this time

RSVOPR  uses  a  system  resource lock to coordinate access to various
terminal  reservation  software  items.   Another  component  in   the
terminal  reservation software system holds the resource lock.  RSVOPR
must obtain exclusive access to the resource lock in order to proceed.
The  resource  lock  should be available unless the reserve process is
currently in the process of startup.  Wait until the  reserve  process
is  completely  started  and  then reissue this command.  If you still
cannot successfully  enter  the  RSVOPR  command,  notify  the  system
manager.
!
!=============================================================================!
! Key 3                                                             MBXOPNERR !
!=============================================================================!
!
3 MBXOPNERR
%RSV-F-MBXOPNERR, mailbox open error

RSVOPR uses two software mailboxes to  communicate  with  the  reserve
process.   It  is unable to open one or both of these mailboxes.  This
error probably indicates the inability of RSVOPR to  obtain  necessary
resources  to  use  the mailboxes.  It should not occur simply because
the mailboxes are non-existent.  If the mailboxes do not  exist,  they
are  automatically created when the first attempt is made to use them.
You may not be able to recover from this  error.   Please  notify  the
system manager.
!
!=============================================================================!
! Key 3                                                         MSGCHNUNAVAIL !
!=============================================================================!
!
3 MSGCHNUNAVAIL
%RSV-F-MSGCHNUNAVAIL, message system channel unavailable

RSVOPR requires an open channel to the terminal from which  RSVOPR  is
used.   RSVOPR  was  unable  to  obtain  such  a channel by use of the
$ASSIGN system service.  You will not be able  to  recover  from  this
error.  Please notify the system manager.
!
!=============================================================================!
! Key 3                                                           MUSTUSETERM !
!=============================================================================!
!
3 MUSTUSETERM
%RSV-F-MUSTUSETERM, must be used from a terminal

RSVOPR must be used from a terminal.  It cannot be used in batch mode.
!
!=============================================================================!
! Key 3                                                             RSVCURACT !
!=============================================================================!
!
3 RSVCURACT
%RSV-E-RSVCURACT, 'Reserve' process currently active

You  have attempted to /START the terminal reservation software but it
is already active.  If you wish to restart the software, use the /HALT
command and then enter the /START command.  This error can also result
from attempting to delete the software  mailboxes  while  the  reserve
process is active.
!
!=============================================================================!
! Key 3                                                             RSVNOTACT !
!=============================================================================!
!
3 RSVNOTACT
%RSV-E-RSVNOTACT, 'Reserve' process not active

You have attempted to /HALT the terminal reservation software  but  it
is  not currently active.  This error can also occur if you attempt to
resynchronize the software while the reserve process is not active.
!
!=============================================================================!
! Key 3                                                             STARTFAIL !
!=============================================================================!
!
3 STARTFAIL
%RSV-E-STARTFAIL, unable to start process; error %Xdddddddd

RSVOPR  was unable to start the detached process.  The error number is
given by the '%Xdddddddd' value.  The exact cause can be determined by
locating  the symbol name corresponding to this value.  You may not be
able to recover from this error.  Please notify the system manager.
!
!=============================================================================!
! Key 2								   Qualifiers !
!=============================================================================!
!
2 Qualifiers
/DMBX

  Deletes   the  permanent  system  mailboxes  used  by  the  terminal
  reservation software for communications.  There are  two  mailboxes:
  RSV_Mailbox1   and   RSV_Mailbox2.   The  RSVOPR  command  uses  the
  mailboxes  to  communicate  with  the  actual  terminal  reservation
  program.   The  terminal reservation manager program also uses these
  mailboxes.  You should never  need  to  delete  the  mailboxes.   If
  however,  spurious  messages  have been written to the mailboxes and
  the terminal reservation software will not operate, you  can  delete
  the  mailboxes.   You do not need to rebuild the mailboxes.  This is
  automatic if the software does not find  the  mailboxes  already  in
  existence.   One  situation  in  which  you  may  need to delete the
  mailboxes is if the terminal reservation software halts  immediately
  after  starting  (with  the HALT screen displayed) or if it displays
  the 'temporarily unavailable' screen and the reservation  management
  program is not in use.

/HALT

  Sends a message, via the  reservation  software  mailboxes,  to  the
  terminal  reservation program directing it to halt.  This causes all
  disk files to be updated with the information retained in memory  by
  the  reserve  process.   This  is  the  only  valid way to terminate
  reserve.  You should not stop the reservation software with the  DCL
  command STOP!  If you fail to use /HALT, it may require 5-15 minutes
  to restart the reservation system next time.

  Once the /HALT command is issued, the command will not end until  it
  verifies that the reserve process has actually terminated.  There is
  a minimum delay of 15 seconds.

/RESYNC

  Sends a message, via the  reservation  software  mailboxes,  to  the
  terminal  reservation program directing it to resynchronize its time
  display based upon the current time of day.  This can be used if  an
  incomplete  command  has  been abandoned on the reservation terminal
  command line, causing the current time period shown by reserve to be
  wrong.

/START

  Initiates  a  detached  process  to  run  the  terminal  reservation
  software.   All  necessary  parameters,  qualifiers  and  privileges
  needed  by  the  reserve  process  are  set.   You  should  use this
  qualifier rather  than  the  DCL  command  RUN/UIC=  to  create  the
  detached process.

/VERSION

  Displays  the  current  version  of  the  RSVOPR  program.  No other
  function occurs.  This qualifier  may  not  appear  with  any  other
  qualifier.
!
!=============================================================================!
!							   END OF HELP MODULE !
!=============================================================================!
