XCOMUTIL History Migration

Modifications to the format of the VSAM history file cluster have been implemented for Release 11.6. This will require either defining a new VSAM history file cluster or migrating an existing one. The XCOMUTIL History File utility has been modified to perform a conversion of an existing release 11.5 VSAM history file cluster to the new 11.6 format. For more details refer to the CA XCOM Data Transport User Guide for the description of the XCOMUTIL utility. The format changes implemented for release 11.6 are as follows:

The maximum length of the history record has been increased to 3030 bytes from 2020 in previous releases to allow for recording of additional transfer information.
The alternate indexes have been made unique and will use the same date and time values as are in the primary key to enforce the uniqueness.
A new unique alternate index based on the TCP/IP name has been added.

To use an existing VSAM history file from the 11.5 release in 11.6, this migration utility must be performed to create a new format history file. Unpredictable results will occur when using an 11.5 format VSAM history file with 11.6.

This section contains the following topics:

New and Changed Parameters

New and Changed Messages

New and Changed Parameters

This section describes the new and modified parameter values allowed by the XCOMUTIL utility for performing VSAM history file migration in support of the 11.6 release.

PROCESS

A value of HISTORY_MIGRATION may be specified to invoke conversion of an existing VSAM history file from release 11.5 format to 11.6 format, and vice-versa.

RELEASE

This new parameter allows for specifying which release of CA XCOM Data Transport to convert the VSAM history file. Valid values are 11.5 and 11.6.

AGE

There are no changes to this parameter. This parameter can optionally be specified for history migration to remove old history records from the new format history file.

DATE

There are no changes to this parameter. This parameter can optionally be specified for history migration to remove old history records from the new format history file.

New and Changed Messages

This section describes the new and changed messages to support this enhancement.

Messages XCOMM8002E, XCOMM8005E, XCOMM8008E and XCOMM8010E have been modified to include new parameters added for the migration function. New messages for the migration function are XCOMM8018E, XCOMM8019E and XCOMM8020E. In addition, message XCOMM8017E was previously undocumented and is relevant for both the purge and migration functions.