Index Index for
Section 1
Index Alphabetical
listing for D
Index Bottom of
page		 

dtcm_delete(1)


CDE




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(1m).  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

  -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(1m), dtcm(1), dtcm_admin(1), dtcm_insert(1), dtcm_lookup(1).

Index Index for
Section 1
Index Alphabetical
listing for D
Index Top of
page