NAME cm_insert - insert appointments into Calendar Manager data- base SYNOPSIS cm_insert [ -c calendar ] [ -d date ] [ -s start ] [ -e end ] [ -v view ] [ -w what ] DESCRIPTION The cm_insert utility is a tty interface to Calendar Manager cm(1). It can be used to add new appointments to the cm database via the RPC daemon rpc.cmsd. Appointments are added one at a time. Each of the components of an appoint- ment is specified using one of the command line flags fol- lowed by the desired value. Once an appointment is added, the list of appointments for the specified date (see date, view options) is displayed. OPTIONS -c calendar The name of the target calendar. Calendar names take the form "user@host", where the user is a user's login name and the host is the host machine name. An example is "felix@cat". If no target calendar is specified, calendar defaults to the current user at the current host machine. -d date The insertion date for the appointment. The date is specified using the form "mm/dd/yy", although certain other references such as "today", "Tues- day", "tomorrow", etc. are correctly calculated. If no date is specified, date defaults to today's date. -s start The starting time for the appointment. The time is specified using the form "hh:mm" plus an optional "am" or "pm" meridian. If "am/pm" is left off, "am" is assumed. Time specified using 24-hour con- vention (e.g. "15:30" instead of "3:30 pm") are acceptable and are converted to meridian time before insertion. If no starting time is speci- fied, starting time defaults to "magic" time (see Calendar Manager manual) and no time appears next to the appointment. -e end The ending time for the appointment. The time is specified as above "starting time". It is con- sidered an error to specify an ending time without specifying a starting time. -v view View span. This controls the span of time to display. The user may specify "day", "week", or "month". The "day" view displays all appointments for the given date (see -d option above). The "week" view displays the full week which contains the given date, starting with Sunday. The "month" view displays the entire month which contains the given date, starting with the first of the month. The default view is "day". -w what What the appointment is about. The user may specify a string of text describing the nature of the appointment. Up to 5 lines of text can be specified by placing "\n" (actual characters "\" and "n", not newline) between lines. It may be necessary to escape the "\" character ("\\n") or enclose string in quotes (""this string in quotes"") to avoid interpretation by the local shell. If not specified, "what" defaults to "Appointment". USAGE The various components of an appointment are specified using command line flags followed by the desired value. Values may have embedded spaces, punctuation, etc., although quotes may be needed around strings which contain certain charac- ters to protect them from interpretation by the local shell (e.g. /bin/csh). An argument is taken to begin at the first space after a flag and to continue until the first "-" after a space. EXAMPLE The simplest form of cm_insert has no arguments: example% cm_insert Appointments for Tuesday September 25, 1990: 1) Appointment example% To insert at a specific time: example% cm_insert -s 11:00 am Appointments for Tuesday September 25, 1990: 1) Appointment 2) 11:00am-12:00pm Appointment example% To insert at a specific start and end time: example% cm_insert -s 11:00 am -e 11:28 am Appointments for Tuesday September 25, 1990: 1) Appointment 2) 11:00am-11:28am Appointment example% To insert at a specific time and date: example% cm_insert -s 11:00 am -d 09/26/90 Appointments for Wednesday September 26, 1990: 1) 11:00am-12:00pm Appointment example% To insert at a specific time, date, and message: example% cm_insert -s 11:00 am -d 09/26/90 -w call home Appointments for Wednesday September 26, 1990: 1) 11:00am-12:00pm Appointment 2) 11:00am-12:00pm call home example% Lastly, for multiple line appointments: example% cm_insert -s 12:00 -w call dentist\\n no thanks\\ncancel appointment Appointments for Tuesday September 25, 1990: 1) Appointment 2) 11:00am-12:00pm Appointment 3) 12:00pm-1:00pm call dentist no thanks cancel appointment example% FILES /usr/spool/calendar/callog.username /usr/etc/rpc.cmsd or $OPENWINHOME/rpc.cmsd SEE ALSO rpc.cmsd(1), cm_delete(1), cm_lookup(1), cm(1) NOTES The OpenWindows environment may no longer be supported in a future release. You may want to migrate to CDE, the Common Desktop Environment.
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |