418 lines
17 KiB
Plaintext
418 lines
17 KiB
Plaintext
<!-- $XConsortium: cm.sgm /main/11 1996/09/08 19:50:10 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
<refentry id="CDEMX.MAN5.rsml.1">
|
|
<refmeta><refentrytitle>dtcm</refentrytitle><manvolnum>user cmd</manvolnum>
|
|
</refmeta>
|
|
<refnamediv><refname><command>dtcm</command></refname><refpurpose>The CDE
|
|
Calendar Manager.</refpurpose></refnamediv>
|
|
<!-- (c) Copyright 1993, 1994 Hewlett-Packard Company-->
|
|
<!-- (c) Copyright 1993, 1994 International Business Machines Corp.-->
|
|
<!-- (c) Copyright 1993, 1994 Sun Microsystems, Inc.-->
|
|
<!-- (c) Copyright 1993, 1994 Novell, Inc.-->
|
|
<!-- t-->
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>dtcm</command><arg choice="opt">-v<replaceable>view</replaceable></arg>
|
|
<arg choice="opt">-c<replaceable>calendar</replaceable></arg><arg choice="opt">-p<replaceable>printer</replaceable></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
<para><command>dtcm</command> is the CDE appointment and resource scheduling
|
|
tool. Use it to:</para>
|
|
<!--Start of RS / RE range-->
|
|
<para>- Display day, week, month, and year views of your calendar</para>
|
|
<para>- Schedule single or repeating calendar entries</para>
|
|
<para>- Browse and edit another user's calendar</para>
|
|
<para>- Schedule reminders to give you notice of events</para>
|
|
<para>- Restrict access to your calendar</para>
|
|
<para>- Print high-quality hardcopy</para>
|
|
<para>- View and Schedule entries for a group of calendars</para>
|
|
<para>- Change the time zone context</para>
|
|
<para>- Announce appointments via electronic mail</para>
|
|
<para>- Schedule appointments received in electronic mail</para>
|
|
<!--End of RS / RE range-->
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
<para><command>dtcm</command> accepts all of the standard X Toolkit command
|
|
line options as well as the following:</para>
|
|
<variablelist>
|
|
<varlistentry><term>-c calendar</term>
|
|
<listitem>
|
|
<para>Specifies the calendar to display. The default value is equivalent
|
|
to $USER@$HOST.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>-p printer</term>
|
|
<listitem>
|
|
<para>Specifies the default printer. The default is the system's default
|
|
printer.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>-v view</term>
|
|
<listitem>
|
|
<para>Specifies the initial view. Values can be "day", "week", "month" or
|
|
"year".</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>CONCEPTS</title>
|
|
<para>A <emphasis>calendar</emphasis> is a persistent entity existing somewhere
|
|
on the network, which contains scheduling data for a <emphasis>user</emphasis>.
|
|
A <emphasis>calendar entry</emphasis> is an event recorded within the context
|
|
of a calendar. Calendar entries supported by dtcm are <emphasis>appointment</emphasis> and <emphasis>to-do</emphasis>. Calendar entries can be <emphasis>single</emphasis>, or <emphasis>repeat</emphasis> entries. A calendar entry
|
|
may have one or more <emphasis>reminders</emphasis> associated with it. A
|
|
reminder causes dtcm to notify you by issuing an <emphasis>alarm</emphasis>
|
|
when the system time enters your specified <emphasis>reminder notice period</emphasis> before the event. When viewing your calendar, you have the notion
|
|
of the <emphasis>current date</emphasis>, 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.</para>
|
|
<para>dtcm presents a <emphasis>network calendar model</emphasis>. To operate
|
|
on a calendar belonging to some user on the network, dtcm establishes a session
|
|
with a <emphasis>calendar server</emphasis>. 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.</para>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>USAGE</title>
|
|
<para>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 <emphasis>View</emphasis> menu, or by clicking one of the navigation buttons displayed in
|
|
the current view.</para>
|
|
<para><literal>Menu</literal> <literal>Bar</literal></para>
|
|
<para><literal>File</literal> <literal>Menu</literal></para>
|
|
<variablelist>
|
|
<varlistentry><term>Print Current View</term>
|
|
<listitem>
|
|
<para>Prints hard-copy based on the currently displayed calendar view.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Print...</term>
|
|
<listitem>
|
|
<para>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 <literal>More...</literal> button.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Options...</term>
|
|
<listitem>
|
|
<para>Brings up default options for all of dtcm's global attributes.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Exit</term>
|
|
<listitem>
|
|
<para>Terminates the dtcm application.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><symbol role="Message">Edit</symbol> <literal>Menu</literal></para>
|
|
<variablelist>
|
|
<varlistentry><term>Appointment...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the appointment editor, described below.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>ToDo...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the to-do editor, described below.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Properties...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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 <emphasis>Properties...</emphasis> entry in
|
|
the <emphasis>File</emphasis> menu.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><literal>View</literal> <literal>Menu</literal></para>
|
|
<variablelist>
|
|
<varlistentry><term>Day</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Changes the current view in the main window to Day View.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Week</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Changes the current view in the main window to Week View.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Month</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Changes the current view in the main window to Month View.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Year</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Changes the current view in the main window to Year View.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Appointment List...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the <emphasis>Appointment List</emphasis> dialog.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>ToDo List...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the <emphasis>ToDo List</emphasis> dialog.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Find...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the <emphasis>Find</emphasis> dislog, which you can use to
|
|
locate calendar entries by specifying some search criteria.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Go to Date...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the <emphasis>Go to Date</emphasis> 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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><literal>Browse</literal> <literal>Menu</literal></para>
|
|
<variablelist>
|
|
<varlistentry><term>Show Other Calendar...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Compare Calendars...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up the <emphasis>Compare Calendars</emphasis> dialog, described
|
|
below.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>Menu Editor...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>Brings up a dialog that allows you to add frequently used calendars
|
|
to the <emphasis>Browse</emphasis> menu for this and future sessions with
|
|
dtcm.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term><user>@<host></term>
|
|
<listitem>
|
|
<para></para>
|
|
<!-- ex-TP-->
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>...</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>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 <emphasis>Menu Editor...</emphasis> option described above. Your own calendar always
|
|
appears first. The other options are listed in alphabetical order.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<para><literal>Secondary</literal> <literal>Windows</literal></para>
|
|
<para>In addition to the main window, dtcm has several secondary windows,
|
|
which give you access to the scheduling and browsing features of dtcm.</para>
|
|
<para>The <emphasis>Appointment Editor</emphasis> 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 <emphasis>Schedule</emphasis>
|
|
menu in the main window, or double-click anywhere in the graphical calendar
|
|
view.</para>
|
|
<para>The <emphasis>To Do Editor</emphasis> 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 <emphasis>Due Date</emphasis> 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 <emphasis>Schedule</emphasis> menu
|
|
in the main window.</para>
|
|
<para>The <emphasis>Group Appointment Editor</emphasis> allows you to schedule
|
|
an appointment on multiple calendars at once. Invoke the group appointment
|
|
editor by clicking <emphasis>Schedule</emphasis> in the <emphasis>Compare
|
|
Calendars</emphasis> window. You may optionally announce the appointment
|
|
over electronic mail.</para>
|
|
<para>The <emphasis>Compare Calendars</emphasis> 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 <emphasis>Browse</emphasis> menu
|
|
in the main window.</para>
|
|
<para>The <emphasis>Print Setup Box</emphasis> 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.</para>
|
|
<para>The <emphasis>Options</emphasis> window, accessible from the <emphasis>File</emphasis> 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 <emphasis>Apply</emphasis>.
|
|
</para>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>RESOURCES</title>
|
|
<para>dtcm supports a number of application resources to allow you to configure
|
|
its behaviour. The application class name for dtcm is <emphasis>Dtcm</emphasis>. 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.</para>
|
|
<informaltable remap="center" orient="port">
|
|
<tgroup cols="4" colsep="0" rowsep="0">
|
|
<colspec align="left" colname="col1" colwidth="121*">
|
|
<colspec align="left" colname="col2" colwidth="120*">
|
|
<colspec align="left" colwidth="106*">
|
|
<colspec align="left" colwidth="109*">
|
|
<spanspec nameend="col2" namest="col1" spanname="1to2">
|
|
<tbody>
|
|
<row>
|
|
<entry align="left" spanname="1to2" valign="top"><literal>Application Resources</literal></entry></row>
|
|
<row>
|
|
<entry align="left" valign="top">Name</entry>
|
|
<entry align="left" valign="top">Class</entry>
|
|
<entry align="left" valign="top">Type</entry>
|
|
<entry align="left" valign="top">Default</entry></row>
|
|
<row>
|
|
<entry align="left" valign="top">labelFont</entry>
|
|
<entry align="left" valign="top">LabelFont</entry>
|
|
<entry align="left" valign="top">XmRFontList</entry>
|
|
<entry align="left" valign="top">(varies)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top">viewFont</entry>
|
|
<entry align="left" valign="top">ViewFont</entry>
|
|
<entry align="left" valign="top">XmRFontList</entry>
|
|
<entry align="left" valign="top">(varies)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top">bold Font</entry>
|
|
<entry align="left" valign="top">BoldFont</entry>
|
|
<entry align="left" valign="top">XmRFontList</entry>
|
|
<entry align="left" valign="top">(varies)</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top">iconFont</entry>
|
|
<entry align="left" valign="top">IconFont</entry>
|
|
<entry align="left" valign="top">XmRFontList</entry>
|
|
<entry align="left" valign="top">-dt-application-bold-r-normal-sans</entry>
|
|
</row>
|
|
<row>
|
|
<entry align="left" valign="top">applicationFontFamily</entry>
|
|
<entry align="left" valign="top">ApplicationFontFamily</entry>
|
|
<entry align="left" valign="top">XmRXmString</entry>
|
|
<entry align="left" valign="top">application</entry>
|
|
</row>
|
|
</tbody></tgroup></informaltable>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>dtcm*labelFont</term>
|
|
<listitem>
|
|
<para>Specifies the font to use for the labels in the calendar's views.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>dtcm*viewFont</term>
|
|
<listitem>
|
|
<para>Specifies the font to use for the text of the appointments in the calendar's views.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>dtcm*boldFont</term>
|
|
<listitem>
|
|
<para>Specifies the font to use for the time ranges in the week view.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>dtcm*iconFont</term>
|
|
<listitem>
|
|
<para>Specifies the icon font.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>dtcm*applicationFontFamily</term>
|
|
<listitem>
|
|
<para>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
|
|
<literal>dtstyle</literal>.
|
|
<Systemitem class="resource">dtcm*viewFont</systemitem>
|
|
and
|
|
<Systemitem class="resource">dtcm*boldFont</systemitem>
|
|
have a higher precedent than
|
|
<Systemitem class="resource">dtcm*applicationFontFamily</systemitem>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>FILES</title>
|
|
<variablelist>
|
|
<varlistentry><term>/usr/dt/bin/dtcm</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This is the executable for dtcm.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/usr/dt/app-defaults/<LANG>/Dtcm</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This is the system-default application defaults file for dtcm.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/usr/dt/bin/rpc/cmsd</term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This is the calendar daemon (server) that manages calendars on a machine.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry><term>/var/spool/calendar/callog.<user></term>
|
|
<listitem>
|
|
<!-- ex-TP-->
|
|
<para>This is the persistent calendar database for a user on this machine.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
</refentry>
|
|
<!--fickle 1.12 mancsf-to-docbook 1.3 08/21/95 21:30:04-->
|
|
<?Pub *0000016276>
|