sdtcm_convert

Usesdtcm_convert to convert Calendar data format, prune a calendar, or check data integrity. Use it to convert version 3 (OpenWindows) calendar data format to version 4 (the extensible calendar data format), and vice versa.

sdtcm_convert is automatically invoked when performing an OS upgrade to 2.6.

sdtcm_convert must be run by superuser or the owner of the calendar. Superuser can run sdtcm_convert on any calendar; a regular user can only run sdtcm_convert on his or her own calendar. Note that sdtcm_convert can be used only on calendars located on the local host.

The version 3 data format is fixed and limited. In order to take advantage of the new features supported by the calendar API, version 3 calendars should be converted to the version 4 data format.

OpenWindows Calendar Manager does not support the version 4 data format. If you need to switch back to OpenWindows Calendar Manager and you have a version 4 calendar, you should convert your calendar to the version 3 data format before switching the server. Be aware, however, that data not supported in the version 3 data format (for example, all calendar attributes except the access list, entry attributes such as date of creation or date of last update, and so on) will be lost.

Options for sdtcm_convert are listed and described below.

• Use the -v option to specify the data version of output.

  Valid values are 3 (OpenWindows calendar data format) and 4 (the extensible data format). If this option is not specified, the output data version is the same as that of the specified calendar and no data conversion is done.

The data version of a calendar is displayed in the About Calendar dialog box of Calendar, accessible from the Help menu.

• Use the -s option to specify the date to prune the calendar.

  Appointments starting before the specified date are pruned. One-time appointments with a start date on or after the specified date are included. Repeating appointments are truncated such that the first appointment in the sequence will happen on or after the specified date and those sequences that end before the specified date are removed. If this option is not specified, no appointments are pruned.

• Use the -c option to specify the value for the character set attribute.

  The value should be a valid Sun-specific locale name (C or de, for example). The CDE platform-independent equivalent of the locale name is stored in the calendar. If this option is not specified, the CDE platform-independent name of the current locale associated with the process is used. This option is used when converting version 3 data to version 4 data and is ignored otherwise.

• Use the -d option to specify the directory in which to save the original calendar file which is saved in a filed called calorig.calendar.

  If this option is not specified, the backup file is placed in the /var/spool/calendar directory.

  See the sdtcm_convert(1) man page for more details and examples of usage.

Examples

To convert the calendar user1 to version 4 data format and also prune the calendar:

% sdtcm_convert -v 4 -s 1/1/94 user1

To check data integrity of the calendar user1:

% sdtcm_convert user1

If no option is specified, sdtcm_convert will check the calendar file for data integrity.