<!-- $XConsortium: cm_looku.sgm /main/10 1996/09/08 19:50:48 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCSA.MAN4.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCSA.MAN4.rsml.1">]]>
<RefMeta>
<RefEntryTitle>dtcm_lookup</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>dtcm_lookup</Command></RefName>
<RefPurpose>look up appointments from the calendar database
</RefPurpose>
</RefNameDiv>
<!-- CDE Common Source Format, Version 1.0.0-->
<!-- (c) Copyright 1993, 1994, 1995 Hewlett-Packard Company-->
<!-- (c) Copyright 1993, 1994, 1995 International Business Machines Corp.-->
<!-- (c) Copyright 1993, 1994, 1995 Sun Microsystems, Inc.-->
<!-- (c) Copyright 1993, 1994, 1995 Novell, Inc.-->
<RefSynopsisDiv>
<CmdSynopsis>
<Command>dtcm_lookup</Command>
<Arg Choice="opt">-c <Replaceable>calendar</Replaceable></Arg>
<Arg Choice="opt">-d <Replaceable>date</Replaceable></Arg>
<Arg Choice="opt">-v <Replaceable>view</Replaceable></Arg>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Command>dtcm_lookup</Command> utility is non-GUI interface to the &str-XZ; calendar and appointment services,
used to look up appointments from the calendar
<![ %CDE.C.CDE; [database via the RPC daemon
&cdeman.rpc.cmsd;. ]]><![ %CDE.C.XO; [database.
]]>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
<Literal>-d</Literal> and
<Literal>-v</Literal> options) is displayed.
</Para>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<![ %CDE.C.XO; [
<Para>The
<Command>dtcm_lookup</Command> utility supports the &str-Zu;.
</Para>
]]>
<Para>The following options are available:
</Para>
<VariableList>
<VarListEntry>
<Term><Literal>-c </Literal><Emphasis>calendar</Emphasis></Term>
<ListItem>
<Para>Specify the name of the target calendar.
Calendar names
<![ %CDE.C.XO; [are implementation-dependent, but
]]>typically take the form
<Emphasis>user</Emphasis>@ <Emphasis>hostname</Emphasis>, where
<Emphasis>user</Emphasis> is a user's login name and
<Emphasis>hostname</Emphasis> is the host machine name.
<![ %CDE.C.CDE; [An example is
<Literal>felix@cat</Literal>. ]]>If no target calendar is specified,
the calendar defaults to
the current user at the current host machine.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-d </Literal><Emphasis>date</Emphasis></Term>
<ListItem>
<Para>Specify the date for the look up query.
The
<Emphasis>date</Emphasis> is specified using the form
<Symbol Role="Variable">mm</Symbol>/ <Emphasis>dd</Emphasis>/ <Emphasis>yy</Emphasis>, where
<Symbol Role="Variable">mm</Symbol>, <Emphasis>dd</Emphasis> and
<Emphasis>yy</Emphasis> are the two-digit month, day and year modulo 100, respectively.
<![ %CDE.C.CDE; [Certain other references such as
``today,'' ``Tuesday,'' ``tomorrow,'' etc.
are correctly calculated.
]]>If no date is specified,
<Emphasis>date</Emphasis> defaults to today's date.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-v </Literal><Emphasis>view</Emphasis></Term>
<ListItem>
<Para>Specify the view span of appointments to display.
The
<Emphasis>view</Emphasis> option-argument can be:
</Para>
<VariableList>
<VarListEntry>
<Term><Literal>day</Literal></Term>
<ListItem>
<Para>Display all appointments for the given date (see
<Literal>-d</Literal> option).
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>week</Literal></Term>
<ListItem>
<Para>Display the full week that contains the given date,
starting with Sunday.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>month</Literal></Term>
<ListItem>
<Para>Display the entire month that contains the given date.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<![ %CDE.C.CDE; [
<Para>If the
<Emphasis>view</Emphasis> option-argument is not specified, the viewing range defaults to the view
range specified by the user's
<Command>dtcm</Command> options sheet.
If the user has
not specified a range in his or her options sheet, it defaults to the
<Literal>day</Literal> value.
</Para>
]]>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>OPERANDS</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>STDIN</Title>
<Para>Not used.
</Para>
</RefSect1>
<RefSect1>
<Title>INPUT FILES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>ENVIRONMENT VARIABLES</Title>
<Para>The following environment variables affect the execution of
<Command>dtcm_lookup</Command>:</Para>
<VariableList>
<VarListEntry>
<Term><SystemItem Class="EnvironVar">LANG</SystemItem></Term>
<ListItem>
<Para>Provide a default value for the internationalization variables
that are unset or null.
If
<SystemItem Class="EnvironVar">LANG</SystemItem> 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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>LC_ALL</Emphasis></Term>
<ListItem>
<Para>If set to a non-empty string value,
override the values of all the other internationalization variables.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>LC_MESSAGES</Emphasis></Term>
<ListItem>
<Para>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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="EnvironVar">NLSPATH</SystemItem></Term>
<ListItem>
<Para>Determine the location of message catalogues
for the processing of
<Emphasis>LC_MESSAGES</Emphasis>.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RESOURCES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>ASYNCHRONOUS EVENTS</Title>
<![ %CDE.C.XO; [
<Para>Default.
</Para>
]]>
<![ %CDE.C.CDE; [
<Para>The
<Command>dtcm_lookup</Command> utility takes the standard action for all signals.
</Para>
]]>
</RefSect1>
<RefSect1>
<Title>STDOUT</Title>
<Para>The standard output contains the list of appointments
for the specified view
<![ %CDE.C.CDE; [span.
]]><![ %CDE.C.XO; [span, in an unspecified format.
]]></Para>
</RefSect1>
<RefSect1>
<Title>STDERR</Title>
<Para>Used only for diagnostic messages.
</Para>
</RefSect1>
<RefSect1>
<Title>OUTPUT FILES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXTENDED DESCRIPTION</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXIT STATUS</Title>
<Para>The following exit values are returned:
</Para>
<VariableList>
<VarListEntry>
<Term>0</Term>
<ListItem>
<Para>Successful completion.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>>0</Term>
<ListItem>
<Para>An error occurred.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>CONSEQUENCES OF ERRORS</Title>
<Para>Default.
</Para></RefSect1>
<![ %CDE.C.CDE; [<RefSect1>
<Title>FILES</Title>
<Para><Filename>/var/spool/calendar/callog.username</Filename>,
<Filename>/usr/dt/bin/rpc.cmsd</Filename></Para>
</RefSect1>]]>
<RefSect1>
<Title>APPLICATION USAGE</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXAMPLES</Title>
<![ %CDE.C.XO; [
<Para>None.
</Para>
]]>
<![ %CDE.C.CDE; [
<Para>The simplest form of
<Command>dtcm_lookup</Command> has no arguments:
</Para>
<InformalExample Remap="indent">
<ProgramListing>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
</ProgramListing>
</InformalExample>
<Para>To look up entries for a specific date:
</Para>
<InformalExample Remap="indent">
<ProgramListing>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
</ProgramListing>
</InformalExample>
<Para>To look up entries from a specific target calendar:
</Para>
<InformalExample Remap="indent">
<ProgramListing>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
        5) 3:30pm-3:45pm Snack
        6) 4:30pm-4:45pm Coffee
</ProgramListing>
</InformalExample>
<Para>To look up an entire week's appointments:
</Para>
<InformalExample Remap="indent">
<ProgramListing>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
</ProgramListing>
</InformalExample>
<Para>Notice that Thursday does not appear, since there were no appointments
on that day.
</Para>
]]>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para><![ %CDE.C.CDE; [&cdeman.rpc.cmsd;, &cdeman.dtcm;, ]]>&cdeman.dtcm.insert;, &cdeman.dtcm.delete;.</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:40:24-->
