.appendix The VAX Datebook System
.IFNOT NBI
.RM72
.LM5
.ENDIF NBI

.sthl 4,0,9,9,9,
.HL 1 Introduction

The VAX DateBook System is accessed either through the VAX Professional
Workstation or directly by typing   DateBook.  The DateBook system is
now considered obsolete because DTC (Desk Top Calendar) performs the
same functions faster and in a more user friendly manner.

When you start up DateBook the following menu is displayed.
.lit

                  Personal Date/Meeting Book
                (Type ^Y to exit at any Point)

You may choose:
		Add     - Add a new date to remember
		DElete  - Delete all entries between two dates
		DIsplay - Display a selected list of dates
		Exit    - Exit from DateBook
		Help    - Help on using DateBook
		Month   - Display a Month-at-a-Glance
		Print   - Print date list on printer
		Remove  - Remove selected entries on a given date
		Set     - Set the default DateBook
Choice:

.end literal
.HL 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 menu.  The top line of the add display shows the
current DateBook the user is using.
.hl 3 Attendee

ATTENDEE may be used several ways.  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
.LIT
    	
    		J. Downward
    		P. Vavra
    		VAX Wrk Grp
    but
    		VAX Working Group	is too long.

.end literal
.HL 3 Date Format

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:
.lit

    	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

.end literal

Normally, the days must 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.
.hl 3 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:
.lit

                    00:01           One minute past midnight
                     9:30           Nine thirty in the morning
                    09:30            "     "     "  "    "
                    14:30           Two thirty in the afternoon

.end literal
.hl 3 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 or fewer characters long.
Valid topics are:
.lit

    	Discuss Vax maintance contract
    	DECUS, VAX to RSX Migration Paper

.end literal
If more than 40 characters are input, an error is reported.
.HL 2 Default Answers

The very first time a user uses DateBook, it prompts for
information it will need for all future use.  It gets the user's first
and last name and the default user name (attendee) for whom DateBook
entries are to be made.  This information is stored in DATEDFLT.COM.
If at any time you are unhappy with your default answers, enter DCL
mode, type DELETE DATEDFLT.COM;*, and reenter DateBook.  DateBook will
then prompt again for first and last name and the default datebook
entry name.
.hl 2 Default Datebook

By default, DateBook always uses the DateBook data file on the
user's directory.  When in any of the specialized modes (ADD, DELETE,
REMOVE, or DISPLAY) DateBook will display at the top of the screen the
DateBook file currently being accessed.  You can change the default file
with the SET command.  To access another's datebook, however, the other
user must first give you RWED privilege to their DateBook data file.
.hl 2 DELETE
    	
DELETE is used if you want to delete all entries in the DateBook
from one date up to and includeing a second date.
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.
.hl 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 Display command only outputs
to the user's terminal.  Use the Print command to output a hard copy.

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.
.hl 2 Print

The Print option is identical to the Display option with the
exception that a data file is written which is printed either on the
line printer or the letter quality printer.  The user is prompted
for where to send the output.  Only LP and LQ are allowed inputs.
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.
.hl 2  Month

The Month option allows the user to have displayed (VT100
terminals only) the number of appointments for each day within a
given month.  The display is in calendar format and appointments,
if present, are highlighted.
.hl 2 REMOVE

If you make a mistake and want to remove/delete a sepcific
entry on a given day, type REMove to menu 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).  The top line of the REMOVE page will display the current
DateBook file being accessed.
.hl 2 SET

The SET option is used to change the default DateBook data file
being used by DateBook.  When the SET option is issued, first the current
directory being accessed is displayed.  Next a new directory
string is prompted for.  No error checking is done to insure that a legal
directory string is entered.  If one wants to return to the directory
on which DateBook was first started up, type RETURN to the second prompt
instead of a new directory string.
.hl 2  Special Commands

DateBook has two special in-line commands for use in a user's
LOGIN.COM file or directly at the terminal command level.  The commands
are TODAY and CHECK.  The command
.lit


    			DATEBOOK TODAY

.end lit
will display all meetings/appointments/deadlines that will occur that day.
Nothing will be displayed if there are no datebook entries.
The command
.lit

    			DATEBOOK CHECK

.end literal
will just check to see if any DateBook entries for the current day exist,
and if they do, broadcast a message to the user that the DateBook has
entries for the present day.  Since only a check for entries is done,
DATEBOOK CHECK is much FASTER than DATEBOOK TODAY.  To use the CHECK
function in your LOGIN.COM file, either just add a line
.lit

    			$ DATEBOOK CHECK

.end lit
or execute the DateBook checking in parallel with logging on by
submitting DateBook to run in BATCH mode.  To do this, include the
command
.lit


     $ SUBMIT SYS$SYSVPWFILES:DATEBOOK/PARAM=CHECK/NOIDENT/NOLOG

.end literal
and DateBook will start checking your DateBook while you are logging on.
.hl 2   System Requirements

DateBook requires the following command procedures, executable
images and data files.
.lit

    SYS$SYSVPWFILES:PAGE.COM            Define with SETVPWSYM.COM
    SYS$SYSVPWFILES:TERM.COM               during SYSLOGIN.COM
    SYS$SYSVPWFILES:TESTFILE.COM         
    SYS$SYSROOT:[SYSEXE]DTR.EXE         DATATRIEVE
    SYS$SYSVPWFILESBROADCAST.EXE        Broadcast message to user
    SYS$SYSVPWFILES:DATEBOOK.DTT        Prototype data file
    SYS$DISK:[]DATEBOOK.DAT             User's DateBook
    SYS$SYSROOT:[SYSMSG]QUERY.DIC       DATATRIEVE dictionary

.end literal

When DateBook starts up, it looks for the existence of the file
DATEBOOK.DAT on the login directory.  If no such file is present, it
copies SYS$SYSVPWFILES:DATEBOOK.DTT to DATEBOOK.DAT on the
users directory.  If the template file can not be copied, a warning
message is displayed for 4 seconds.

If neither DATEBOOK.DAT nor DATEBOOK.DTT exist and the user is
privileged, the user has the opportunity to create the DATEBOOK.DTT
template data file and make the appropriate DATATRIEVE entries in
QUERY.DIC by issuing the CREATE command, which exists although it is
not in the menu.