The CTMUTIL Utility

This appendix details the CTMUTIL utility program, which is available with the conversion tool. This utility is independent of the conversion tool, and is not required for a successful conversion to Control-M. However, the utility may be very useful either during or after the conversion process.

The CTMUTIL utility is used to invoke the IOAAPI IOA utility, and the CTMAPI and CTMRELRS Control-M utilities. For a detailed description of these utilities, see the INCONTROL for z/OS Utilities Guide, the INCONTROL for z/OS Administrator Guide, and the Control-M for z/OS User Guide.

In JOB2, the CTMUTIL utility replaces the JOBTRAC GJTRABTR and GJTRVSCH steps in the converted JOBTRAC JCL libraries. It provides the equivalent functionality.

• The CTMUTIL utility invokes the IOACND utility to add conditions to the IOA Conditions file, using the command CONDADDconditionName ODAT.

  This replaces the JOBTRAC DEP(-Q) sub parameter of the ADD command.

• The CTMUTIL utility invokes the CTMAPI utility to treat jobs as DUMMY (by bypassing JCL processing) jobs using the command AJF BYPJCL MEM=xxx.

  This replaces the JOBTRAC PURGE commands.

• The CTMUTIL utility invokes the CTMBLT utility to order jobs into the Control-M Active Jobs file, using the command ORDER DSN=schedule-lib MEM=jobname to replace the JOBTRAC GJTRVSCH utility.

CTMBLT is also invoked to perform on-the-fly job ordering for ADD commands in the GJTRABTR utility. In such cases, the following CTMBLT control statement stream is inserted into the JCL:

MEM-OVERWRITE=FORCE
MEMLIB=&XEVTLIB (see the DEFAULTS conversion source member)
TABLE=jobname
MEMNAME=jobname
APPL=location-id (if LOC is specified in the ADD command)
GROUP=location-id (if LOC is specified in the ADD command)
IN=MANUAL_DEP_jobname (if DEP(M) is specified in the ADD command)

CTMUTIL also provides the parallel functionality of the ADD and RUN commands specified in the ADR (Automatic Dataset Recognition) and AMR (Automatic Message Recognition) reports using the command:

CREATE parm-1 parm-2 parm-3

The CREATE Command causes the CTMBLT utility to be invoked and to perform an on-the-fly job order. The following parameters are passed:

• parm-1=MEMLIB

• parm-2=MEMNAME

• parm-3=Y/N

  When parm-3=Y an IN-COND 'MANUAL-DEP_parm-2 ODAT' is added to the CTMBLT control statements.

You must set up a JCL procedure with the procedure name CTMUTIL for invoking the CTMUTIL utility program. The procedure must include the following DD statements:

• STEPLIB (IOA LOAD library)

• DAPARM (IOA PARM library)

• SYSPRINT

• DAPRINT

• DAAPIOUT

• PRTDBG (dummy)

• DALOG

• DACKPT

• DACNDF

• DACAL

• DASCHD (a Control-M Scheduling library used by CTMBLT)

• SYSIN (optional)

The files to which these DD statements refer can be determined directly from the existing Control-M IOAAPI, CTMAPI, and CTMBLT procedures, which can be found in the IOA PROCLIB library and the CTM JCL library.

SYSIN is the file containing the ADD COND, ORDER, AJF and CREATE commands. It can be coded as DDNAME=SYSIN, or it can be omitted from the procedure.

Table 23 GJTRABTR and GJTRVSCH Conversion: Summary