Parameters of the Control-M/Restart Dataset Cleanup facility

To activate the utility, fill in the parameters, type YES in the last field of the screen, and press ENTER.

Depending on the desired mode, specify either JCL Library mode or Scheduling Library mode parameters, but not both.

Table 16 Control-M/Restart Data Set Cleanup Facility Modes

Mode	Description
OPERATION MODE	Mode in which the Control-M/Restart Data Set Cleanup Facility must operate. Valid values: J (JCL Library mode) or S (Scheduling Library mode). Mandatory.
TRACE MODE	Diagnostic tool that allows debugging in Control-M/Restart. Optional. Note: Do not use this parameter unless specifically requested by the BMC Customer Support.

Mode

Description

OPERATION MODE

Mode in which the Control-M/Restart Data Set Cleanup Facility must operate. Valid values: J (JCL Library mode) or S (Scheduling Library mode). Mandatory.

TRACE MODE

Diagnostic tool that allows debugging in Control-M/Restart. Optional.

Note: Do not use this parameter unless specifically requested by the BMC Customer Support.

Table 17 JCL Library Mode Parameters

Parameter	Description
JCL LIBRARY	Library containing the original job. Mandatory.
MEMBER NAME	Name of the member containing the JCL for the job. Mandatory.

Table 18 Schedule Library Mode Parameters

Parameter	Description
SCHEDULING LIBRARY	Library containing the job scheduling definition. Mandatory.
TABLE NAME	Name of the table containing the job scheduling definition. Mandatory.
JOB NAME	Name of the job scheduling definition. Mandatory.

Table 19 Cleanup Parameters

Parameter	Description
ORDER ID	Job order identification of the specific job run. Mandatory.
FROM PGMSTEP	Name of the pgmstep at which data set cleanup is to be attempted. Mandatory.
TO PGMSTEP	Name of the pgmstep at which data set cleanup is to terminate. Optional.
FROM PROCSTEP	Name of the procstep at which data set cleanup is to be attempted. Optional.
TO PROCSTEP	Name of the procstep at which data set cleanup is to terminate. Optional.

Table 20 AutoEdit Parameters

Parameter	Description
OWNER	Owner. Optional. The panel is displayed with the TSO user ID.
GLOBAL AUTO-EDIT LIBRARY	Library containing globally defined AutoEdit variables. Mandatory. The panel is displayed with the site-defined default.
WDATE	Current working date. Mandatory. The panel is displayed with the current date as the default.
ODATE	Original scheduling date of the job. Mandatory. The panel is displayed with the current date as the default.
Enter YES to continue	Confirmation field to prevent the cleanup jobs from being unintentionally run. When blank, the jobs do not run. Specify YES to enable the job run.

Note the following points about FROM STEP/PROC and TO STEP/PROC values:

To perform processing on the whole job, enter $FIRST in the FROM PGMSTEP field. To perform processing from a specific step, specify the step name in the appropriate FROM PGMSTEP or FROM PROCSTEP fields.
Pgmstep name can be any specific program step name or $FIRST. $FIRST resolves to the first step of the job if procstep name is blank. Otherwise, $FIRST resolves to the first step in the procedure identified by procstep.
$ABEND and $EXERR are not recognized by Control-M/Restart. Do not specify them as step name values. $ABEND and $EXERR are valid only in job scheduling definitions.
If specifying a procstep name when there are nested procedures, specify the procstep name of the innermost procedure in which the program is included.

Note: AutoEdit resolution is performed at time of submitting the job. For example, if a job with the %%DATE AutoEdit date variable is submitted the day after the original run, the resolution of the variable varies from that of the original run.

Parent Topic

R2: Control-M/Restart data set cleanup