The CTMUTIL Utility

This section details the Control-M CTMUTIL utility program, which the conversion tool uses to replace CA-7 Batch Terminal Input steps. This utility is independent of the conversion tool, but may be required 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 JOB4, the CTMUTIL utility replaces the CA-7 Batch Terminal steps in the converted CA-7 JCL libraries. It provides the equivalent functionality.

  • The CTMUTIL utility invokes the IOACND utility to do the following:

    • Adds conditions to the IOA Conditions file, using the command ADD CONDconditionName ODAT.

    • Replaces CA-7 POST commands.

  • The CTMUTIL utility invokes the CTMAPI utility to do the following:

    • Forces jobs into the Control-M Active Jobs file, using the following command:

      CopyCopied to clipboard 
      FORCE ORDER DD=DMD MEM=* JOB=demandedJob FORCE SELTAG=schid* IGNTAG=*[SETVAR=%%CTM_PRE_SUB_WAIT=nnnnM

    • Replaces CA-7 DEMAND[H] commands (which may optionally contain a TIME=+hhmm parameter).

  • The CTMUTIL utility invokes the CTMRELRS utility to change the quantity of Quantitative resources required by a job to replace CA-7 RESCHNG commands. The command format is:

    CopyCopied to clipboard 
    CHANGE RESOURCE resourceName quantity

  • The CTMUTIL utility invokes the IOATEST utility to issue WRITE TO OPERATOR (WTO) commands, replacing the CA-7 WTO commands. The command format is:

    CopyCopied to clipboard 
    WTO=WTO-TEXT

You must set up a JCL procedure with the procedure name CTMUTI, and a procstep name of 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

  • DACNDF

  • DMD

  • SYSIN (optional)

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

The DMD DD statement must point to the job scheduling library produced in (ICE) Minor Step 12.

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