Click this button to go to the index for this section.

dtcm(1)
CDE


NAME
  dtcm - The CDE Calendar Manager.

SYNOPSIS
  dtcm [-v view ] [-c calendar ] [-p printer]

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

  Archive...
	    Creates an archive of calendar data, allowing you to 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, scaling.

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

  Print Appointment List...
	    Brings up a print dialog that allows you to choose the view of
	    the appointment list that you want to print.

  Print ToDo List...
	    Brings up a print dialog that allows you to specify what to-do
	    entries you want to print.

  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 dialog, 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 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 DtCalendar.  To set
  application resources, you can copy the system default version of this file
  from /usr/dt/app-defaults/<LANG>/DtCalendar to a personal version,
  typically ~/app-defaults/DtCalendar, and edit it with your changes.
  Following is the list of supported resources and their default values.

  Name	  Class	  Type	 Default
  ______________________________
  (TBS)
  ______________________________

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

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

  /usr/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.