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 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 D [mm/dd/yy] - Appointment Schedule for dd/mm/yy EV [Text] - Add/change Evening Appointment W [mm/dd/yy] - Week-At-A-Glance for week of dd mm yy M [mm/yy] - Month-At-A-Glance for mm yy Y [yy] - Year at a Glance PR [mm/dd/yy..]- Print appointment list for date or range of dates PU [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 I - Reset default date to today. PF2 - Display Help information PF4 - VPW Command Screen EX - 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.