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(1). It can be used to look up appointments from the cm database via the RPC daemon rpc.cmsd(1). 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 specified 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 embedded 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:30am-10:45am Morning Tea

3) 2:00pm-3:00pm Staff meeting

4) 4:30pm-5:00pm Phone home

example%

To look up a specific date:

example% cm_lookup -d 09/26/90

Appointments for Wednesday September 26, 1990:

1) 11:00am-12:00pm Appointment

2) 11:30am-12:30pm Group Lunch

3) 4:00pm-5:00pm 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:15am-10:30am Coffee

3) 11:15am-11:30am Doughnuts

4) 2:00pm-2:15pm Coffee

5) 3:30pm-3:45pm Snack

6) 4:30pm-4:45pm Coffee

example%

To look up an entire week's appointments:

example% cm_lookup -v week

Appointments for Sunday September 23, 1990:

1) 6:00am-5:00pm Hiking

Appointments for Monday September 24, 1990:

1) 11:00am-11:30am Sync with East Coast

2) 4:00pm-4:15pm Confirm flight

Appointments for Tuesday September 25, 1990:

1) Appointment

2) 10:15am-10:30am Coffee

3) 11:15am-11:30am Doughnuts

4) 2:00pm-2:15pm Coffee

5) 3:30pm-3:45pm Snack

6) 4:30pm-4:45pm Coffee

Appointments for Wednesday September 26, 1990:

1) 11:00am-11:15am Appointment

2) 11:30am-12:30pm Group Lunch

3) 4:00pm-5:00pm Tech Interview

Appointments for Friday September 28, 1990:

1) Documentation

2) 10:00am-11:00am Staff meeting

Appointments for Saturday September 29, 1990:

1) 9:00am-11:00am Raquetball with Debbie

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)