dtcm(1)

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:

    Display day, week, month, and year views of the user's calendar Schedule single or repeating calendar entries Browse and edit another user's calendar Schedule reminders to give the user notice of events Restrict access to the user's calendar Print high-quality hardcopy View and Schedule entries for a group of calendars Change the time zone context Announce appointments via electronic mail Schedule appointments received in electronic mail

OPTIONS
The following options are available along with all of the standard X Toolkit command-line options:

    Specifies the calendar to display. The default value is equivalent to $USER@$HOST.
    Specifies the default printer. The default is the system's default printer.
    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:

    Determine the user's home directory, the location of configuration files. 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, dtcm behaves as if none of the variables had been defined. If set to a non-empty string value, override the values of all the other internationalization variables. 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. Determine the location of message catalogues for the processing of LC_MESSAGES. Specify the name of a directory that contains 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 specifications.
    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.
    Define a language-dependent location of app-defaults. Specify which input method to use.
    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 version (typically $HOME/app-defaults/Dtcm, but the location is dependent on the value of the XAPPLRESDIR environment variable) and edit it with the appropriate changes. The following 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

    Specifies the font to use for the labels in the calendar's views.
    Specifies the font to use for the text of the appointments in the calendar's views.
    Specifies the font to use for the time ranges in the week view.
    Specifies the icon font.
    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 applicationFontFamily.

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 appointment 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 process running on the host where the calendar is located. It manages all the calendars for the host on which it is running, and can service multiple connected applications simultaneously. 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 application 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.

        Prints hard-copy based on the currently displayed calendar view. Allows the user to specify parameters for a print job, such as number of copies, orientation, scaling, report type.
        Displays default options for all of dtcm's global attributes. Terminates the dtcm application.

        Displays the appointment editor, described below. Displays the To Do editor, described below.

        Changes the current view in the main window to Day View. Changes the current view in the main window to Week View. Changes the current view in the main window to Month View. Changes the current view in the main window to Year View.
        Displays the Appointment List dialog box.
        Displays the ToDo List dialog box. Displays the Find dialog box, so the user can locate calendar entries by specifying some search criteria.
        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. Displays the Time Zone dialog, so the user can set the time zone to which appointment times are relative.

        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.
        Displays the Compare Calendars dialog box, described below.
        Displays a dialog box that allows the user to add frequently used calendars to the Browse menu for this and future sessions with dtcm.

        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 calendar, 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 overview 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 Settings 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:

    Successful completion. 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), dtactionfile(4), X11(7).