The configuration migration and maintenance utility

CACCFGUT, the configuration migration, and maintenance utility, is used as an IBM z/OS batch process to manage IMS Remote Source log reader setups.

This application can be used only when the IMS Remote Source address space is not active. This tool accepts control card input with the SYSIN DD command. The control cards that are listed after can be used to conduct the following actions:
Table 1. Control card input from the SYSIN DD statement
Control Card Action
IMPORT

Runs a set of configuration instructions to populate or update an existing configuration with new/updated/existing configuration parameter values.

The IMPORT command format is as follows:
  • IMPORT,CONFIG,FILENAME=DDN:DD-Name(Member-Name)
  • IMPORT,CONFIG,FILENAME=DSN:Data-Set-Name(Member-Name)
Where:
  • DD-Name refers to the name of a DD in the JCL that contains the commands to be run, or the name of a partitioned or PDS/E data set.
  • Dataset-Name specifies the name of the dataset that contains the instructions to be run, and the name of a partitioned or PDS/E dataset.

When DD-Name or Dataset-Name refers to a partitioned or PDS/E dataset, a Member-Name must be given where the configuration commands to be processed are stored.

For example, the installation/customization procedure loads the initial IMS Remote Source log-reader configuration settings by using the following DDN reference:IMPORT,CONFIG,FILENAME=DDN:IMPORTCF(CECLRXFG).
EXPORT

The existing configuration definition is written out as a series of configuration commands to a sequential dataset or portioned dataset (or PDS/E) member. The output can then be referenced with an IMPORT statement to create a new configuration definition.

Use the EXPORT command to produce a backup copy of your IMS Remote Source log-reader configuration settings and put them under source code control. This process helps you to reconstruct your configuration definition if the binary configuration files are removed or corrupted.

The EXPORT command uses the same format as the IMPORT command:
  • EXPORT,CONFIG,FILENAME=DDN:DD-Name(Member-Name)
  • EXPORT,CONFIG,FILENAME=DSN:Data-Set-Name(Member-Name)
Where:
  • DD-Name refers to the name of a DD in the JCL that contains the commands to be run, or the name of a partitioned or PDS/E data set.
  • Dataset-Name specifies the name of the dataset that contains the instructions to be run, and the name of a partitioned or PDS/E dataset.

When DD-Name or Dataset-Name refers to a partitioned or PDS/E dataset, a Member-Name must be given for the configuration procedures.
REPORT Reports on the contents of the binary configuration file. The format of the reported output is the same as that displayed when the DISPLAY,CONFIG,ALL z/OS change command is run.