CDE

NAME

dtcm − CDE Desktop Calendar Manager

SYNOPSIS

dtcm [−c calendar] [−p printer] [−v view]

OPTIONS

The dtcm command accepts all of the standard X Toolkit command line options as well as the following:

−c calendar
Specifies the calendar to display. The default value is equivalent to $USER@$HOST. 

−p printer
Specifies the default printer for the tool. The default is the system’s default printer.

−v view
Specifies the initial view. Values can be day, week, month or year. 

DESCRIPTION

The dtcm tool is the CDE appointment and resource scheduler. You can use it to do the following:

       •Display day, week, month and year views of your calendar

       •Schedule single or repeating calendar entries

       •Browse and edit another user’s calendar

       •Schedule reminders to give you notice of events

       •Restrict access to your calendar

       •Print high-quality hardcopy

       •View and schedule entries for a group of calendars

       •Change the time zone context

       •Announce appointments through electronic mail

       •Schedule appointments received by electronic mail

Concepts

A calendar is a collection of information stored on the network that contains scheduling data for a user. A calendar entry is an event recorded within the context of a calendar. The dtcm tool supports appointment and to-do calendar entries, either of which may be single or repeat entries. 

A calendar entry may have one or more associated reminders. A reminder causes the dtcm tool to notify you by issuing an alarm when the system time reaches your specified reminder notice period before the event. 

When you are viewing your calendar, the current date is the date you last selected either by selecting the Day View or by clicking in any of the other views. The current date does not change until you select another date, even if you have navigated out of a view that contains the current date. 

The dtcm tool presents a network calendar model. To operate on a calendar belonging to some user on the network, the dtcm tool establishes a session with a calendar server. Conceptually, a calendar server is a separate process running on the host where the calendar is located. A calendar server manages all the calendars for the host where it is running and can service multiple connected applications simultaneously. The calendar server responds to authentication, session control, and calendar transactions initiated by the dtcm tool, which in turn responds to server events such as updates caused by other connected application instances. 

The dtcm tool presents a single main window containing a graphical calendar. You can view this calendar by day, week, month or year in the main window. To navigate between these views, make a selection from the View menu or click one of the navigation buttons displayed in the current view. 

Menu Bar

File Menu

Archive...
Creates an archive of calendar data that lets you dump non-current data from your calendar. Very large calendars can be difficult to manage and Archive provides a means of removing a range of obsolete data.

Restore...
Loads a calendar archive previously created using Archive. Be careful when using this option; it is fairly primitive and will not attempt to reinsert repeating entries as part of their original sequence.

Printer Setup...
Allows you to specify parameters for a print job, such as number of copies, orientation and scaling.

Print Current View
Prints hard-copy based on the currently displayed calendar view.

Print Appointment List...
Invokes a print dialog that lets you choose the view of the appointment list that you want to print.

Print ToDo List...
Invokes a print dialog that lets you specify what to-do entries you want to print.

Options...
Invokes default options for all of the dtcm tool’s global attributes. 

Exit
Terminates the dtcm tool. 

Edit Menu

Appointment...
Invokes the Appointment Editor. The Appointment Editor is described in the Secondary Windows section. 

ToDo...
Invokes the To-Do Editor, described in the Secondary Windows section. 

Properties...
Invokes the properties dialog for appointments and to-do entries. This item is for properties of calendar data entities. For properties of the dtcm tool, use the Properties... entry in the File menu. 

View Menu

Day
Changes the current view in the main window to Day View.

Week
Changes the current view in the main window to Week View.

Month
Changes the current view in the main window to Month View.

Year
Changes the current view in the main window to Year View.

Appointment List...
Invokes the Appointment List dialog. 

ToDo List...
Invokes the ToDo List dialog. 

Find...
Invokes the Find dialog, which you can use to locate calendar entries by specifying some search criteria. 

Go to Date...
Invokes the Go to Date dialog, which lets you change the view to a specified date. This is a convenient way to get to dates that are distant from the current date. 

Browse Menu

Show Other Calendar...
Invokes a dialog to let you connect to a different calendar than the one currently displayed in the main window. You will still be displaying a single calendar.

Compare Calendars...
Invokes the Compare Calendars dialog, which is described in the Secondary Windows section. 

Menu Editor...
Invokes a dialog that lets you add frequently used calendars to the Browse menu for this and future sessions with the dtcm tool. 

<user>@<host>

...This sequence of entries consists of your own calendar, followed by an optional list of calendars that you can add to the menu using the Menu Editor... option described above. Your own calendar always appears first. The other options are listed in alphabetical order. 

Secondary Windows

The dtcm tool has several secondary windows for accessing the scheduling and browsing features. 

Appointment Editor
The Appointment Editor lets you schedule appointments, which is the most common type of calendar entry. It is useful for scheduling time slots in your calendar that can be exported to other users either by direct entry to their calendars or by electronic mail. To invoke the appointment editor, click on the clock icon, select it from the Edit menu, or double click anywhere in the graphical calendar view. 

To Do Editor
The To Do Editor lets you maintain a list of to-do items for your personal use. These entries are private and are not visible to other users who browse your calendar. To-do entries differ from appointments in that they need not appear as scheduled events in your calendar views. If a Due Date is associated with a to-do entry, you see the due date on your calendar view.  To-do entries let you maintain a list of work items without allocating calendar time. To invoke the to-do editor, click on the check-mark icon or select it from the Edit menu. 

Group Appointment Editor
The Group Appointment Editor lets you schedule an appointment on multiple calendars at once. To invoke the group appointment editor, click Schedule in the Compare Calendars window. You can choose to announce the appointment by electronic mail. 

Compare Calendars Window
The Compare Calendars window lets you connect to several calendars simultaneously and get a graphical overview of busy and available time in the resultant virtual calendar. To display the compare calendars window, select Compare Calendars... from the Browse menu. 

Options Window
The Options window lets you set dtcm tool options.  Available categories include Editor Defaults, Display Settings, Access List and Permissions, Printer Settings, and Date Format. Set the options to suit your requirements and save them by clicking Apply. To display the Options window, select Options... from the File menu. 

Resources

The dtcm tool supports a number of application resources to let you configure its behavior. The application class name for the dtcm tool is DtCalendar. To set application resources, you can copy the system defaults from /usr/dt/app-defaults/<LANG>/DtCalendar to a personal version such as ~/app-defaults/DtCalendar and edit it with your changes. 

FILES

/usr/dt/bin/dtcm
Executable file

/usr/dt/app-defaults/<LANG>/DtCalendar
System default application resources

/usr/dt/bin/rpc.cmsd
Calendar daemon (server) that manages calendars on this system

/var/spool/calendar/callog.user
Persistent calendar database on this system for user