Control file utility

This section introduces the facilities provided by the Control File utility.

The utility

The utility is installed with the name DTMCFMUn, where n represents the latest version number for ThruPut Manager. For batch processing, you need the JCL described below.

To run DTMCFMUn under ISPF, you must copy the panels and messages from the ThruPut Manager install library to your ISPF panel and message libraries.

Running the control file utility

The Control File utility can be used:

To copy the file to another area on disk, or device type.
To produce a formatted dump.
To analyze and repair the JBS and JLS control areas of the file.

For the copy function, you should allocate space for the new Control File. You can use any standard allocation technique. 8 cylinders are needed for both 3380 and 3390 devices. It should be on a cylinder boundary and on a device that provides good to excellent service times.

To run DTMCFMUn you need the following JCL:

JCL to copy the control file

//name EXEC PGM=DTMCFMUn,PARM=COPY
//SYSPRINT DD SYSOUT=*
//DTMRMCF DD DSN=name.of.the.control.file,DISP=SHR
//NEWRMCF DD DSN=name.of.the.new.file,DISP=OLD

JCL to dump the control file

//name EXEC PGM=DTMCFMUn,PARM=DUMP
//SYSPRINT DD SYSOUT=*
//DTMRMCF DD DSN=name.of.the.control.file,DISP=SHR
//DTMDUMP DD SYSOUT=*

JCL to dump and copy the control file

//name EXEC PGM=DTMCFMUn,PARM=SYSIN
//SYSPRINT DD SYSOUT=*
//DTMRMCF DD DSN=name.of.the.control.file,DISP=SHR
//NEWRMCF DD DSN=name.of.the.new.file,DISP=OLD
//DTMDUMP DD SYSOUT=*
//SYSIN DD * DUMP
COPY
/*

Moving the control file (3380/3390 Devices)

The Control File Manager uses area sizes and boundaries optimized either for a 3380 or a 3390 device, depending on the allocation.

Note: To move the Control File to another area or another device you must use the Control File Utility DTMCFMUn.

Note: The Control File must not be moved to a DASD volume that is required by JES2 during initialization.

Analyzing and repairing JBS and JLS control areas

If you suspect problems with the JBS or JLS control areas, or if you have encountered message DTM6603E, you can use DTMCFMUn to analyze and perhaps repair the damage. To do this, use one of the following PARMs on the EXEC statement:

ANALYZE

This parameter requests an analysis of the JBS and JLS areas of the Control File, and produces a report that is directed to the data set described by the DD statement DTMRMUP.

REPAIR

This parameter performs the same functions as ANALYZE, and also writes a repaired copy of the Control File to a pre-allocated data set described by the DD statement NEWRMCF.

Note that if the REPAIR function terminates successfully, the resulting Control File will not contain errors, but information about some jobs might be lost. Examine the analysis report to determine which jobs might be affected.

Sample JCL to analyze and repair the control file

Sample JCL to analyze and repair the Control File is shown below.

JCL to analyze the Control File

//name EXEC PGM=DTMCFMUn,PARM=ANALYZE
//SYSPRINT DD SYSOUT=*
//DTMRMCF DD DSN=name.of.the.control.file,DISP=SHR
//DTMDUMP DD SYSOUT=*

JCL to repair the Control File

//name EXEC PGM=DTMCFMUn,PARM=REPAIR
//SYSPRINT DD SYSOUT=*
//DTMRMCF DD DSN=name.of.the.control.file,DISP=SHR
//NEWRMCF DD DSN=name.of.the.new.file,DISP=OLD
//DTMRMUP DD SYSOUT=*