Resource Definition Migration

The OSC system uses resource definition. Therefore the Resource Control Table used in a previous version of CICS must be changed to resource definition. OSC provides a tool which converts a DCT (Destination Control Table) macro and a JCT (Journal Control Table) macro to resource definition.

This chapter describes how to migrate a resource control table to resource definitions.

1. DCT Migration (oscdct2rd)

Destination Control Table (DCT) is a control table which contains TDQ information used to manage TDQ. In order to use the TDQ information contained in the DCT macro, in OSC, the user has to convert the information to a TDQUEUE resource definition. OSC converts a DCT macro to a TDQUEUE resource definition by using the oscdct2rd tool. Refer to DCT Macro (DFHDCT) for more details about the DCT macro.

The existing DCT macro does not have a setting for a resource GROUP, but a resource definition must have GROUP element. Therefore specify the resource GROUP when migrating the DCT by using one of the following methods.

  • The DCT macro defines the GROUP element in the following way. The TDQs defined between one GROUP definition and next GROUP definition are defined as the same GROUP.

    DFHDCT TYPE=GROUP,GROUP=groupname

  • When specifying one GROUP for all TDQ defined in one DDT macro, use the [–g] option of oscdct2rd instead of the previous method.

The following example uses the oscdct2rd tool to convert the file with a DCT macro described to TDQUEUE. The converted TDQUEUE resources sets GROUP to OSCGROUP. The user has to register the created resource definition in the OSC SD table by using the oscsdgen tool.

oscdct2rd –g OSCGROUP DCT.dat TDQUEUE.dat

2. JCT Migration (oscjct2rd)

Journal Control Table (JCT) is a control table that describes system log and journal log information for journal management. In order to use the journal information described in a JCT macro, in OSC, the user has to convert the information to a JOURNALMODEL resource definition. OSC converts a JCT macro to a JOURNALMODEL resource by using the oscjct2rd tool. For more information about the JCT macro, refer to JCT Macro.

The existing JCT macro does not have a resource GROUP related setting. But in the resource definition, the GROUP element must be specified. Therefore, when specifying the same GROUP for one JCT macro, use the [–g] option in oscdct2rd.

The following example converts the file with a JCT macro to JOURNALMODEL by using the oscdct2rd tool. The converted JOURNALMODEL resource sets the GROUP element to OSCGROUP. The user has to register the created resource definition in the OSC SD table by using the oscsdgen tool.

oscjct2rd –g OSCGROUP JCT.dat JOURNALMODEL.dat