CTMJOB – Order Jobs to the Active Jobs File

The CTMJOB utility is a job ordering utility that can be invoked from a job step or by calling the program from a TSO environment and/or application program, such as batch or CICS.

Job ordering instructions are passed to CTMJOB using one of the following:

• DD statement DAJOB.

  When ordering jobs using DD statement DAJOB, job orders can be specified either

  • by concatenating tables in the JCL (Method 1)

    This method requires that the user specify the name of a table and library directly in the JCL, in the format.

    DSN=sched_library(table)

    For example

  Figure 29 DD Statement DAJOB Method 1 Example

or

• as ORDER control statements (Method 2)

Figure 30 DD Statement DAJOB Method 2, Example 1

where member contains ORDER, SELECT, IGNORE statements

Figure 31 DD Statement DAJOB Method 2, Example 2

The format of these statements is described in Format of the ORDER, SELECT, and IGNORE Statements for CTMJOB.

Method 2 provides the following advantages over Method 1:

Changes required can be made to the member in the PARM library without changing the JCL.

Individual jobs can be specified.

An entire library can be specified in one order statement.

• PARM parameter in an EXEC statement in the JCL. This method can only be used to order a single table or job. For more information, see Activating the CTMAESIM Utility.

By default, the CTMJOB utility stops running when a User Daily job discovers an error in one of the job scheduling definitions. Alternately, if your INCONTROL administrator sets the CNTERCRD parameter to Y (Yes) in the CTMPARM member of the IOA PARM library, the CTMJOB utility continues processing job scheduling definitions after an error occurs. In either case, the message JOB536S is issued. If the job scheduling definition that contains an error belongs to a SMART Table Entity or to a job belonging to a SMART Table, and the processing continues, the utility skips the entire SMART Table and continue processing the next job or SMART Table.

The CTMJOB utility can also be used to order tables with a particular ODATE (for example, to emulate a User Daily job with a specific date) by setting the target date to the desired ODATE for the jobs to be ordered. All other dates must be set for one day earlier. For more information about tables with a particular ODATE, see the discussion of alternative methods of job ordering in the Control-M chapter in the INCONTROL for z/OS Administrator Guide.