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 utility, the IOATEST IOA utility, and the CTMAPI Control-M utility. For a detailed description of these utilities, see the INCONTROL for z/OS Administrator Guide, the INCONTROL for z/OS Utilities Guide, and the Control-M for z/OS User Guide.

In JOB5, the CTMUTIL utility replaces the CA-Scheduler CAJUCMD0 steps in the converted CA-Scheduler JCL libraries. It provides the equivalent functionality.

The CTMUTIL utility invokes the IOAAPI utility to replace the CA-Scheduler SET GBL commands by adding conditions to the IOA Conditions file, using the following command:
COND ADD conditionName date-reference

The CTMUTIL utility invokes the IOATEST utility to replace the CA-Scheduler MO msg-text and SC SENDMSG commands by issuing WTO console message, using the following command:
WTO=msg-text

The CTMUTIL utility invokes the CTMAPI utility to replace the CA-Scheduler commands that order jobs or tables to the AJF and issue various actions on the AJF (for details, see 62. CAJUCMD0 utility) using the following commands:

  • ORDER DD=DMD MEM=xxxxx JOB=yyyyy FORCE

  • AJF cmd-type 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

  • DMD (pointing to a scheduling definition library)

  • SYSIN or DAAPIPRM (optional)

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

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