!=============================================================================!
!  DIVISION   I	:				     HELP MODULE DECLARATION  !
!=============================================================================!
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 01 :					 INITIAL VERSION      !
!      -----------------------------------------------------------------      !
!									      !
!      File Specification: RESERVE.HLP					      !
!      Author		 : Marlys A. Nelson				      !
!      Initial version	 : 01.00.00 01-SEP-1984	VMS 3.6			      !
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 02 :				    MODIFICATION HISTORY      !
!      -----------------------------------------------------------------      !
!									      !
!      01.00.01 14-OCT-1985 VMS 4.2: Marlys A. Nelson			      !
!		Bring on-line help up-to-date.				      !
!									      !
!=============================================================================!
!  DIVISION  II	:				  HELP MODULE SPECIFICATIONS  !
!=============================================================================!
!									      !
!      Key 1 (Command name)............	Reserve				      !
!	 Key 2 ........................	  Discussion			      !
!	 Key 2 ........................	  Grid				      !
!	 Key 2 ........................   DELETE			      !
!	   Key 3 ......................     Parameters			      !
!	   Key 3 ......................     Discussion			      !
!	   Key 3 ......................     Example			      !
!	 Key 2 ........................   HELP				      !
!	   Key 3 ......................     Parameters			      !
!	   Key 3 ......................     Discussion			      !
!	   Key 3 ......................     Example			      !
!	 Key 2 ........................   PRINT				      !
!	   Key 3 ......................     Parameters			      !
!	   Key 3 ......................     Discussion			      !
!	   Key 3 ......................     Example			      !
!	 Key 2 ........................	  RESERVE			      !
!	   Key 3 ......................     Parameters			      !
!	   Key 3 ......................     Discussion			      !
!	   Key 3 ......................     Example			      !
!	 Key 2 ........................	  SHOW				      !
!	   Key 3 ......................     Parameters			      !
!	   Key 3 ......................     Discussion			      !
!	   Key 3 ......................     Example			      !
!									      !
!=============================================================================!
!  DIVISION III	:					       SPECIAL NOTES  !
!=============================================================================!
!									      !
!									      !
!=============================================================================!
!
!=============================================================================!
! Key 1								      Reserve !
!=============================================================================!
!
1 Reserve
All  valid  RESERVE  commands  are  shown  below.  Each command may be 
abbreviated to a single letter.  The required letter of  each  command 
is  shown  in CAPITAL letters.  All lower case letters, in the command 
name, are  optional.   You  may  always  enter  the  complete  command 
however, if you wish. 

  Delete	Cancels a previously entered terminal reservation.

  Help		Provides information about the use of RESERVE and  the
		available commands.

  Print		Prints  a  detailed  terminal reservation chart on the
		line printer for a specific date.

  Reserve	Enters a terminal reservation.

  Show		Displays, on the terminal screen, the current terminal
		reservations for a specific date.

  <ctrl>W	Redraws the screen.
!
!=============================================================================!
! Key 2								   Discussion !
!=============================================================================!
!
2 Discussion
Terminals in the Academic Computing Center Terminal Lab in North  Hall
may  be  reserved  by  anyone who has an individual computer username.
Such usernames are provided for students enrolled in computer  science
courses  and  various  other  courses  taught  in  other  departments.
Students who have reserved a  terminal  have  the  right  to  use  the
terminal  at the reserved time.  If someone else is using the terminal
you have reserved, ask that person to please logoff and allow  you  to
use it.  If you have problems, see the student operator on duty.

The  amount  of  time  which you may reserve is limited.  The standard
limit is one hour per day for any  individual  username.   This  limit
will vary depending upon the course however.

To  reserve  a  terminal,  you  must  enter  the  date  and time to be
reserved, the terminal desired and the computer username  under  which
you  intend  to access the system.  To finalize your reservation, your
password will be requested.  You must enter the same password you  use
when you logon the computer.
!
!=============================================================================!
! Key 2									 Grid !
!=============================================================================!
!
2 Grid
The  main  item  in  the  terminal  reservation  system  is the screen 
display.  When in operation, the reservation  terminal  screen  always 
displays  a  grid  which  indicates  the  current  status  (available, 
reserved, etc.) of all terminals for the next 4  hours  (current  time 
period plus 7 more time periods). 

The  display  grid is shown with the available terminals listed across 
the top of the screen and the time periods  listed  down  the  screen. 
Each  location  within  the reservation grid corresponds to a terminal 
which may be reserved for a specific time  period.   If  the  location 
contains  the  symbols 'xx', this indicates the given terminal in that 
time period is reserved.  If the location contains the  symbols  'cc', 
the  terminal  lab is closed.  The terminal is available (i.e.  can be 
reserved) if the grid location is blank.

The screen  display  will  be  updated,  if  necessary,  each  time  a 
reservation or deletion is made, or every 30 minutes, whichever occurs 
first. 

A sample terminal screen is shown below.  This is the type of  display 
which will be present at all times on the reservation terminal screen. 

|====================================================================|
|WED, 27-JUN   T1 T2 T3 T4 T5 G1 G2 G3 V0 V1 V2 V3 V4 V5 V6 V7 D1 D2 | 
|                                                                    | 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 6:30 am     |cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|cc|| 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 7:00 am     |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 7:30 am     |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 8:00 am     |  |  |  |  |  |  |  |  |  |xx|  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 8:30 am     |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 9:00 am     |xx|  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
| 9:30 am     |xx|  |  |  |  |  |  |  |  |  |  |  |  |  |  |xx|  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
|10:00 am     |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  || 
|             |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|| 
|                                                                    | 
|                                                                    | 
|Command    : ( user command )                                       | 
|             ( error message details or password prompt request )   | 
|             ( messages; error and informational )                  | 
|====================================================================|

The SHOW command produces a similar  screen  display  grid.   You  may 
control  the  date,  time periods and terminals shown however.  If all 
the information you request requires more space than available on  the 
screen  (i.e.   more  than 8 time periods), RESERVE will automatically 
'page' the information.  Your requested information  will  be  divided 
into  smaller sections which will fit on the terminal screen.  RESERVE 
will pause after it has displayed each screen and  you  will  have  to 
press the <RETURN> key before RESERVE will continue. 

A more detailed reservation chart may be printed on the  line  printer
by  use  of  the  command  PRINT.   This  detailed  grid will show the
computer username under which  the  terminal  reservations  have  been
entered.  Prior to each hour, the computing center operator will print
such a chart for the current day and post it  on  the  bulletin  board
inside the terminal lab.  You may refer to this chart for the terminal
and time periods at which you have made a reservation.  This  grid  is
for reference ONLY and you may NOT reserve a terminal by signing up on
this chart.

The previous discussion has  centered  on  the  grid  portion  of  the
display  screen.  The screen has another area, the bottom three lines,
which is used for specific purposes also.  The sample terminal  screen
indicates  what  types of information can be expected on each of these
lines.
!
!=============================================================================!
! Key 2								       Delete !
!=============================================================================!
!
2 DELETE
Cancels a previously entered terminal reservation.

Syntax:

  Delete [date] time[,time] termid[,termid] username
!
!
!
3 Parameters 
date

  Specifies  the  date  for  which  you  wish  to  delete  a  terminal
  reservation.  This is optional.  If you do not enter this parameter,
  today's  date  is  assumed.   The  date  can  be specified in any of
  several ways.  The most common is 'mm/dd/yy'.  You  may  also  enter
  the  date  in  the form 'dd-mmm-yyyy'.  The year is optional in both
  forms shown.  If not specified, the year  defaults  to  the  current
  year.

time

  Specifies the time period during the day at which you wish to delete
  a terminal reservation.  This time is entered in the form 'hh:mm xx'
  where  'xx'  is  either  'AM'  or  'PM'.  You can omit the 'AM'/'PM'
  designation, in which case, RESERVE assumes 'military time' (24-hour
  clock  where  3:00 PM is written as 15:00).  If you are specifying a
  time period which occurs on the hour, such as 10:00 AM, you can omit
  the  ':mm'  portion  and  enter the time simply as '10 AM', or '10'.
  Time periods switch at  the  hour  and  half-hour  times.   You  can
  specify  minutes other than ':00' or ':30' but RESERVE rounds to the
  nearest time period division.

  One time period parameter is required.  The  first  time  period  is
  always  associated  with  the first terminal id specified.  A second
  time period is optional.  If the second time period is specified, it
  applies  to  the second terminal id.  If a second terminal id is not
  specified, then the second time  period  will  apply  to  the  first
  terminal id also.

termid

  Specifies the terminal for which you wish to cancel  a  reservation.
  This  is  a  two-character  value.  The valid terminal ids are those
  listed at the top of the terminal display screen.

  One terminal id is  required.   The  first  terminal  id  is  always
  associated  with the first time period specified.  A second terminal
  id is optional.  If the second terminal id is specified, it  applies
  to  the  second  time  period.   If  a  second  time  period  is not
  specified, then the second terminal id will apply to the first  time
  period also.

username

  This  is  the  computer  username  under which you made the original
  reservation.
!
!
!
3 Discussion 
Terminal reservations may NOT  be  deleted  for  dates  prior  to  the 
current  date,  nor for a time period within the current date prior to 
the current time period. 

Before  a  reservation  is  actually deleted, you will be prompted for
your password.  This must be entered correctly or  the  deletion  will
not  be  performed.  You will have three attempts to enter the correct
password before the command is terminated.

The terminal  display  screen  will  be  updated  if  the  reservation 
deletion  you  make  is  included within the currently displayed date, 
time periods and terminal ids. 
!
!
!
3 Example 
To delete a terminal  reservation  previously  made  for  terminal  V3
on 12/15/82 at 2:00 PM, under the logon 1711_JOHNSON, you would enter: 

     Command: DELETE 12/15/82 2 PM V3 1711_JOHNSON 
              User password ? (you must enter your password to verify) 
                              (the reservation deletion              ) 
              Reservation deleted. 

To  delete   the   two  reservations  previously  made  for  the  time
periods 11:00 AM and 11:30 AM on terminal  V5  on 3/16/83,  under  the
login 1731_SMITH, you would enter: 

     Command: DELETE 3/16/83 11 AM,11:30 AM V5 1731_SMITH
              User password ? (you must enter your password to verify)
                              (the reservation deletion              )
              Reservation deleted.
!
!=============================================================================!
! Key 2									 Help !
!=============================================================================!
!
2 HELP 
Provides  information  about  the  terminal reservation system and the 
commands available. 

Syntax:

     Help [topic] 
!
!
!
3 Parameters 
topic

  One  of  the  valid  terminal  reservation  commands  or  one of the
  recognized HELP topics.
!
!
!
3 Discussion 
By default, entering the HELP command will print a general overview of
the  terminal  reservation  system.   All  the  valid commands will be
displayed with a brief  description.   More  detailed  information  is
available  on  specific  commands  or  on  other areas of the terminal
reservation system.

HELP is interactive.  Once the information you initially requested has
been  printed,  you are prompted for additional HELP topics.  <RETURN>
in response to the HELP 'Topic' prompt terminates the HELP command.
!
!=============================================================================!
! Key 2								        Print !
!=============================================================================!
!
2 PRINT
Prints a detailed terminal reservation chart to the line printer. 

Syntax:

  Print [date] [ time[,time] [ termid[,termid] ] ]
!
!
!
3 Parameters 
date

  Specifies the  date  for  which  terminal  reservations  are  to  be
  printed.   This  is  optional.   If you do not enter this parameter,
  today's date is assumed.  The  date  can  be  specified  in  any  of
  several  ways.   The  most common is 'mm/dd/yy'.  You may also enter
  the date in the form 'dd-mmm-yyyy'.  The year is  optional  in  both
  forms  shown.   If  not  specified, the year defaults to the current
  year.

time

  Specifies  the  time  period during the day which you wish to print.
  This time is entered in the form 'hh:mm xx'  where  'xx'  is  either
  'AM'  or  'PM'.   You  can  omit the 'AM'/'PM' designation, in which
  case, RESERVE assumes 'military time' (24-hour clock where  3:00  PM
  is  written  as  15:00).   If you are specifying a time period which
  occurs on the hour, such as 10:00 AM, you can omit the ':mm' portion
  and  enter the time simply as '10 AM', or '10'.  Time periods switch
  at the hour and half-hour times.  You can specify minutes other than
  ':00'  or  ':30'  but  RESERVE  rounds  to  the  nearest time period
  division.

  Both time period parameters are optional, unless you wish to specify
  a  terminal  id(s).   If  you do not specify a time period, the same
  time periods as shown on the current display  screen  will  be  used
  (current  time period plus 7).  If you specify a single time period,
  the information printed will be for that time period until  the  end
  of  the  day.   If  you  specify  both time periods, the information
  printed will be from time period 1 through time period 2.

termid

  Specifies the terminal id(s) which you wish printed.   Terminal  ids
  are  two-character  values.  The valid terminal ids are those listed
  at the top of the terminal display screen.

  Both terminal ids are optional.  If you do not specify terminal ids,
  information  for  all  terminals  will be printed.  If you specify a
  single terminal id, information for that terminal id  only  will  be
  printed.   If you specify two terminal ids, information for terminal
  id 1 through terminal id 2 will be printed.  If you wish to  specify
  terminal ids, you must specify at least one time period parameter.
!
!
!
3 Discussion
The  detailed  terminal reservation chart has the same basic format as
the terminal screen display.  It is expanded to include  the  computer
username of the user who has reserved a specific terminal.

A chart is always posted inside the terminal lab on the bulletin board 
to  the  left,  as  you  enter  the room.  You can check this chart to 
determine which terminal you have reserved at which time.   The  chart 
is  updated  at 10 minutes to each hour.  Generally, you will not wish 
to print your own chart.  Simply check the chart which is posted. 
!
!
!
3 Example 
To print a detailed terminal reservation chart for 3/16/83, you  would 
enter: 

     Command: List 3/16/83 
!
!=============================================================================!
! Key 2								      Reserve !
!=============================================================================!
!
2 RESERVE 
Enters a terminal reservation for a user. 

Syntax:

     Reserve [date] time[,time] termid[,termid] username 
!
!
!
3 Parameters 
date

  Specifies the date for which you wish to reserve a  terminal.   This
  is  optional.   If  you do not enter this parameter, today's date is
  assumed.  The date can be specified in any  of  several  ways.   The
  most  common is 'mm/dd/yy'.  You may also enter the date in the form
  'dd-mmm-yyyy'.   The  year  is  optional  in  both  forms.   If  not
  specified, the year defaults to the current year.

time

  Specifies  the  time  period  during  the  day  at which you wish to
  reserve a terminal.  This time is entered in  the  form  'hh:mm  xx'
  where  'xx'  is  either  'AM'  or  'PM'.  You can omit the 'AM'/'PM'
  designation, in which case, RESERVE assumes 'military time' (24-hour
  clock  where  3:00 PM is written as 15:00).  If you are specifying a
  time period which occurs on the hour, such as 10:00 AM, you can omit
  the  ':mm'  portion  and  enter the time simply as '10 AM', or '10'.
  Time periods switch at  the  hour  and  half-hour  times.   You  can
  specify  minutes other than ':00' or ':30' but RESERVE rounds to the
  nearest time period division.

  One time period parameter is required.  The  first  time  period  is
  always  associated  with  the first terminal id specified.  A second
  time period is optional.  If the second time period is specified, it
  applies  to  the second terminal id.  If a second terminal id is not
  specified, then the second time  period  will  apply  to  the  first
  terminal id also.

termid

  Specifies the terminal you wish to reserve.  This is a two-character
  value.  The valid terminal ids are those listed at the  top  of  the
  terminal display screen.

  One  terminal  id  is  required.   The  first  terminal id is always
  associated with the first time period specified.  A second  terminal
  id  is optional.  If the second terminal id is specified, it applies
  to the  second  time  period.   If  a  second  time  period  is  not
  specified,  then the second terminal id will apply to the first time
  period also.

username

  This is the computer logon name under which you  wish  to  make  the
  reservation.
!
!
!
3 Discussion 
Terminal  reservations  may NOT be made for dates prior to the current 
date, nor for time periods  within  the  current  date  prior  to  the 
current time period.  Also, terminal reservations may only be made for 
dates which fall within the current academic quarter. 

Before  a  reservation  is  actually entered, you will be prompted for
your password.  This must be entered correctly or the reservation will
not  be  performed.  You will have three attempts to enter the correct
password before the command is terminated.

The  number  of  time  periods  which  you  may  reserve  PER  DAY  is 
restricted.  This restriction may vary by course, however, the general 
number of time periods allowed is two.  This provides for a total of 1 
hour  of  terminal time reservable per course per day.  If you attempt 
to reserve more than the  number  allowed,  the  reservation  will  be 
denied. 
!
!
!
3 Example 
To  reserve  terminal  V3  on  12/15/82   at   2:00   PM,   under  the
logon 1711_JOHNSON, you would enter: 

     Command: RESERVE 12/15/82 2 PM V3 1711_JOHNSON 
              User password ? (you must enter your password to verify) 
                              (the reservation                       ) 
              Reservation confirmed. 

To reserve terminal V5, on 3/16/83, from 11:00 until  12  noon,  under 
the logon 1731_SMITH, you would enter: 

     Command: RESERVE 3/16/83 11 AM,11:30 AM V5 1731_SMITH 
              User password ? (you must enter your password to verify) 
                              (the reservation                       ) 
              Reservation confirmed. 
!
!=============================================================================!
! Key 2									 Show !
!=============================================================================!
!
2 SHOW 
Displays  the  current terminal reservations for a specific date, time 
period and/or terminal ids. 

Syntax:

     Show [date] [ time[,time] [ termid[,termid] ] ] 
!
!
!
3 Parameters 
date

  Specifies  the  date  for  which  terminal  reservations  are  to be
  displayed.  This is optional.  If you do not enter  this  parameter,
  today's  date  is  assumed.   The  date  can  be specified in any of
  several ways.  The most common is 'mm/dd/yy'.  You  may  also  enter
  the  date  in  the form 'dd-mmm-yyyy'.  The year is optional in both
  forms shown.  If not specified, the year  defaults  to  the  current
  year.

time

  Specifies  the  time  period  during the day which you wish to view.
  This time is entered in the form 'hh:mm xx'  where  'xx'  is  either
  'AM'  or  'PM'.   You  can  omit the 'AM'/'PM' designation, in which
  case, RESERVE assumes 'military time' (24-hour clock where  3:00  PM
  is  written  as  15:00).   If you are specifying a time period which
  occurs on the hour, such as 10:00 AM, you can omit the ':mm' portion
  and  enter the time simply as '10 AM', or '10'.  Time periods switch
  at the hour and half-hour times.  You can specify minutes other than
  ':00'  or  ':30'  but  RESERVE  rounds  to  the  nearest time period
  division.

  Both time period parameters are optional, unless you wish to specify
  a  terminal  id(s).   If  you do not specify a time period, the same
  time periods as shown on the current display  screen  will  be  used
  (current  time period plus 7).  If you specify a single time period,
  you will be shown the information for that time period only.  If you
  specify  both  time  periods, you will be shown the information from
  time period 1 through time period 2.

termid

  Specifies the terminal id(s) which you wish view.  Terminal ids  are
  two-character  values.   The  valid terminal ids are those listed at
  the top of the terminal display screen.

  Both terminal ids are optional.  If you do not specify terminal ids,
  information  for  all  terminals  will  be  shown.  If you specify a
  single terminal id, information for that terminal id  only  will  be
  shown.  If you specify two terminal ids, information for terminal id
  1 through terminal id 2 will be  shown.   If  you  wish  to  specify
  terminal ids, you must specify at least one time period parameter.
!
!
!
3 Discussion 
The  terminal  screen  display  is  updated  to contain your requested 
information.  If all the information you request fits on  one  screen, 
the  information  will  be  displayed  and  the  'Command' prompt will 
appear.  Reserve is then waiting for your next command.  The  terminal 
screen  display continues to show the information you requested rather 
than the information for the current date and time. 

If all the information you request requires more space than  available 
on  the  screen  (i.e.   more  than  8  time  periods),  RESERVE  will 
automatically 'page' the information.  Your requested information will 
be  divided  into  smaller  sections  which  will  fit on the terminal 
screen.  RESERVE will pause after it has displayed each  screen.   You 
should press the <RETURN> key when you wish to see the next section of 
information.  If you enter a <SPACE>, the current  SHOW  command  will 
terminate  without  completing.  The 'Command' prompt will appear when 
the SHOW command is finished and  the  terminal  screen  display  will 
continue to display the last section of information requested. 
!
!
!
3 Example 
To show the terminal reservations for 3/16/83, from 2:00 PM until 4:00 
PM, you would enter: 

     Command: Show 3/16/83 2 PM,4 PM 
