CONTROLR step

The CONTROLR step JCL is listed in Figure 5.

Figure 5 CONTROLR Step JCL

//CONTROLR PROC ARCHF=NULLFILE,PRM=

//CONTROLR EXEC PGM=CTRCTR,PARM='&PRM'

//STEPLIB DD DSN=IOA.PROD.LOAD,DISP=SHR

//DAARCH DD DISP=SHR,DSN=&ARCHF

//DACTRCTL DD DSN=CTR.PROD.CTR.PARM,DISP=SHR

//SYSPRINT DD SYSOUT=*

//DATRACE DD SYSOUT=*

//CDAMSNAP DD SYSOUT=*

//SYSABEND DD SYSOUT=*

//DASTAT DD DISP SHR=SHR,DSN=&STATFIL

//DALIST DD SYSOUT=*

Files referenced by CONTROLR step DD statements are described in Table 26.

Table 26 Files Referenced by CONTROLR Step DD Statements

File	Description
DAARCH	Relevant only for restarts For a non-NJE job (meaning, the system in which Control-M processes the job for submission is not a node in an NJE network, and the job is not sent to another node for execution), this data set contains a set of pointers to the archived SYSDATA. For an NJE job (meaning the job is sent to another node for execution), this file contains the actual SYSDATA of all the previous runs of this job.
DACTRCTL	Control-M/Restart PARM library, which contains control parameter members. A concatenation of libraries can be specified. Control-M/Restart checks the library for the $DEFAULT member. The member, if it exists, contains control parameters that apply to all jobs. Control-M/Restart retrieves these processing control parameters (and prints the contents of the member to make known the defaults being used). Regardless of whether the $DEFAULT member was found, Control-M/Restart then checks the library for a local member for the job (that is, a member with the same name as the job). If a local member for the job is found, Control-M/Restart retrieves control parameter instructions from that member (and prints the contents of the member). If the same parameters exist in both the $DEFAULT member and the local member, the values in the local member supersede the values in the $DEFAULT member. Control parameters that can be defined in the Control-M/Restart PARM library are described in Control parameters in the Control-M/Restart PARM library.
SYSPRINT	File or printer to which messages and reports of the CONTROLR step are written
DATRACE	File or printer to which debugging messages are written if problems are encountered in the CONTROLR step. If necessary, BMC Customer Support can provide instructions on how to activate debugging messages.
CDAMSNAP	File or printer to which error messages are written if the CONTROLR step encounters a problem in dynamically allocating the archived (compressed) SYSDATA of the previous runs of the restarted job
DASTAT	Control-M Statistics file, which is used to hold statistics needed by the Data Set Cross-reference facility
DALIST	File containing the list of data sets. The list is generated by the Control-M/Restart Data Set Cross-reference utility.

Note the following points about the CONTROLR step:

for Restarts
- The CONTROLR step is inserted as the first step of the job to be restarted. Information is inserted in the PARM operand of the CONTROLR step describing how the job is to be restarted (from step, to step, and so on).
- If the job is sent to another node for execution, then for proper analysis of the job, the output must return to the submitting node.
for Data Set Cleanup
- If the NCAT2 parameter in the CTRPARM member in the IOA PARM library is set to YES, Control-M/Restart performs data set cleanup for original job runs. The CONTROLR step deletes and uncatalogs the old data sets, unless the data set name is specified in an EXCLUDE DSN statement in a member in the Control-M/Restart PARM library. This prevents DUPLICATE DATASET ON VOLUME and NOT CATLGD 2 errors.
- The PREVENT-NCT2 parameter in the Control-M job scheduling definition overrides the site-defined default in the NCAT2 parameter.
- For data set cleanup of non-rerun and non-restarted jobs, the CONTROLR step is inserted as the first step in the job stream and the edited job JCL is submitted. The CONTROLR step performs the necessary data set cleanup (including step adjustment, if necessary) and then stops. No further job steps are executed.

Parent Topic

The CONTROLR Step and Control Parameters