listing for D
dxcaltodtcm - Converts a DECwindows Calendar (dxcalendar) database for use
with CDE Calendar (dtcm)
The dxcaltodtcm command converts a DECwindows calendar database file that
has been created with dxcalendar -migrate into a database file that can be
used by the CDE calendar, dtcm.
Converting a DECwindows Calendar database is a three-step process. First,
you have to have invoked dxcalendar and included the -migrate switch. This
operation created the text file $HOME/dwc_db_migration.data of calendar
entries. Second, run CDE Calendar and set the hour display to 12. Finally,
run dxcaltodtcm to read this text file and add the entries to the CDE
calendar. dxcaltodtcm is in /usr/dt/bin.
Because some features of the DECwindows Calendar are not available in the
CDE Calendar, some loss of information is possible in converting a calendar
Day Note entries, if present in a DECwindows Calendar, will be lost on
Some DECwindows Calendar repeat options are unavailable in the CDE
Calendar. Entries that repeat every two, three, four, or six months in a
DECwindows Calendar will be lost upon conversion. No warning is issued.
The following monthly repeat features are unavailable in CDE Calendar.
When a DECwindows Calendar database with such monthly repeats is converted,
only the first repeat entry in the date range is converted correctly.
· N days before month end
· on the 1st <Weekday> >=(N-6, N-6+1,...,or N)
· on the 1st <Weekday> <=(N, N+1, N+2,...,or N+6)
Two examples illustrate the results of converting such monthly repeats:
· A dxcalendar entry is set to repeat five days before the end of each
month, and that date falls on the 25th in the first month converted.
After conversion, the repeat entries are on the 25th of subsequent
months in the CDE Calendar.
· A repeat is set for the first Monday >= 8. After conversion, the
repeat entries fall on the first Monday of the month regardless of
To convert a DECwindows Calendar database for use with CDE Calendar you
must have /usr/dt/bin in your PATH. To do the conversion:
1. Run dxcalendar on the command line as follows:
dxcalendar [calname] -migrate start_date end_date
The optional calname is the name of the user's calendar database file
and only needs to be entered if it is different from the default:
The variables start_date and end_date are the starting and ending
dates of the period for which the DECwindows Calendar entries are
migrated. The format for start_date and end_date is dd-mmm-yyyy (for
The dxcalendar command is available only on versions of Tru64 UNIX
earlier than Version 5.0.
2. Start CDE Calendar (dtcm). From the File pull-down menu, select
Options. The Calendar-Properties dialog box appears. From the
Category options menu, select Display Settings. Set the Hour Display
to 12 Hour by turning on its radio button. Click on the Apply button.
3. Run dxcaltodtcm.
This completes the conversion of the calendar database. You may now delete
the text file $HOME/dwc_db_migration.data. To see the converted database,
run CDE calendar (/usr/dt/bin/dtcm).
The default dxcalendar database file. This file is converted by default
if no calendar file is specified when dxcalendar is run with the
A temporary file that is created during calendar conversion and which
may be deleted after conversion is completed.
listing for D