dtcm(user cmd)

NAME
dtcm — The CDE Calendar Manager.

SYNOPSIS

dtcm [-vview] [-ccalendar] [-pprinter]

DESCRIPTION

dtcm is the CDE appointment and resource scheduling tool. Use it to:

- 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 via electronic mail

- Schedule appointments received in electronic mail

OPTIONS

dtcm 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. The default is the system's default printer.

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

CONCEPTS

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 you by issuing an alarm when the system time enters your specified reminder notice period before the event. When viewing your calendar, you have the notion of the current date, which is the date you last selected 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 would contain the current date.

dtcm 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 applications instances.

USAGE

dtcm has a single main window, containing a graphical calendar. You 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.

Menu Bar

File Menu

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

Print...
    Brings up a Print Setup window that allows you to select the report type to use for the currently selected view, as well as various printing options. You can specify a from/to date range, the printer name, and the number of copies. You can set other more generic options, such as margins and footers, by clicking on the More... button.

Options...
    Brings up default options for all of dtcm's global attributes.

Exit
    Terminates the dtcm application.

Edit Menu

Appointment...
    Brings up the appointment editor, described below.

ToDo...
    Brings up the to-do editor, described below.

Properties...
    Brings up the properties dialog for appointments and to-do entries. This item is for properties of calendar data entities. For properties of the dtcm application, 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...
    Brings up the Appointment List dialog.

ToDo List...
    Brings up the ToDo List dialog.

Find...
    Brings up the Find dislog, which you can use to locate calendar entries by specifying some search criteria.

Go to Date...
    Brings up the Go to Date dialog, which allows you to 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...
    Brings up 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...
    Brings up the Compare Calendars dialog, described below.

Menu Editor...
    Brings up a dialog that allows you to add frequently used calendars to the Browse menu for this and future sessions with dtcm.

&<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

In addition to the main window, dtcm has several secondary windows, which give you 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 your calendar, and can be exported to other users either by direct entry to their calendars, or through electronic mail. To invoke the appointment editor, select it from the Schedule menu in the main window, or double-click anywhere in the graphical calendar view.

The To Do Editor allows you to maintain a list of to-do items for your personal use. To-do entries are not visible to other dtcm users who are browsing your calendar; they are private to you. To-do entries differ from appointments in that they do not necessarily appear as scheduled events in your calendar views. If they have a Due Date associated with them, you will see that on your calendar view. The main purpose of to-do entries is to allow you to maintain a list of work items, without necessarily allocating calendar time for them. Invoke the to-do editor from by selecting it form the Schedule menu in the main window.

The Group Appointment Editor allows you to schedule an appointment on multiple calendars at once. Invoke the group appointment editor by clicking Schedule in the Compare Calendars window. You may optionally announce the appointment over electronic mail.

The Compare Calendars window allows you to connect to several calendars simultaneously, and get a graphical overview of busy and available time in the resultant "virtual calendar". Invoke the compare calendars window by selecting it from the Browse menu in the main window.

The Print Setup Box window allows you to select the report type to use for the currently selected view. In addition to selecting the view information, you can set a number of generic and printer-specific printing options. For example, you can send the output to a file or a printer. In the case of printed output, you can specify how many copies you want. You can also access another window to set options specific to the printer/spooler you are using. For example, you can select paper size, one- or two-sided printing, and email notification on completion of the print job.

The Options window, accessible from the File menu, gives you access to the dtcm options that you can configure. There are several categories of options: Editor Defaults; Display Settings; Access List and Permissions; Printer Settings; Date Format. Set the options to suit your requirements, and save them by clicking Apply.

RESOURCES

dtcm supports a number of application resources to allow you to configure its behaviour. The application class name for dtcm is Dtcm. To set application resources, you can copy the system default version of this file from /usr/pkg/dt/app-defaults/&<LANG>/Dtcm to a personal version, typically ~/app-defaults/Dtcm, and edit it with your changes. Following is the list of supported resources and their default values.
Application Resources
NameClassTypeDefault
labelFontLabelFontXmRFontList(varies)
viewFontViewFontXmRFontList(varies)
bold FontBoldFontXmRFontList(varies)
iconFontIconFontXmRFontList-dt-application-bold-r-normal-sans
applicationFontFamilyApplicationFontFamilyXmRXmStringapplication

dtcm*labelFont
    Specifies the font to use for the labels in the calendar's views.

dtcm*viewFont
    Specifies the font to use for the text of the appointments in the calendar's views.

dtcm*boldFont
    Specifies the font to use for the time ranges in the week view.

dtcm*iconFont
    Specifies the icon font.

dtcm*applicationFontFamily
    Specifies the font family name to use for the text of the appointments in the calendar's views. A font is used with this family name and an appropriate size to match the system font size chosen via dtstyle. dtcm*viewFont and dtcm*boldFont have a higher precedent than dtcm*applicationFontFamily.

FILES

/usr/pkg/dt/bin/dtcm
    This is the executable for dtcm.

/usr/pkg/dt/app-defaults/&<LANG>/Dtcm
    This is the system-default application defaults file for dtcm.

/usr/pkg/dt/bin/rpc/cmsd
    This is the calendar daemon (server) that manages calendars on a machine.

/var/spool/calendar/callog.&<user>
    This is the persistent calendar database for a user on this machine.