dtcm_lookup(1) UNIX System V (1 August 1995) dtcm_lookup(1)
NAME
dtcm_lookup - look up appointments from the calendar
database
SYNOPSIS
dtcm_lookup [-c calendar] [-d date] [-v view]
DESCRIPTION
The dtcm_lookup utility is non-GUI interface to the CDE
calendar and appointment services, used to look up
appointments from the calendar database via the RPC daemon
rpc.cmsd(1). Each component of the calendar entry is
specified using one of the command-line options. The
current list of appointments for the specified date (see the
-d and -v options) is displayed.
OPTIONS
The following options are available:
-c calendar
Specify the name of the target calendar. Calendar
names typically take the form user@hostname, where
user is a user's login name and hostname is the
host machine name. An example is felix@cat. If no
target calendar is specified, the calendar defaults
to the current user at the current host machine.
-d date
Specify the date for the look up query. The date
is specified using the form mm/dd/yy, where mm, dd
and yy are the two-digit month, day and year modulo
100, respectively. 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
Specify the view span of appointments to display.
The view option-argument can be:
day Display all appointments for the given
date (see -d option).
week Display the full week that contains
the given date, starting with Sunday.
month Display the entire month that contains
the given date.
If the view option-argument is not specified, the
viewing range defaults to the view range specified
by the user's dtcm options sheet. If the user has
Page 1 (printed 9/3/04)
dtcm_lookup(1) UNIX System V (1 August 1995) dtcm_lookup(1)
not specified a range in his or her options sheet,
it defaults to the day value.
OPERANDS
None.
STDIN
Not used.
INPUT FILES
None.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of
dtcm_lookup:
LANG Provide a default value for the
internationalization variables that are
unset or null. If LANG is unset or null,
the corresponding value from the
implementation-specific default locale
will be used. If any of the
internationalization variables contains an
invalid setting, the utility behaves as if
none of the variables had been defined.
LC_ALL If set to a non-empty string value,
override the values of all the other
internationalization variables.
LC_MESSAGES Determine the locale that is used to
affect the format and contents of
diagnostic messages written to standard
error and informative messages written to
standard output.
NLSPATH Determine the location of message
catalogues for the processing of
LC_MESSAGES.
RESOURCES
None.
ASYNCHRONOUS EVENTS
The dtcm_lookup utility takes the standard action for all
signals.
STDOUT
The standard output contains the list of appointments for
the specified view span.
STDERR
Page 2 (printed 9/3/04)
dtcm_lookup(1) UNIX System V (1 August 1995) dtcm_lookup(1)
Used only for diagnostic messages.
OUTPUT FILES
None.
EXTENDED DESCRIPTION
None.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
CONSEQUENCES OF ERRORS
Default.
FILES
/usr/spool/calendar/callog.username
/usr/dt/bin/rpc.cmsd
APPLICATION USAGE
None.
EXAMPLES
The simplest form of dtcm_lookup has no arguments:
dtcm_lookup
Appointments for Tuesday March 29, 1994:
1) Appointment
2) 10:30am-10:45am Morning Tea
3) 2:00pm-3:00pm Staff meeting
4) 4:30pm-5:00pm Phone home
To look up entries for a specific date:
dtcm_lookup-d 03/29/94
Appointments for Wednesday March 30, 1994:
1) 11:00am-12:00pm Appointment
2) 11:30am-12:30pm Group Lunch
3) 4:00pm-5:00pm Tech Interview
To look up entries from a specific target calendar:
dtcm_lookup-c felix@cat
Appointments for Tuesday March 29, 1994:
1) Appointment
2) 10:15am-10:30am Coffee
3) 11:15am-11:30am Doughnuts
4) 2:00pm-2:15pm Coffee
Page 3 (printed 9/3/04)
dtcm_lookup(1) UNIX System V (1 August 1995) dtcm_lookup(1)
5) 3:30pm-3:45pm Snack
6) 4:30pm-4:45pm Coffee
To look up an entire week's appointments:
dtcm_lookup-v week
Appointments for Sunday March 27, 1994:
1) 6:00am-5:00pm Hiking
Appointments for Monday March 28, 1994:
1) 11:00am-11:30am Sync with East Coast
2) 4:00pm-4:15pm Confirm flight
Appointments for Tuesday March 29, 1994:
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 March 30, 1994:
1) 11:00am-11:15am Appointment
2) 11:30am-12:30pm Group Lunch
3) 4:00pm-5:00pm Tech Interview
Appointments for Friday April 1, 1994:
1) Documentation
2) 10:00am-11:00am Staff meeting
Appointments for Saturday April 2, 1994:
1) 9:00am-11:00am Raquetball with Debbie
Notice that Thursday does not appear, since there were no
appointments on that day.
SEE ALSO
rpc.cmsd(1), dtcm(1), dtcm_admin(1), dtcm_insert(1),
dtcm_delete(1).
Page 4 (printed 9/3/04)
