;REMINDER Version 4.1
;
;COPYRIGHT (c) 1984
;By AT&T TECHNOLOGIES, INC.
;
;THIS SOFTWARE IS FURNISHED WITHOUT LICENSE AND MAY BE USED AND  COPIED
;ONLY WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE.
;
;THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
;AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY AT&T TECHNOLOGIES.
;
;AT&T TECHNOLOGIES ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY
;OF THIS SOFTWARE.
1 Reminder
Invokes the VAX/VMS Personal Reminder Utility to add, delete, reschedule or
display personal reminder messages.

Format:
        REMINDER {/ASK} {ME}

The Reminder Utility runs on any ANSI/DEC_CRT compatible terminal.
2 Operation
The Reminder Utility can be invoked in one of two  ways.   If  the  command
"REMINDER" is given without arguments, the Reminder Utility will prompt you
for the various options such as ADD, DELETE, RESCHEDULE or DISPLAY.  If you
use  the  "REMIND{/ASK}  ME" form of the command, Reminder will search your
personal reminder file for any current  reminder  messages  and  optionally
display those it finds.

To enable AUTOMATIC display of reminder messages during LOGIN, you need  to
put the following line in your LOGIN.COM file in your HOME directory:

        $ REMIND{/ASK} ME

This will cause the Reminder Utility to display (with  optional  prompting)
any  current reminder messages when you LOGIN on that day.  You may have up
to 365 different reminder messages  active  in  each  time  category,  i.e.
TODAY, TOMORROW or FUTURE.

If the optional "/ASK" qualifier is present, REMINDER will  ask  permission
before it displays your current reminder messages.  Without this qualifier,
all current messages are automatically displayed.

You may also choose whether a reminder message is displayed  only  ONCE  or
EVERY  TIME  you  LOGIN  (or use "REMIND ME") during that day.  The default
action is to display current reminders every time you LOGIN.

Current messages will be  displayed  on  your  terminal  in  the  following
format:

[Reminders for (current date)]
"text of your reminder messages"...

The "REMIND ME" command will work on any  type  of  terminal,  so  you  can
always check existing reminders even without an ANSI standard terminal.
2 Commands
Use the "REMINDER" command (without arguments) to enter the command mode.

Reminder has commands that allow you to Add, Delete, Reschedule and Display
reminder messages of your choice, based on a calendar date:

[ADD]

The ADD command is used to create NEW reminder messages.  Each  message  is
composed  of  up  to  67 characters of text and is keyed by a chronological
date, either present or future.

There are TWO forms of the ADD command:  "A"  to  enter  a  simple  message
without  any  repetition  options  or  "ADD"  which will prompt you for all
options:

The full "ADD" command will ask you whether you want the  reminder  message
displayed  more than ONE time on a given day.  The default is to display it
each time you LOGIN (or use "REMIND ME").  Reminder messages that are shown
only once are deleted after their first display.

There are TWO repetition  options  that  can  be  selected  when  ADDing  a
message.   These  allow you to see your reminder messages WEEKLY or MONTHLY
on the same day of the week.  You may select up to 52 weekly or 12  monthly
incremental  reminders.  Remember that you can ONLY select these options by
use of the full form of the ADD command (ADD rather than just "A").

[DISPLAYS]

The window at the top of the screen displays the current day of  the  week,
the  system date and time as well as the day of the year and remaining days
left  in  the  year.   This  information  is  updated  dynamically   during
execution.

There are several ways to DISPLAY your active reminder messages:

You can simply enter the date on the command line (see  DATE  formats)  and
REMINDER  will  search  for  and display any reminder messages you have for
that date.

If you enter just the MONTH (and  YEAR),  REMINDER  will  display  reminder
messages for that MONTH (and YEAR).

There are also THREE categorical message  commands  that  display  TODAY's,
TOMORROW's and FUTURE reminder messages, including message totals.

You can use the SEARCH command to look for reminder messages that contain a
specific  text  string.   This  is  useful  if  you  have a large number of
reminders and can not remember the specific date of a message but  you  can
remember a word or two of the text.

You can also see reminder messages along with the days and months on  which
they fall while using the CALENDAR display mode (see below).

You can also use REMINDER to tell you the actual day of  the  week  of  any
valid  date (within the limits of a lifetime).  When you enter a valid date
on the command line, REMINDER will always display the day of  the  week  of
that date, whether or not you have any scheduled reminder messages for that
day.

When reminder messages are displayed, those to be viewed only ONCE PER  DAY
are shown with an asterisk (*) to the right of the date field.

[DELETE]

The DELETE command is used to remove reminder messages  from  the  reminder
file before they appear (at which time they AUTOMATICALLY get deleted).

[RESCHEDULE]

The RESCHEDULE command is used to change  the  date  on  existing  reminder
messages,  which  effectively reschedules them to any other day you choose.
This is useful if you have current reminders that you couldn't act  on  and
want  to  postpone them to another day.  It can also be used to move future
reminders closer to the present.

[CALENDAR MODE]

The CALENDAR command allows you to display actual monthly calendars on  the
screen.  The calendar of the month you select is shown in the center of the
screen with the previous and following months at the top  of  the  display.
Days  on which you have scheduled reminders are shown in BOLD video and the
current date (if present) is shown in blinking REVERSE video.  If there are
reminders on the current date, its video becomes BOLD.

The ARROW keys on an ANSI standard terminal control  the  position  of  the
calendar  "window".   You may move the window in one of four ways:  EARLIER
MONTHS, LATER MONTHS, EARLIER YEARS and LATER YEARS.  The CALENDAR  display
will  also  "read  ahead"  if  you rapidly enter several ARROW commands and
allow you to skip forward or backwards  several  months  or  years  without
having to draw each intermediate calendar.

The LEFT arrow key moves the calendar display to EARLIER months;  the RIGHT
arrow  key  moves the calendar display to LATER months;  the DOWN arrow key
moves the calendar display to EARLIER years and the UP arrow key moves  the
calendar display to LATER years.

The PF1 key will trigger a single-line display of any reminder messages you
have  during  the  currently  CENTERED  month in the calendar window.  This
command has precedence over any ARROW (motion) keys that are struck.

The proper format for entering a starting calendar date is  show  below  in
the DATES section.

Each time that you  invoke  Reminder,  it  will  automatically  delete  OLD
reminder messages (any messages with dates earlier than the present).


Reminder messages are kept in SYS$LOGIN:REMINDERS.  This file is given  the
protection  (SY:RWD,OW:RWD,GR,WO)  to  provide  default  security  for your
messages.  If there are no current or future messages, the reminder file is
automatically deleted.


        Command         Function

        A(dd)           Allows ADDING a reminder message
        D               Allows DELETION of messages
        R               Allows RESCHEDULING of messages
        <RETURN>        Displays all CURRENT DAYS messages
        T               Displays all TOMORROW's messages
        F               Displays all FUTURE messages
                        (TOMORROW and BEYOND)
        DATE            Displays all reminder messages on that date
        C               Enter Calendar Display Mode
        S               Searches REMINDER file for given text string
        ?               Displays REMINDER command summary (this text)
        H               Displays FULL Help about REMINDER
        CTRL/Z          Aborts current REMINDER command
        W               Refreshes the screen display
        E               Causes REMINDER to Exit
2 Dates
There are nine DATE formats that REMINDER accepts when adding,
displaying, deleting or rescheduling messages:
(Exceptions are noted in parenthesis)


        <RETURN>        TODAY's date

        T               TOMORROW's date

        DAY             Day of the CURRENT Month and
                        Year (Ex: 23 would be 23rd of current month
                        and current year)

        MONTH DAY       Day and Month of the CURRENT
                        year (Ex: APRIL 23 would be 23rd of April in the
                        current year)

        MONTH DAY YEAR  Full date specification (Ex: March 23, 1984)

        MONTH           Month of the CURRENT Year (Ex: February)
                        (DISPLAY/DELETE/RESCHEDULE only)

        MONTH YEAR      Month and Year (Ex: Dec 1985)
                        (DISPLAY/DELETE/RESCHEDULE only)

        *               ALL messages
                        (DELETE command only)

        ?               ALL messages (prompting)
                        (DELETE/RESCHEDULE only)


There are also three DATE formats that REMINDER accepts when in the
CALENDAR Display mode:


        <RETURN>        CURRENT Month and Year

        MONTH           Month of the CURRENT Year (Ex: MAY)

        MONTH YEAR      Month and Year (Ex: November 1984)


REMINDER will accept date fields in ANY order (month day and year) and with
any  field  delimiters  except letters or numbers.  The only restriction is
that the MONTH field CANNOT be expressed numerically.  You  may  abbreviate
the  MONTH  field  to UNIQUENESS or spell it out entirely.  This means that
date formats like January 20, 1984 or 23-JAN-84 or 1984/Jan/23 or Ja 23  84
will work just fine.

You are not permitted to enter dates in the past (ADD or DELETE)  or  dates
beyond  the  calendar year of 2084 (since we probably won't be around to be
reminded of anything).
3 Fields
Reminder dates are composed of three fields, DAY, MONTH and YEAR.

The format of each field is shown in the following table:
(Examples shown for MONTH field represent the shortest form)

        Field           Width           Example
        -----           -----           -------

        DAY             1 or 2          9,09,31

        MONTH           1 to 9          JA,FE,MAR,AP,MAY,JUN
                                        JUL,AU,S,O,N,DEC

        YEAR            2 or 4          84,1984


Examples of acceptable reminder dates: (FULL date format)

September 20, 1985      20-Sep-85       1985 Sep 20     S/20/85
Sep 20 85               20-SEP-1985     85 20 S         Sep/1985 20

This list is by no means exhaustive, there are many possible combinations
and you already probably have one in mind.
