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

dxcaltodtcm(1)
NAME
  dxcaltodtcm - Converts a DECwindows Calendar (dxcalendar) database for use
  with CDE Calendar (dtcm)

SYNOPSIS
  dxcaltodtcm

DESCRIPTION
  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,
  invoke dxcalendar using the -migrate switch. This creates a 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. dxcalendar is in /usr/bin/X11
  and dxcaltodtcm is in /usr/dt/bin.

RESTRICTIONS
  Because some features of the DECwindows Calendar are not available in the
  CDE Calendar, some loss of information is possible in converting a calendar
  database.

  Day Note entries, if present in a DECwindows Calendar, will be lost on
  conversion.

  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
       date.




EXAMPLES
  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:
       $HOME/.dxcalendar.dwc.

       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
       example, 22-DEC-1994).

   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).

FILES
  $HOME/.dxcalendar.dwc
	     The default dxcalendar database file. This file is converted by
	     default if no calendar file is specified when dxcalendar is run
	     with the -migrate flag.

  $HOME/dwc_db_migration.data
	     A temporary file that is created during calendar conversion and
	     which may be deleted after conversion is completed.

RELATED INFORMATION
  Commands: dxcalendar(1X), dtcm(1).