NAME

cm_lookup − look up appointments from Calendar Manager database

SYNOPSIS

cm_lookup [ -c calendar ] [ -d date ] [ -v view ]

DESCRIPTION

The cm_lookup utility is a tty interface to Calendar Manager (cm).  It can be used to look up appointments from the cm database via the RPC daemon rpc.cmsd.  Each of  the components of an appointment is specified using one of the command line flags followed by the desired value.  The current list of appointments for the specified date (see date, view options) is displayed. 

OPTIONS

−c calendar
The name of the target calendar.  Calendar names take the form "user@host", where the user is a user’s login name and the host is the host machine name. An example is "felix@cat".  If no target calendar is specified, calendar defaults to the current user at the current host machine.

−d date The date for the appointment.  The date is specifed using the form "mm/dd/yy", although certain other references such as "today", "Tuesday", "tomorrow", etc. are correctly calculated.  If no date is specified, date defaults to today’s date. 

−v view View span.  This controls the span of time to display.  The user may specify "day", "week", or "month".  The "day" view displays all appointments for the given date (see -d option above).  The "week" view displays the full week which contains the given date, starting with Sunday.  The "month" view displays the entire month which contains the given date, starting with the first of the month. The default view is "day". 
 

USAGE

The various components of an appointment are specified using command line flags followed by the desired value.  Values may have imbedded spaces, punctuation, etc., although quotes may be needed around strings which contain certain characters to protect them from interpretation by the local shell (e.g. /bin/csh).  An argument is taken to begin at the first space after a flag and to continue until the first "-" after a space. 

EXAMPLE

The simplest form of cm_lookup has no arguments:

example% cm_lookup
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 10:30 Morning Tea
        3) 2:00 Staff meeting
        4) 4:30 Phone home
 example%

To look up a specific date:

example% cm_lookup -d 09/26/90
Appointments for Wednesday September 26, 1990:
        1) 11:00 Appointment
        2) 11:30 Group Lunch
        3) 4:00 Tech Interview
 example%

To look up a specific target calendar:

example% cm_lookup -c felix@cat
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 10:15 Coffee
        3) 11:15 Doughnuts
        4) 2:00 Coffee
        5) 3:30 Snack
        6) 4:30 Coffee
 example%

To look up an entire week’s appointments:

example% cm_lookup -v week
Appointments for Sunday September 23, 1990:
        1) 6:00 Fishing
 Appointments for Monday September 24, 1990:
        1) 11:00 Sync with East Coast
        2) 4:00 Confirm flight
 Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 10:15 Coffee
        3) 11:15 Doughnuts
        4) 2:00 Coffee
        5) 3:30 Snack
        6) 4:30 Coffee
 Appointments for Wednesday September 26, 1990:
        1) 11:00 Appointment
        2) 11:30 Group Lunch
        3) 4:00 Tech Interview
 Appointments for Friday September 28, 1990:
        1) Documentation
        2) 10:00 Staff meeting
 Appointments for Saturday September 29, 1990:
        1) 9:00 Raquetball with Hal
 example%

Notice that "Thursday" does not appear, since there were no appointments on that day. 
 

FILES

/usr/spool/calendar/callog.username

/usr/etc/rpc.cmsd or $OPENWINHOME/rpc.cmsd

SEE ALSO

rpc.cmsd(1), cm_insert(1), cm_delete(1) cm(1)
 

Solbourne Computer, Inc.  —  25 September 1990