The CTMUTIL Utility

This appendix describes 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 Control-M utility. For a detailed description of these utilities, see the INCONTROL for z/OS Administrator Guideand the Control-M for z/OS User Guide.

In JOB3, the CTMUTIL utility replaces the OPC OPCBATCH and EQQEVPGM steps in the converted OPC JCL libraries. It provides the equivalent functionality.

The CTMUTIL utility invokes the IOAAPI utility to replace the OPC SRSTAT commands by adding or deleting conditions from the IOA Conditions file, using the commands

  • COND ADD conditionName ODAT

  • COND DELETE conditionName ODAT

The CTMUTIL utility invokes the CTMAPI utility to replace the OPC OPSTAT commands to force jobs into ended OK status, using the command

AJF FORCEOK MEM=job-name

To invoke the CTMUTIL utility program, you need to set up a JCL procedure with the procedure name CTMUTIL. The procedure must include the following DD statements:

  • STEPLIB (IOA LOAD library)

  • DAPARM (IOA PARM library)

  • SYSPRINT

  • DAPRINT

  • DAAPIOUT

  • DALOG

  • DACNDF

  • SYSIN or DAAPIPRM (optional)

You can determine the files to which these DD statements refer directly from the existing Control-M IOAAPI and CTMAPI procedures, which can be found in the IOA PROCLIB library.

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