Index Index for
Section 1
Index Alphabetical
listing for D
Bottom of page Bottom of
page		 

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


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

					Note

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


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

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


SEE ALSO

  Commands: dtcm(1)

Index Index for
Section 1
Index Alphabetical
listing for D
Top of page Top of
page