home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 500 / 445 / dtc.dqc / DTC.DOC
Text File  |  1984-10-25  |  7KB  |  189 lines
  1.             DTC  -  The Desk Top Calendar
  2.  
  3.                        Mitch  Wyle
  4.                   Glenn Everhart
  5.  
  6.  
  7.     The  idea here  is to automate an appointment calendar.  Most
  8.     appointment  calendars  give  only  one of Month-At-A-Glance, 
  9.     Week-At-A-Glance, or  Day-At-A-Glance.   DTC is an attempt to 
  10.     give all of these functions in a paperless, fast, menu-driven 
  11.     format.
  12.  
  13.     DTC initially displays a command menu. The commands accept date
  14.     arguments in any of 3 formats. The format labelled mmddyy would
  15.     translate 031584 as March 15, 1984. In this format, notice the
  16.     leading zeroes are required; otherwise the program cannot know
  17.     where fields end.
  18.     A second format is mm/dd/yy, in which one might write the date
  19.     as 3/15/84. In this case, leading zeroes are optional. Both digits
  20.     of year are however required.
  21.     The third format is dd-mmm-yy, in which
  22.     3 letter month abbreviations are used. In this format, the date
  23.     would be given as 15-MAR-84, which is easier yet. The date formats
  24.     may be mixed and matched.
  25.         If you want to see this week's appointment times, type
  26.     the command
  27.  
  28.     W<cr>
  29.  
  30.     and the times currently filled in will be shown. Evening appointments
  31.     are all flagged as happening at 17:00 (5PM for those not used to 24
  32.     hour time).
  33.     To see the month's days having appointments, the command
  34.  
  35.     M<cr>
  36.  
  37.     can be given. This will display a calendar of the current month (with
  38.     the last and next months drawn small at the page top) with asterisks
  39.     by any dates on which there are appointments and a pound sign (#) by
  40.     the current default date.
  41.  
  42.     To enter appointments on a given date and time, the command is
  43.  
  44.     D mm/dd/yy hh:mm appointment text
  45.  
  46.         where the D is a literal D (may be lower case too),
  47.         the date is given in one of the legal formats and is
  48.             the date of the appointment,
  49.         hh:mm is the time of the appointment, from 08:00 to
  50.             17:00 (leading zeroes in hours are needed),
  51.             and the part after the colon may be either
  52.             00 or 30. Thus, an appointment of 09:30 is
  53.             legal, but one of 09:45 is NOT (appointments
  54.             must be on half hour boundaries), and one of
  55.             9:30 is NOT (the hours must have leading zeroes).
  56.             Afternoon appointments may be entered in either 12
  57.             or 24 hour notation; they will be translated. If the
  58.             string EV is used instead of an hour, an evening
  59.             appointment is scheduled.
  60.         appointment text is any text describing the appointment. Only
  61.             60 characters are available owing to screen size limits.
  62.  
  63.     For appointments longer than 30 minutes, one may use the time range
  64.     notation hh:mm>hh:mm, where the second time is after the first.
  65.     Thus a meeting running from 9:30AM to 11:00 AM could be entered as
  66.     having a time of 09:30>11:00, followed by the text. The entry is placed
  67.     in each slot automatically then.
  68.  
  69.  
  70.         We will now go over the functions provided by DTC.
  71.  
  72.     Command        Format        Function
  73.  
  74.     Day        D mmddyy    Display appointments for the given date.
  75.  
  76.     Week        W mmddyy    Display appointment times for the week
  77.                     containing the given date, from Sunday
  78.                     through Saturday.
  79.  
  80.     Month        M mmyy        Draw a calendar of the month given
  81.                     (form mm/yy permitted too), showing days
  82.                     with appointments scheduled.
  83.  
  84.     Enter appts    D mmddyy HH:MM text    Enter appointment "text" on the
  85.                     given date and time (time may be a range
  86.                     h1:m1>h2:m2, e.g., 12:30>16:00 for
  87.                     longer meetings).
  88.         NOTE:
  89.         If the default date is already set to the desired date, the
  90.         appointments may be entered in the abbreviated form:
  91.         HH:MM text    or
  92.         EV text
  93.         for appointments at the given time, or evening appointments.
  94.         Time ranges may be used here too.
  95.  
  96.     Quit DTC    Q        Exits from DTC
  97.     Exit DTC    EX        Exits DTC
  98.  
  99.     Purge        P mmddyy    Erases old appointments prior to mmddyy,
  100.                     permitting cleanup of calendar file.
  101.  
  102.     Negate        NW mmddyy    Show free times available this week
  103.             NM mmyy        Show days with nothing scheduled this
  104.                     month (both use default date if none
  105.                     supplied).
  106.     File        F filename    Set DTC to use filename as its' data
  107.                     file containing appointments. Since
  108.                     an appointment file may contain pointers
  109.                     to multiple other files, this permits
  110.                     DTC to access files of appointments for
  111.                     different people or groups.
  112.     Schedule    S mmddyy hh:mm text    Schedule meeting at given time
  113.                     with text. This command assumes that
  114.                     the current appointment file has
  115.                     pointers to a group's files of appoint-
  116.                     ments, and that it is desired to add
  117.                     the text for an appointment at the
  118.                     given hour to each, without using a
  119.                     series of F and D commands to drop the
  120.                     notices in each serially. DTC will put
  121.                     the notice in each indirected file, but
  122.                     NOT in the current top-level file of
  123.                     appointments.
  124.  
  125.     Locate        L mmddyy nn    Locates time for meetings. This command
  126.                     will find times, in the week containing
  127.                     the date mmddyy, when a meeting of nn
  128.                     half hour intervals may begin. The
  129.                     range of nn must lie between 01 and
  130.                     18. The times shown are times in which
  131.                     no activities are scheduled in the top
  132.                     level data file or in any files to which
  133.                     it points.
  134.  
  135.     Reset default date  +nnU    Move default date forward or backward
  136.                 -nnU    by nn Units. U may be D, W, M, or Y for
  137.                     Day, Week, Month or Year. + moves
  138.                     forward, - back. If the numeric nn is
  139.                     omitted, 1 is assumed, and the unit is
  140.                     assumed to be the last display used.
  141.                     Thus, just typing "+<cr>" after display
  142.                     of a week moves forward by one week.
  143.                     The nn field may be zero, one, or two
  144.                     digits and is in decimal. For example,
  145.                     the command 
  146.  
  147.                     +3D
  148.                     moves default date forward 3 days.
  149.                     These commands do not redraw any
  150.                     displays, so a new D, W, or M display
  151.                     is needed next to see the new date's
  152.                     appointment information.
  153.  
  154.     Output    O             Outputs current calendar onto a file
  155.                     DTC.OUT suitable for printing. Some
  156.                     calendar printouts for the current date
  157.                     precede the appointment list. Note this
  158.                     function is rather crude but useful.
  159.  
  160.     Help    H            Prints a short help message on the
  161.                     screen (from file DTC.HLP).
  162.  
  163. POINTERS in CALENDAR FILES
  164.     The calendar file format is sequential records of the format:
  165.  
  166. YYMMDDTTTappointment text of 60 characters length
  167.  
  168. in which every record has this form, and the time TTT is in the range
  169. (for correct files) of
  170. 080 through 170 (for 08:00 through 17:00). The third digit is always
  171. either 3 or 0 as well, since DTC only schedules half hour periods.
  172.     Indirection is accomplished by editing your calendar file
  173. (with any editor) or just entering an "appointment" for year 99 (by which
  174. time somebody should have hacked some more on this to fix it up not
  175. to mess up real appointments). The text of the "appointment" should
  176. be just filespec=, with the = sign as the terminator of the file spec.
  177. This will lead to the file you specified being opened and treated as
  178. if it existed inside your own calendar file (except you need to use
  179. the S function rather than the D function to enter appointments in
  180. it as well as your own.)
  181.  
  182.  
  183.     To use DTC, you need to create an empty DTC.DAT file
  184. first (and also any other calendar files you expect to need.)
  185. Any method will do, including using an editor to set it up. Just
  186. make up an empty file initially, possibly just copying from con:
  187. with a single return.
  188.  
  189.