calendar(1)           MPE/iX Shell and Utilities           calendar(1)
  ______________________________________________________________________

  NAME
       calendar -- appointment reminder system

  SYNOPSIS
       calendar [-]

  DESCRIPTION

       Note: The MPE/iX implementation of this utility does not function
       exactly as this man page describes.  For details, see the MPE/iX
       NOTES section at the end of this man page.

       With no options, calendar displays all current appointments on
       the standard output.  calendar searches the file calendar in the
       current directory, looking for lines that match either today's or
       tomorrow's date.  On Friday, Saturday, or Sunday, tomorrow
       extends through to Monday.  Each appointment must fit on a single
       line, with the date formatted as one of:

          January 27
          1/27
          jan 27

       Note: The month name may be abbreviated to three letters; the
       case is not significant; the month can be given numerically.

       calendar accepts the following option:

       -    searches for a calendar file in each home directory found in
            the user database.  calendar sends mail to the corresponding
            user for any appointments that are found to be current.
            Mail is sent using the mailx utility or alternatively the
            utility named in the MAILER environment variable.

  EXAMPLE
       If today is Friday April 7th, and the following calendar file is
       found in the current directory:

          tue mar 7 1:00 pm   dentist
          Sat April 8    Trip to the zoo
          mon april 10   3:30 pm job interview
          4/11      vacation starts

       calendar prints the following:

          Sat April 8    Trip to the zoo
          mon april 10   3:30 pm job interview

  ENVIRONMENT VARIABLES

                                                                       1

  calendar(1)           MPE/iX Shell and Utilities           calendar(1)
  ______________________________________________________________________

       MAILER
            contains the name of the utility that calendar uses to send
            mail.  If this variable is not set, calendar uses mailx as
            the default mail utility.

  FILES

       calendar
            file used in the current directory, or user's home direc-
            tory.

  DIAGNOSTICS
       Possible exit status values are:

       0  Successful completion.

       1  An error occurred.

  Messages

       Message:  calendar file: system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

       Message:  insufficient memory available
       Cause:    There were not enough free system resources for the
                 operation being performed.
       Action:   Free up more system resources.

       Message:  internal RE error: regular expression error
       Cause:    See regerror(3).
       Action:   See regerror(3).

  PORTABILITY
       All UNIX systems.  x/OPEN Portability Guide 4.0.

       The MAILER environment variable is an extension to traditional
       implementations of calendar.

  SEE ALSO
       mailx(1)

  MPE/iX NOTES
       The current MPE/iX implementation of calendar does not allow the
       use of the - option.  MPE/iX has no way of interactively obtain-
       ing a list of the home directories (home groups) of all users on
       the system.  To determine a user's home group, use the MPE/iX CI
       command LISTUSER

       For more information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

                                                                       2