dtcm_delete(1)

dtcm_delete - delete appointments from the calendar database

As shipped in IRIX 6.5.19. Added in IRIX 6.5.19.

     NAME
          dtcm_delete - delete appointments from the calendar database

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

     DESCRIPTION
          The dtcm_delete utility is 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:

             -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 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.

             -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.

     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:

             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_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:

              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_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_admin(1), dtcm_insert(1),
          dtcm_lookup(1).