1 CALENDAR

 This program is a computerized calendar that can store messages
 to  remind the user of appointments and other dated events when
 the user logs in.  It is menu driven and stores information  in
 the non-ascii format file SYS$LOGIN:CALENDAR.DAT.

 Within calendar, the user may  specify  6  different  types  of
 messages.  These are:

   1) Non-repeating -- A one time message.
   2) Weekly -- A message that occurs once each week.
   3) Bi-weekly -- A message that occurs once every two
        weeks.
   4) Monthly -- A message that occurs on the same date of
        the every month.  (eg.  The 5th of every month).
   5) Monthly -- A message that occurs on the same day of
        the n-th week of the month, every month.  (eg.  The  4th
        Tuesday of each month.)
   6) Daily -- The "procrastinator's special".  A message
        that occurs every day 'till you delete it by  hand  from
        within Calendar.
2 Useage
 To use calendar, the following lines  should  be  put  in  your
 LOGIN.COM file.

      $ SETUP CALENDAR
      $ CALENDAR/LOGIN

 After adding those lines to your login.com file,  you  will  be
 able  to  call  the  calendar  program  by  using the following
 command:

      $ CALENDAR

 CALENDAR has been defined as a VMS verb for you and  will  work
 just  like any other VMS verb.  Also, every time you log in you
 will get a list of the messages that apply to the current day.
2 Authors
 This program was written by Rick Cabral of Hughes Aircraft.

 The following features were  added  by  Chris  Yoder  @  Hughes
 Aircraft,  SCG  / CTC:  Reverse vidio display of messages, bell
 on login, moving of messages from one date to another,  keeping
 of  messages  specified  by user, weekly repeating messages not
 displayed at option of user, and the "procrastinators  special"
 daily  repeating  messages.   Also  added  for  V3.0 was making
 Calendar use the CLI routines instead  of  depending  on  being
 defined  as  a  foreign  command.   Any problems, questions, or
 suggestions   about   these   features   or   general   program
 maintainence  are  appreciated  and  can  be  sent via email to
 CHRIS%ENGVAX.UUCP@USC-OBERON.USC.EDU  from   the   ARPAnet   or
 Internet world.
2 Adding_Entries
 In order to add entries to your Calendar  data  file  you  must
 enter the CALENDAR command WITHOUT any qualifiers.  Calendar is
 menu driven and there is internal help in the  program,  typing
 HELP  at  any time will give you information on your options at
 that time.
2 Qualifiers

      /ALL

 This  qualifier  will  list  all  messages  currently  in  your
 calendar data file.


      /BELL (Default)

      /NOBELL

 The bell flag causes the program to ring the terminal bell when
 there are messages for today.


      /DATE=dd[mmm[yyyy]]

 This qualifier lists all the messages for  the  specified  day.
 It  can also be used together with the /DAYS qualifier where it
 then would be  considered  as  the  starting  date.   The  date
 defaults  to  the  current month and year when the month is not
 specified, and the current year when the year is not specified.
 Some  examples of the format for specifying the date follow:  (
 ASSUME the current date to be June 1, 1984 )

      $ CALENDAR/DATE=12AUG1985       August 12, 1985
      $ CALENDAR/DATE=12              June 12, 1984
      $ CALENDAR/DATE=12SEP           September 12, 1984

      /DAYS=n

 This qualifier list all the messages for the next n days, where
 n  is  an  integer.   If used with the /DATE qualifier, it will
 list the  messages  for  the  period  starting  with  the  date
 indicated and and ending at the date + n days.


      /KEEP (Default)

      /NOKEEP

 The keep flag causes the program  to  keep  all  old  messages.
 Normally  old  messages are deleted and the user will never see
 them again, but some people like to have access to old messages
 (in case they never get around to doing things when they should
 have been done in the first place).


      /LOGIN

 This qualifier should be used in your LOGIN.COM (or LOGOUT.COM)
 only.   When  you  use this qualifier, the messages are checked
 and acted upon.  It will delete old  messages  that  have  been
 seen,  and  it  will issue old messages that were not seen yet,
 and then delete them.  In other words, this is the option  that
 tells the program to do some cleaning up of its data file.  The
 /DAYS qualifier can also be used  with  this  qualifier.   This
 would  instruct  the program to tell you about messages for the
 next n days, every time you log on to the system.   An  example
 of its use is the following change in your login.com:  Change

      $ CALENDAR/LOGIN
 to
      $ CALENDAR/LOGIN/DAYS=2

 This would issue messages for the the current day and the  next
 day, every time you log in.


      /REVERSE (Default)

      /NOREVERSE

 The reverse flag causes the program to display all messages  in
 reversed video.


      /WEEKLY (Default)

      /NOWEEKLY

 The weekly flag causes the program to display  weekly  messages
 when  using  the  /LOGIN  and  /DAYS qualifiers together.  This
 qualifier has no effect on displaying  messages  scheduled  for
 today, but is designed to allow the user to not display regular
 weekly messages until the day that they have to be done.
2 /ALL

      /ALL

 This  qualifier  will  list  all  messages  currently  in  your
 calendar data file.
2 /BELL

      /BELL (Default)

      /NOBELL

 The bell flag causes the program to ring the terminal bell when
 there are messages for today.
2 /DATE

      /DATE=dd[mmm[yyyy]]

 This qualifier lists all the messages for  the  specified  day.
 It  can also be used together with the /DAYS qualifier where it
 then would be  considered  as  the  starting  date.   The  date
 defaults  to  the  current month and year when the month is not
 specified, and the current year when the year is not specified.
 Some  examples of the format for specifying the date follow:  (
 ASSUME the current date to be June 1, 1984 )

      $ CALENDAR/DATE=12AUG1985       August 12, 1985
      $ CALENDAR/DATE=12              June 12, 1984
      $ CALENDAR/DATE=12SEP           September 12, 1984
2 /DAYS

      /DAYS=n

 This qualifier list all the messages for the next n days, where
 n  is  an  integer.   If used with the /DATE qualifier, it will
 list the  messages  for  the  period  starting  with  the  date
 indicated and and ending at the date + n days.
2 /KEEP

      /KEEP (Default)

      /NOKEEP

 The keep flag causes the program  to  keep  all  old  messages.
 Normally  old  messages are deleted and the user will never see
 them again, but some people like to have access to old messages
 (in case they never get around to doing things when they should
 have been done in the first place).
2 /LOGIN

      /LOGIN

 This qualifier should be used in your LOGIN.COM (or LOGOUT.COM)
 only.   When  you  use this qualifier, the messages are checked
 and acted upon.  It will delete old  messages  that  have  been
 seen,  and  it  will issue old messages that were not seen yet,
 and then delete them.  In other words, this is the option  that
 tells the program to do some cleaning up of its data file.  The
 /DAYS qualifier can also be used  with  this  qualifier.   This
 would  instruct  the program to tell you about messages for the
 next n days, every time you log on to the system.   An  example
 of its use is the following change in your login.com:  Change

      $ CALENDAR/LOGIN
 to
      $ CALENDAR/LOGIN/DAYS=2

 This would issue messages for the the current day and the  next
 day, every time you log in.
2 /REVERSE

      /REVERSE (Default)

      /NOREVERSE

 The reverse flag causes the program to display all messages  in
 reversed video.
2 /WEEKLY

      /WEEKLY (Default)

      /NOWEEKLY

 The weekly flag causes the program to display  weekly  messages
 when  using  the  /LOGIN  and  /DAYS qualifiers together.  This
 qualifier has no effect on displaying  messages  scheduled  for
 today, but is designed to allow the user to not display regular
 weekly messages until the day that they have to be done.
