dtcm_delete(1)

NAME
dtcm_delete - delete appointments from the calendar database

SYNOPSIS
dtcm_delete [-c calendar] [-d date] [-v view]

DESCRIPTION
The dtcm_delete utility is a non-GUI interface to the CDE calendar and appointment services, used to delete appointments from the calendar database via the RPC daemon rpc.cmsd(1). 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 -d and -v 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 <carriage-return> to quit.

OPTIONS
The following options are available:

    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.
    Specify the date for the appointment(s) to be deleted. 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.
    Specify the view span of appointments to display. The view option-argument can be:

        Display all appointments for the given date (see -d option). Display the full week that contains the given date, starting with Sunday. Display the entire month that contains the given date.

OPERANDS
None.

STDIN
The standard input is used to receive user replies to the list of appointments to be deleted.

INPUT FILES
None.

ENVIRONMENT VARIABLES
The following environment variables affect the execution of dtcm_delete:

    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. If set to a non-empty string value, override the values of all the other internationalization variables. 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. Determine the location of message catalogues for the processing of LC_MESSAGES.

RESOURCES
None.

ASYNCHRONOUS EVENTS
The dtcm_delete utility takes the standard action for all signals.

STDOUT
The standard output contains the list of appointments to be deleted.

STDERR
Used only for diagnostic messages.

OUTPUT FILES
None.

EXTENDED DESCRIPTION
None.

EXIT STATUS
The following exit values are returned:

    Successful completion. 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_delete has no arguments:

    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)?

To delete at a specific date:

    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)?

To delete from a specific target calendar:

    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)?

To delete multiple appointments:

    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)?

SEE ALSO
rpc.cmsd(1), dtcm(1), dtcm_editor(1), dtcm_insert(1), dtcm_lookup(1).