1	DTC
     The DTC program provides an on-line, appointment scheduler and calendar
facility.  The  program currently supports four basic functions:  

   Day-At-a-Glance, Month-At-A-Glance, Week-At-A-Glance, and Day-At-A-Glance.  

The program may be invoked by:

		$DTC			! and used interactively
		$DTC [[option] [date]]  ! Send commands to DTC directly

     Numrous options (including D for Day, W for Week, and M for Month) exist. 
If no option is given, the a menu is displayed.  Options  are then solicited 
after each display, until the user types EX (exit).

     The date  format  is  mm/dd/yy  for  Day and Week command, and mm/yy 
for the month command.  For example, the  command D 1/03/84 displays
appointments for January third, 1984. Then entering  9:00 <appointment
string> would insert the appointment specified by  appointment  string
in at 9:00 am on the default date.  The default date is the last date
given unless the I command is used to reset to the current date. A normal 
command to enter an appointment from DCL might be: 

		$DTC D 010183 9:00 Fred Taylor interview 

!     DTC commands T, C, and R correspond to D, M, and W but exit after the
!one display. Time ranges of form hh:mm>hh:mm give intervals.
2	Day_at_a_Glance

	The format for the Day command is

		D  [mm/dd/yy] [HH:MM[>hh2:mm2] Text...Text...]

The date string can be in any of the three allowed formats.  If it is
not present the date defaults to the current day.  The appointment string
is optional and if present is entered as the appointment for that day
and time.  If not present, the current day's appointments are displayed,
and DTC waits for a command to be input.

The format of an appointment string is either

	HH:MM Text.....Text            (60 characters worth of text)

to make an entry for time HH:MM, or

	HH:MM>hh2:mm2 Text.....Text    (60 characters worth of text)

to reserve a block of time from HH:MM to hh2:mm2, or the text string may
be omitted entirely.  In this latter case, DTC positions the terminal
cursor to the proper appointment time and allows the user to input the
appointment message at the proper position.  If a carriage return is entered
at this point, any previous appointment string at that time is deleted.
If a Control-Z is entered, no changes are made and DTC returns to the
main menu.

When an appointment string is entered, the day's appointments will be
updated, and DTC will again wait for another command.  If RETURN is entered,
DTC will return to the main menu.
2	Week_at_a_Glance

	The format for the Week command is

		W [mm/dd/yy] 

The date string can be in any of the three allowed formats.  If it is
not present the date defaults to the current day.  The week containing
the specified day will be displayed.  For normal (not inverse display),
the time for each date for which an appointment exists will be displayed.
After the weeks appointments are displayed, DTC will wait for a RETURN
(return to main menu) or command string to be entered.
2	Month_at_a_Glance

	The format for the Month command is 

		W [mm/yy] 

If no date string is given, the display will default to the current month
and year.  Three month calender displays are presented, the previous month,
the selected month, and the next month.  If the current date corresponds 
to any day in the month display, that day is highlighted.  Any date in the
selected month which has calender entries, will be flagged with a highlighted
asterix ('*').  When DTC finishes displaying the month, it waits for
input (with the calender dispalyed).  Enter a RETURN, to return to the
the main menu, or a valid DTC command to perform some other function.
2	Year_at_a_Glance

	The format for the Year command is 

				Y [yy]

If no year is given, the display will default to the current display.
The current date in the year display will be displayed highlighted on 
VT100 compatible terminals.

2	Date_Format

     Dates may be given as mmddyy, mm/dd/yy, or dd-mmm-yy.   For example,
June 6, 1984 could be represented by:
				
				6/6/84
				060684
				6-Jun-84

If the forms without either '/' or '-' is used, then each component number
of mm, dd, and yy must be a two digit number.  Leading zeros must be inserted
if necessary into the date string.  It is also possible to change the 
default date incrementally from its current value by 'nn' units.  The 
syntax of this command is

	+ or - nnU       where     nn = interval
				   U  = D  for Day
				      = Y  for Week
				      = M  for Month
				      = Y  for Year


2	HELP

Help may be obtained by pressing the PF2 key (the HELP key on VT2xx terminals).
The default Help information displayed depends on the previous command you
asked DTC to perform.  For example, if you just used the DAY command, DTC
will display HELP on the DAY command by default.  The first time the PF2
key is pressed, the current default help information is displayed.  The
second time, the key is pressed, DTC prompts for a topic, and you can
request any DTC Help which is available.
2	Scheduling_Appointments
!Entries
!in the  DTC  file of form "999999080[g,u]filename.typ=" point at the
!filename and the S or G cmds enter appts. in them, other cmds read them.
!Use the F cmd to change files. 
DTC has latent ability to schedule appointments between a variety of users,
however, this feature is not yet complete and implemented on the VAX.

2	PRINT

The Print command is used to print the appointments for a given date or a
range of dates either on the line printer, the letter quality printer, a 
scratch file or the user's terminal.  By default output goes to the fast
line printer (SYS$PRINT).

The format of the command is

	PR[int] [MM/DD/YY[>mm/dd/yy]] [Output]

where   Output	may be one of   
				LQ       - Letter Quality Printer
				PRINTER  - Current printer (SYS$PRINT)
				SCRATCH  - SCRATCH.FIL
				TERM     - User's Terminal
				TT:      - User's Terminal

The dates if present may be in any of the three allowed formats.  If no date
is specified, the current default date is used.  If only one date is specified,
only entries for that date will be printed.  If two dates are specified, all
entries from the first date specified to the last date specified will be
printed.
2	PURGE

The Purge command is used to remove old appointments from the calendar
so that they do not clutter the calendar needlessly.  The DTC calendar
is not purged automatically, rather it is only purged of old appointments
when the Purge command is used.  Note that the first two letters, PU,
of the Purge command are required to distinguish this command from the
Print command.  The format of the Purge command is

		PU[rge]  [mm/dd/yy]

If the optional date is not speciified, all appointments prior to the 
current date are removed from the current calendar file.  If the optional
date is specified, all appointments prior to that date are purged from
the calendar file.  The process of purging files, involves creating
a new appointment file, copying just the records to be retained to it,
and finally deleting the old appointment file.  In the event of an error
(out of disk quota or some such), DTC attempts to retain the original file.
2	Sorting

DTC tries to keep appointments in its calendar file in chronological order.
Since appointments can be made in any order for any date and time, it is
necessary for DTC to sort the appointments into chronological order after
new appointments are added.  When this occurs, a message is displayed that
the appointment file is being sorted.
2	Commands


	[1mD[0m [mm/dd/yy]   -   Appointment Schedule for dd/mm/yy
	[1mEV[0m [Text]      -   Add/change Evening Appointment
	[1mW[0m [mm/dd/yy]   -   Week-At-A-Glance for week of dd mm yy
	[1mM[0m [mm/yy]      -   Month-At-A-Glance for mm yy
	[1mY[0m [yy]         -   Year at a Glance
	[1mPR[0m [mm/dd/yy..]-   Print appointment list for date or range of dates
	[1mPU[0m [mm/dd/yy]  -   Purge appointments prior to mm/dd/yy
!	N(chars)       -   Reverse display sense of M or W cmd
!	F filename     -   Change default data file to Filename
!	S [mm/dd/yy]   -   Schedule multiple activity on mm/dd/yy
!	                   (Notifies users in pointer file also)
!	G [mm/dd/yy]   -   File activities in multiple files
!	L [mm/dd/yy] n -   Locate time (n * 30 mins.) free for mtg
	[1mI[0m              -   Reset default date to today.
	[7mPF2[0m            -   Display Help information
	[7mPF4[0m            -   VPW Command Screen
	[1mEX[0m             -   Exit

In addition a number of other special purpose commands exist.
2 CHECK

The CHECK command is designed to be used in DCL command mode.  If the command
DTC CHECK is given (for example, it is in the user's LOGIN.COM file), DTC
will check to see if any appointments are scheduled for that day.  If they
are, DTC will issue a message saying how many appointments exist for that
day.

2 QCHECK

QCHECK requests DTC to perform a quiet check for the number of appointments
the user has that day.  DTC prints no messages but sets the DCL symbol
DTC_APMT to be the number of half hour appointments scheduled for that day.
2 Initialize

The I[nitialize] command is used to reset the default date back to today.
2 Today

The T[oday] command is designed for use as a DCL command.  If the command
DTC TODAY is given (and DTC is a foreign command), the appointment list
for the current day is displayed, and DTC exits back to DCL without
disturbing the display.
2 Calendar

The C[alendar] command is designed for use as a DCL command.  If the command
DTC Calendar is given (and DTC is a foreign command), the calendar for the
current year is displayed, and DTC exits back to DCL without disturbing the 
display.
2 Locate

The L[ocate] command is used to locate a block of half hour periods during
the week including the optional date which can be used in scheduling a meeting.
The format of the command is

		L [mm/dd/yy] n

where n is the number of contiguous half hour time slots to look for and
the optional date selects the week interval to search in.  When the command
is issued, a standard week display will appear.  However, each time printed
on the screen does not represent an appointment.  Rather, the times represent
starting times available for scheduling a meeting of the required length.
Note that no evening times will be scheduled (17:00 or later).
2 Evening

An evening appointment is any appointment outside of normal working hours
(8:00 am to 5:00 pm inclusive).  All evening appointments are assigned
a time of 17:00 (5:00 pm) for display purposes.  The EV command can be
used to enter an appointment.  When EV is typed, the calendar for the
current day is displayed and the cursor moves to the Evening entry location.
