ADDPROC, PROCRC and NCT2RC

(WR0166 and WR0186)

Enables Control‑M to insert an additional step in a job when restart and/or PREVENT NCT2 processing is performed for the job.

The corresponding new step is inserted between the Control‑M/Restart step (executes RESTART or PREVENT NCT2 processing) and the first step of a job itself.

The purpose of these parameters is to allow steps in a job to check different return codes, depending on whether a job has been restarted (PROCRC) or not restarted (meaning, the original run of the job, NCT2RC). The job steps do so through the JCL COND parameter, which sets the step names and return codes that the user selected using these customization parameters.

ADDPROC sets the name of the inserted step. PROCRC specifies the condition code to be generated by this step in case of restart processing. NCT2RC sets the condition code to be generated by this step in case of PREVENT NCT2 processing.

The step inserted calls the IOATEST procedure supplied in the IOA PROCLIB library. Therefore, to use this feature you must copy the IOATEST member from the IOA PROCLIB library to any active PROCLIB library known to JES.

Control‑M inserts the step by adding the following line to the JCL of a job to be submitted:

//%ADDPROC% EXEC   IOATEST,PARM=’C%PROCRC%’

for restart processing and

//%ADDPROC% EXEC   IOATEST,PARM=’C%NCT2RC%’

for PREVENT NCT2 processing.

where %ADDPROC%, %PROCRC% and %NCT2RC% are values specified for the corresponding parameters.

It is possible to specify values for ADDPROC, PROCRC, and NCT2RC, that will override the default values in CTRPARM, by adding, the following special AutoEdit variables to the corresponding Schedule Definition or at the beginning of the job JCL:

• %%ADDPROC
• %%RSTCODE
• %%NCT2CODE

1

DMSVOL

(WR0110)

Specifies the volume name used for identifying data sets migrated by DMS.

Any data set cataloged on the specified volume is assumed by Control‑M/Restart as migrated by DMS. If omitted, the volume name MIGRAT is used. If a volume name is also specified, it is used in addition to MIGRAT.

ERRORRC

(WR0054)

Specifies the condition code of the Control‑M/Restart step when it fails.

• Maximum: 999
• Default: 8

If the ABNDTYP parameter is specified as UABEND, the ERRORRC parameter specifies a user abend code of Control‑M/Restart step when it fails.

NONRSTDD

(WR0150)

Specifies the DD name used for identifying a non-restartable step.

If the step has a DD statement with this name, Control‑M/Restart cannot use the corresponding step as a first step for restart of a job.

If omitted, the DD names CTRNORST and UCC11NR are used.

If a DD name is specified, that name is used in addition to CTRNORST and UCC11NR.