NAME dtcm - the CDE Calendar Manager SYNOPSIS dtcm [-c calendar] [-p printer] [-v view] DESCRIPTION The dtcm utility is the GUI for CDE appointment and resource scheduling. It can be used to: o Display day, week, month, and year views of the user's calendar o Schedule single or repeating calendar entries o Browse and edit another user's calendar o Schedule reminders to give the user notice of events o Restrict access to the user's calendar o Print high-quality hardcopy o View and Schedule entries for a group of calendars o Change the time zone context o Announce appointments via electronic mail o Schedule appointments received in electronic mail OPTIONS The following options are available along with all of the standard X Toolkit command-line options: -c calendar Specifies the calendar to display. The default value is equivalent to $USER@$HOST. -p printer Specifies the default printer. The default is the system's default printer. -v view Specifies the initial view. Values can be day, week, month or year. OPERANDS None. STDIN Not used. INPUT FILES None. ENVIRONMENT VARIABLES The following environment variables affect the execution of dtcm: HOME Determine the user's home directory, the location of configuration files. 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, dtcm 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. XAPPLRESDIR Specify the name of a directory that con- tains application-specific resources. If this environment variable is defined, and is set to an existing directory, then it is searched (in addition to the standard locations) for files containing application-specific resource specifica- tions. XENVIRONMENT Specify the name of a resource file with user- or machine-specific resources. If this variable is not defined, dtcm looks for a file named $HOME/.Xdefaults-hostname instead, where hostname is the name of the host where the application is executing. XFILESEARCHPATH Define a language-dependent location of app-defaults. XMODIFIER Specify which input method to use. XUSERFILESEARCHPATH Control where X applications look for their app-defaults resource files. The default is located in the directory /usr/dt/app-defaults. The user must set XUSERFILESEARCHPATH if the user's resource files are not in this location. RESOURCES The dtcm utility allows the user to specify behavior through X11 resources as well as the command-line interface. The application class name for dtcm is Dtcm. To set application resources, the user can copy the system default version of the file /usr/dt/app-defaults/<LANG>/Dtcm to a personal ver- sion (typically $HOME/app-defaults/Dtcm, but the location is dependent on the value of the XAPPLRESDIR environment vari- able) and edit it with the appropriate changes. The follow- ing are the supported resources and their default values: Basic Resources _______________________________________________________________________ Name Class Type Default _______________________________________________________________________ labelFont LabelFont XmRFontList varies viewFont ViewFont XmRFontList varies boldFont BoldFont XmRFontList varies iconFont IconFont XmRFontList -dt-application-bold-r-normal- sans-*-180-*-*-p-*-*-*: application- Application- XmRXmString application FontFamily FontFamily labelFont Specifies the font to use for the labels in the calendar's views. viewFont Specifies the font to use for the text of the appointments in the calendar's views. boldFont Specifies the font to use for the time ranges in the week view. iconFont Specifies the icon font. applicationFontFamily Specifies the font family name to use for the text of the appointments in the calendar's views. A font will be used with this family name and appropriate size to match the system font size chosen via dtstyle(1). The viewFont and boldFont resources have a higher precedent than application- FontFamily. ASYNCHRONOUS EVENTS The dtcm utility takes the standard action for all signals. STDOUT Not used. STDERR Used only for diagnostic messages. OUTPUT FILES None. EXTENDED DESCRIPTION A calendar is a persistent entity existing somewhere on the network, which contains scheduling data for a user. A calendar entry is an event recorded within the context of a calendar. Calendar entries supported by dtcm are appoint- ment and to-do. Calendar entries can be single or repeat entries. A calendar entry may have one or more reminders associated with it. A reminder causes dtcm to notify the user by issuing an alarm when the system time enters the user's specified reminder notice period before the event. When viewing the user's calendar, there is the notion of the current date, which is the date the user last selected by selecting the Day View, or by clicking in any of the other views. The current date does not change until the user selects another date, even if he or she has navigated out of a view that would contain the current date. The dtcm utility presents a network calendar model. To operate on a calendar belonging to some user on the network, dtcm establishes a session with a calendar server. The calendar server is (conceptually at least) a separate pro- cess running on the host where the calendar is located. It manages all the calendars for the host on which it is run- ning, and can service multiple connected applications simul- taneously. The calendar server responds to authentication, session control and calendar transactions initiated by dtcm. In addition, dtcm responds to events occurring at the server, such as updates caused by other connected applica- tion instances. Usage The dtcm utility has a single main window, containing a graphical calendar. The user can choose to view day, week, month or year in the main window. Navigating between the views is achieved by selecting the view from the View menu, or by clicking one of the navigation buttons displayed in the current view. If tooltip display is enabled then a tooltip label is associated with each button on the calendar toolbar. A tooltip label describes the functionality of a button in a few words. File Menu Print Current View Prints hard-copy based on the currently displayed calendar view. Print ... Allows the user to specify parameters for a print job, such as number of copies, orientation, scaling, report type. Options ... Displays default options for all of dtcm's global attributes. Exit Terminates the dtcm application. Edit Menu Appointment ... Displays the appointment editor, described below. ToDo ... Displays the To Do editor, described below. View Menu Day Changes the current view in the main win- dow to Day View. Week Changes the current view in the main win- dow to Week View. Month Changes the current view in the main win- dow to Month View. Year Changes the current view in the main win- dow to Year View. Appointment List ... Displays the Appointment List dialog box. ToDo List ... Displays the ToDo List dialog box. Find ... Displays the Find dialog box, so the user can locate calendar entries by specifying some search criteria. Go to Date ... Displays the Go to Date dialog, so the user can change the view to a specified date. This is a convenient way to get to dates that are distant from the current date. Time Zone Displays the Time Zone dialog, so the user can set the time zone to which appointment times are relative. Browse Menu Show Other Calendar ... Displays a dialog box, in the main window, to let the user connect to a different calendar than the one currently displayed. Only a single calendar is displayed at once. Compare Calendars ... Displays the Compare Calendars dialog box, described below. Menu Editor ... Displays a dialog box that allows the user to add frequently used calendars to the Browse menu for this and future sessions with dtcm. <user>@<host> ... This sequence of entries consists of the user's own calendar, followed by an optional list of calendars that the user can add to the menu using the Menu Editor option described above. The user's own calendar always appears first. The other options are listed in alphabetical order. Secondary Windows In addition to the main window, dtcm has several secondary windows, which give the user access to the scheduling and browsing features of dtcm. The Appointment Editor allows scheduling of appointments. An appointment is the most common type of calendar entry. It is useful for scheduling time slots in the user's calen- dar, and can be exported to other users either by direct entry to their calendars, or through electronic mail. To invoke the appointment editor, the user selects it from the Edit menu in the main window, or double-clicks anywhere in the graphical calendar view. The To Do Editor allows the user to maintain a list of to-do items for his or her personal use. To-do entries are not visible to other dtcm users who are browsing the user's calendar; they are private to the user. To-do entries differ from appointments in that they do not necessarily appear as scheduled events in the user's calendar views. If a to-do entry has a Due Date associated with it, it will be displayed in the calendar view. The main purpose of to-do entries is to allow the user to maintain a list of work items, without necessarily allocating calendar time for them. The to-do editor is invoked by selecting it from the Edit menu in the main window. The Group Appointment Editor allows the user to schedule an appointment on multiple calendars at once. It is invoked by clicking Schedule in the Compare Calendars window. The user may optionally announce the appointment over electronic mail. The Compare Calendars window allows the user to connect to several calendars simultaneously, and get a graphical over- view of busy and available time in the resultant ``virtual calendar.'' The compare calendars window is invoked by selecting it from the Browse menu in the main window. The Options window, accessible from the File menu, gives the user access to the dtcm options that the user can configure. There are several categories of options: Editor Defaults; Display Settings; Access List and Permissions; Printer Set- tings and Date Format. The user can set the options to suit his or her requirements, and save them by clicking Apply. EXIT STATUS The following exit values are returned: 0 Successful completion. >0 An error occurred. CONSEQUENCES OF ERRORS Default. APPLICATION USAGE None. FILES /usr/dt/bin/dtcm The executable for dtcm. /usr/dt/app-defaults/<LANG>/Dtcm The system-default application defaults file for dtcm. /usr/dt/appconfig/types/<LANG>/dtcm.dt The file of default calendar-specific actions. See dtactionfile(4). /usr/dt/bin/rpc/rpc.cmsd The calendar daemon (server) that manages calendars on a machine. /var/spool/calendar/callog.<user> The persistent calendar database for a user on this machine. EXAMPLES None. SEE ALSO rpc.cmsd(1), dtcm_delete(1), dtcm_editor(1), dtcm_insert(1), dtcm_lookup(1), tooltips(3), dtactionfile(4), X11(7).
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |