/usr/man/cat.1/dtcm_delete.1(/usr/man/cat.1/dtcm_delete.1)

dtcm_delete(1)		 USER COMMANDS		   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	non-GUI	interface to the TED
     calendar and appointment services,	used to	delete appoint-
     ments 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 appoint-
     ments 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.  Cer-
	      tain other references such as ``today,'' ``Tues-
	      day,'' ``tomorrow,'' etc.	 are correctly calcu-
	      lated.  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

Unix System LaboratoLast change: 1 August 1995			1

dtcm_delete(1)		 USER COMMANDS		   dtcm_delete(1)

			   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 interna-
		       tionalization 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 internation-
		       alization 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, over-
		       ride the	values of all the other	interna-
		       tionalization variables.

	LC_MESSAGES    Determine the locale that is used to
		       affect the format and contents of diagnos-
		       tic messages written to standard	error and
		       informative messages written to standard
		       output.

	NLSPATH	       Determine the location of message catalo-
		       gues 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.

Unix System LaboratoLast change: 1 August 1995			2

dtcm_delete(1)		 USER COMMANDS		   dtcm_delete(1)

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

Unix System LaboratoLast change: 1 August 1995			3

dtcm_delete(1)		 USER COMMANDS		   dtcm_delete(1)

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

Unix System LaboratoLast change: 1 August 1995			4

dtcm_delete(1)		 USER COMMANDS		   dtcm_delete(1)

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

Unix System LaboratoLast change: 1 August 1995			5

See also dtcm_delete(1)