<!-- $XConsortium: cm_delet.sgm /main/10 1996/09/08 19:50:22 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.MAN2.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCSA.MAN2.rsml.1">]]>
<RefMeta>
<RefEntryTitle>dtcm_delete</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>dtcm_delete</Command></RefName>
<RefPurpose>delete 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_delete</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_delete</Command> utility is non-GUI interface to the &str-XZ; calendar and appointment services,
used to delete appointments from the calendar
<![ %CDE.C.CDE; [database via the RPC daemon
&cdeman.rpc.cmsd;. ]]><![ %CDE.C.XO; [database.
]]>Appointments are deleted one at a time.
Each of the components of an
appointment 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,
numbered sequentially starting with 1.
The user is prompted for the number to delete.
Once an appointment
is deleted, the list of remaining appointments is redisplayed.
At this point
the user can specify another number, or just
<KeySym>carriage-return</KeySym> to quit.
</Para>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<![ %CDE.C.XO; [
<Para>The
<Command>dtcm_delete</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 appointment(s) to be deleted.
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>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>OPERANDS</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>STDIN</Title>
<Para>The standard input is used to receive user
replies to the list of appointments to be deleted.
</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_delete</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_delete</Command> utility takes the standard action for all signals.
</Para>
]]>
</RefSect1>
<RefSect1>
<Title>STDOUT</Title>
<Para>The standard output contains the list of appointments to be
<![ %CDE.C.CDE; [deleted.
]]><![ %CDE.C.XO; [deleted, 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_delete</Command> has no arguments:
</Para>
<InformalExample Remap="indent">
<ProgramListing>dtcm_delete
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:30pm Phone home
Item to delete (number)? 2
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 2:00pm-3:00pm Staff meeting
        3) 4:30pm-5:30pm Phone home
Item to delete (number)?
</ProgramListing>
</InformalExample>
<Para>To delete at a specific date:
</Para>
<InformalExample Remap="indent">
<ProgramListing>dtcm_delete -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
Item to delete (number)? 1
Appointments for Wednesday September 26, 1990:
        1) 11:30am-12:30pm Group Lunch
        2) 4:00pm-5:00pm Tech Interview
Item to delete (number)?
</ProgramListing>
</InformalExample>
<Para>To delete from a specific target calendar:
</Para>
<InformalExample Remap="indent">
<ProgramListing>dtcm_delete -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
Item to delete (number)? 5
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) 4:30pm-4:45pm Coffee
Item to delete (number)?
</ProgramListing>
</InformalExample>
<Para>To delete multiple appointments:
</Para>
<InformalExample Remap="indent">
<ProgramListing>dtcm_delete
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
Item to delete (number)? 5
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) 4:30pm-4:45pm Coffee
Item to delete (number)? 3
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 10:15am-10:30am Coffee
        3) 2:00pm-2:15pm Coffee
        4) 4:30pm-4:45pm Coffee
Item to delete (number)?
</ProgramListing>
</InformalExample>
]]>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para><![ %CDE.C.CDE; [&cdeman.rpc.cmsd;, &cdeman.dtcm;, ]]>&cdeman.dtcm.insert;, &cdeman.dtcm.lookup;.</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:40:24-->
