NAME
dtcm - the CDE Calendar Manager
SYNOPSIS
dtcm [-c calendar] [-p printer] [-v view]
DESCRIPTION
The dtcm utility is the GUI for CDE appointment and resource
scheduling. It can be used to:
o Display day, week, month, and year views of the user's
calendar
o Schedule single or repeating calendar entries
o Browse and edit another user's calendar
o Schedule reminders to give the user notice of events
o Restrict access to the user's calendar
o Print high-quality hardcopy
o View and Schedule entries for a group of calendars
o Change the time zone context
o Announce appointments via electronic mail
o Schedule appointments received in electronic mail
OPTIONS
The following options are available along with all of the
standard X Toolkit command-line options:
-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.
OPERANDS
None.
STDIN
Not used.
INPUT FILES
None.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of
dtcm:
HOME Determine the user's home directory, the
location of configuration files.
LANG Provide a default value for the interna-
tionalization variables that are unset or
null. If LANG is unset or null, the
corresponding value from the
implementation-specific default locale
will be used. If any of the internation-
alization variables contains an invalid
setting, dtcm behaves as if none of the
variables had been defined.
LC_ALL If set to a non-empty string value, over-
ride the values of all the other interna-
tionalization variables.
LC_MESSAGES Determine the locale that is used to
affect the format and contents of diagnos-
tic messages written to standard error and
informative messages written to standard
output.
NLSPATH Determine the location of message catalo-
gues for the processing of LC_MESSAGES.
XAPPLRESDIR Specify the name of a directory that con-
tains application-specific resources. If
this environment variable is defined, and
is set to an existing directory, then it
is searched (in addition to the standard
locations) for files containing
application-specific resource specifica-
tions.
XENVIRONMENT
Specify the name of a resource file with
user- or machine-specific resources. If
this variable is not defined, dtcm looks
for a file named $HOME/.Xdefaults-hostname
instead, where hostname is the name of the
host where the application is executing.
XFILESEARCHPATH
Define a language-dependent location of
app-defaults.
XMODIFIER Specify which input method to use.
XUSERFILESEARCHPATH
Control where X applications look for
their app-defaults resource files. The
default is located in the directory
/usr/dt/app-defaults. The user must set
XUSERFILESEARCHPATH if the user's resource
files are not in this location.
RESOURCES
The dtcm utility allows the user to specify behavior through
X11 resources as well as the command-line interface. The
application class name for dtcm is Dtcm. To set application
resources, the user can copy the system default version of
the file /usr/dt/app-defaults/<LANG>/Dtcm to a personal ver-
sion (typically $HOME/app-defaults/Dtcm, but the location is
dependent on the value of the XAPPLRESDIR environment vari-
able) and edit it with the appropriate changes. The follow-
ing are the supported resources and their default values:
Basic Resources
_______________________________________________________________________
Name Class Type Default
_______________________________________________________________________
labelFont LabelFont XmRFontList varies
viewFont ViewFont XmRFontList varies
boldFont BoldFont XmRFontList varies
iconFont IconFont XmRFontList -dt-application-bold-r-normal-
sans-*-180-*-*-p-*-*-*:
application- Application- XmRXmString application
FontFamily FontFamily
labelFont
Specifies the font to use for the labels in the
calendar's views.
viewFont
Specifies the font to use for the text of the
appointments in the calendar's views.
boldFont
Specifies the font to use for the time ranges in
the week view.
iconFont
Specifies the icon font.
applicationFontFamily
Specifies the font family name to use for the text
of the appointments in the calendar's views. A
font will be used with this family name and
appropriate size to match the system font size
chosen via dtstyle(1). The viewFont and boldFont
resources have a higher precedent than application-
FontFamily.
ASYNCHRONOUS EVENTS
The dtcm utility takes the standard action for all signals.
STDOUT
Not used.
STDERR
Used only for diagnostic messages.
OUTPUT FILES
None.
EXTENDED DESCRIPTION
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 appoint-
ment 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 the
user by issuing an alarm when the system time enters the
user's specified reminder notice period before the event.
When viewing the user's calendar, there is the notion of the
current date, which is the date the user last selected by
selecting the Day View, or by clicking in any of the other
views. The current date does not change until the user
selects another date, even if he or she has navigated out of
a view that would contain the current date.
The dtcm utility 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 pro-
cess running on the host where the calendar is located. It
manages all the calendars for the host on which it is run-
ning, and can service multiple connected applications simul-
taneously. 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 applica-
tion instances.
Usage
The dtcm utility has a single main window, containing a
graphical calendar. The user 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. If tooltip display is enabled then a
tooltip label is associated with each button on the calendar
toolbar. A tooltip label describes the functionality of a
button in a few words.
File Menu
Print Current View
Prints hard-copy based on the currently
displayed calendar view.
Print ...
Allows the user to specify parameters for
a print job, such as number of copies,
orientation, scaling, report type.
Options ...
Displays default options for all of dtcm's
global attributes.
Exit Terminates the dtcm application.
Edit Menu
Appointment ...
Displays the appointment editor, described
below.
ToDo ...
Displays the To Do editor, described
below.
View Menu
Day Changes the current view in the main win-
dow to Day View.
Week Changes the current view in the main win-
dow to Week View.
Month Changes the current view in the main win-
dow to Month View.
Year Changes the current view in the main win-
dow to Year View.
Appointment List ...
Displays the Appointment List dialog box.
ToDo List ...
Displays the ToDo List dialog box.
Find ...
Displays the Find dialog box, so the user
can locate calendar entries by specifying
some search criteria.
Go to Date ...
Displays the Go to Date dialog, so the
user can 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
Displays the Time Zone dialog, so the user
can set the time zone to which appointment
times are relative.
Browse Menu
Show Other Calendar ...
Displays a dialog box, in the main window,
to let the user connect to a different
calendar than the one currently displayed.
Only a single calendar is displayed at
once.
Compare Calendars ...
Displays the Compare Calendars dialog box,
described below.
Menu Editor ...
Displays a dialog box that allows the user
to add frequently used calendars to the
Browse menu for this and future sessions
with dtcm.
<user>@<host>
... This sequence of entries consists of the
user's own calendar, followed by an
optional list of calendars that the user
can add to the menu using the Menu Editor
option described above. The user's 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 the user 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 the user's calen-
dar, and can be exported to other users either by direct
entry to their calendars, or through electronic mail. To
invoke the appointment editor, the user selects it from the
Edit menu in the main window, or double-clicks anywhere in
the graphical calendar view.
The To Do Editor allows the user to maintain a list of to-do
items for his or her personal use. To-do entries are not
visible to other dtcm users who are browsing the user's
calendar; they are private to the user. To-do entries
differ from appointments in that they do not necessarily
appear as scheduled events in the user's calendar views. If
a to-do entry has a Due Date associated with it, it will be
displayed in the calendar view. The main purpose of to-do
entries is to allow the user to maintain a list of work
items, without necessarily allocating calendar time for
them. The to-do editor is invoked by selecting it from the
Edit menu in the main window.
The Group Appointment Editor allows the user to schedule an
appointment on multiple calendars at once. It is invoked by
clicking Schedule in the Compare Calendars window. The user
may optionally announce the appointment over electronic
mail.
The Compare Calendars window allows the user to connect to
several calendars simultaneously, and get a graphical over-
view of busy and available time in the resultant ``virtual
calendar.'' The compare calendars window is invoked by
selecting it from the Browse menu in the main window.
The Options window, accessible from the File menu, gives the
user access to the dtcm options that the user can configure.
There are several categories of options: Editor Defaults;
Display Settings; Access List and Permissions; Printer Set-
tings and Date Format. The user can set the options to suit
his or her requirements, and save them by clicking Apply.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
CONSEQUENCES OF ERRORS
Default.
APPLICATION USAGE
None.
FILES
/usr/dt/bin/dtcm The executable for dtcm.
/usr/dt/app-defaults/<LANG>/Dtcm
The system-default application defaults
file for dtcm.
/usr/dt/appconfig/types/<LANG>/dtcm.dt
The file of default calendar-specific
actions. See dtactionfile(4).
/usr/dt/bin/rpc/rpc.cmsd
The calendar daemon (server) that
manages calendars on a machine.
/var/spool/calendar/callog.<user>
The persistent calendar database for a
user on this machine.
EXAMPLES
None.
SEE ALSO
rpc.cmsd(1), dtcm_delete(1), dtcm_editor(1), dtcm_insert(1),
dtcm_lookup(1), tooltips(3), dtactionfile(4), X11(7).
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |