1	DATEBOOK

	DATEBOOK is a VAS/VMS command procedure which allows a user to
create and maintain a dated list of appointments, meetings, and deadlines.
Each entry in the users 'datebook' contains the following items

DATE            The date of the meeting/appointment/deadline
TIME            The time (00:00 to 23:59) of the meeting/.../deadline
ATTENDEE        A 14 character string labeling the user for whom the 
                meeting is, or anything else the user wants to lable
                entries with.
TOPIC           A 40 character string of anything the user wants to
                use describe the meeting.

	The user using datebook has the following options:  ADD, DELETE,
DISPLAY, HELP, REMOVE, and EXIT each of which is discussed as a seperate
HELP topic.  If the user defines the symbol

	DATEBOOK:==@SYS$VPWFILES:DATEBOOK

in their login command file, the command  

			DATEBOOK TODAY 

will display all meetings/appointments/deadlines that will occur that day.
2	DATE

	The date format is DD-MMM-YYYY.  The years must be entered
as four digits, ie 1982 not 82.  The months are entered as, JAN...DEC.
The "-" in the date is required syntax.  Examples of date entries are:

	VALID		INVALID

	 1-JAN-1982	1/JAN/1982
	01-JAN-1982	1-JAN-82
	25-FEB-1982	2/25/82
	30-NOV-1982	30-NEV-1982

Normally, the days must correctly lie between 0...31, but if you specify
too large a day on a certain month (ie 29 days in February) it will be
flagged with an error.  At this time, the last day in February in LEAP
year will not work.

2	TIME

	Time is kept using a 24 hour clock.  The day starts at 00:00
and runs through 23:59.  Morning hours are < 12:00.  The format for the
entry is  HH:MM.  The ":" is required syntax.  Valid time intries
include:
                00:01           One minute past midnight
                 9:30           Nine thirty in the morning
                09:30            "     "     "  "    "
                14:30           Two thirty in the afternoon
2	ATTENDEE

	ATTENDEE may be used several way.  If a secretary is using
the datebook to keep track of appointments for a number of users,
this datebook entry field is used to specify which user the entry
is for.  If a given user is using DATEBOOK for him or herself alone,
this entry can be used to specify the meeting attendees, or any
other convenient item of interest.  When DATEBOOK prompts for
ATTENDEE, you may enter up to a 14 character string to enter in this
field.  If you are unsure what a 14 character string is, STRING,
is an item you can request HELP on.  Valid ATTENDEE entries might be
	
		J. Downward
		P. Vavra
		VAX Wrk Grp
but
		VAX Working Group	is too long.
2	TOPIC

	Each meeting/appointment/deadline can have a TOPIC.  For a 
meeting the TOPIC entry might be the topic to be discussed.  It also
might include the people asked to attend.  For a formal meeting
it might specify the meeting name and paper to be presented.  Anything
may be entered for topic, as long as it is 40 characters or less long.
Valid topics are:

	Discuss Vax maintance contract
	DECUS, VAX to RSX Migration Paper

If more than 40 characters are input, and error is reported.

2	STRING

	A character string is a given number characters as typed from
the terminal keyboard.  If you type "ABCD" at the terminal and it is
entered as a string, the string is 4 characters long.  Both upper
and lower case are allowed as string entries.  Both TOPIC and ATTENDEE
are string entries.  The data file will not hold more than the maximum
number of characters specified for a string entry.  ie a 40 character
string for TOPIC means that input will be excepted for the TOPIC
prompt for up to 40 characters. However, if more than 40 characters
are typed in, and error will result and the data will not be stored in
the file.
2	ADD

	When you enter ADD mode, DATEBOOK starts prompting you for
input.  It asks you for DATE, TIME, ATTENDEE, and TOPIC.  After you
have entered all items, it displays what you have entered and asks you
if it is OK.  If no mistakes were made, type Y or YES.  If you type
N, NO, or just hit carriage return (<CR>, RETurn), the entry will not
be made in the datebook.  During the prompting for DATE and TIME
a carriage return (<CR>, RETurn) entered at the prompt will return the
user to the main menue.
2	DISPLAY

	The user can display, DATEBOOK entries for a single specific
day, the current day, or all days.  When the user types DISPLAY,
DATEBOOK prompts for the date to display.  If the user hits the
carriage return (<CR>, RETurn), any DATEBOOK entries for the current
day are displayed.  If the user types, ALL, all entries in the file
are displayed.  If the user enters a specific day (DD-MMM-YYYY), just
the entries for that day are displayed.

	The user is given the option of displaying the date entries on
his/her terminal, or printing the list to the line printer or letter
quality printer.  When prompted for the output device, hitting the
return key (<CR>, RETurn) will direct the display to the user's terminal,
typing LP will send output to the line printer, and typing LQ will
send the output to the letter quality printer.

	Whether or not any entries occur in the file for a given day,
a header will be displayed.  If no entries occur, no entries will
follow the header.
2	REMOVE

	If you make a mistake and want to remove/delete a sepcific
entry on a given day, type REMove to menue prompt.  DATEBOOK will then
prompt you for what day to search for.  Enter it as DD-MMM-YYYY.  DATEBOOK
will then read all the entries.  Each entry for that date will be displayed
and DATEBOOK will ask you if you wish to remove that entry.  If you type
Y or YES the entry will be deleted.  Any other response and the entry
will be saved and DATEBOOK will check to see if more entries on that date
exist.  When it is done processing a given day, it will return to the 
prompt mode and request another date to be entered.  If you do not want
to remove any other datebook entries hit the terminal's return key (<CR>,
RETurn).
2	DELETE
	
	DELETE is used if you want to delete all entries in the datebook
on a given day upto and including the date entries on a second day.
If you hit the terminal key RETURN (<CR>, RETurn, type RETurn), DATEBOOK
will return to the main menu. DATEBOOK will ask for the starting date on
which to delete entries. If you enter a valid date (DD-MMM-YYYY) for the
first day, DATEBOOK will ask you for the ending date to delete. If the
second date entry is valid, DATEBOOK will print a message showing the
range of dates which will be deleted. It will then ask if it should
proceed to delete the entries. If any answer but Y or YES is given,
DATEBOOK will return to the delete menu without deleting any entries. If
a Y or a YES is entered, DATEBOOK will delete all those entries and then
return to the delete menu to see if you have more to delete.
