dtcm(1X)

dtcm - The CDE Calendar Manager.

As shipped in IRIX 6.5.30. Added in IRIX 6.5.19.

     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

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

               Print...  Brings up a print dialog that allows you to
                         specify what 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.

          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.

               Time Zone...
                         Brings up the Time Zone dialog, which allows
                         you to set the Calendar time.

          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 by selecting it from
          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 Dtcm.  To set application resources, you can copy
          the system default version of this file from /usr/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                      ||
       ||  Name             Class            Type            Default    ||
       ||  (TBS)                                                        ||
       ||_______________________________________________________________||

     FILES
          /usr/dt/bin/dtcm    This is the executable for dtcm.
          /usr/dt/app-defaults/<LANG>/Dtcm
                              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.