Customizing Control-M/Restart

ABNDTYP

ADDPROC

ALLRUNS

AMBLK#R

AMBLKSZR

AMPREFR

AMUNITR

AMVOLR

AUTOXREF

CHKSEC

CTRPROC

CTRSTAT

DELFOVOL

DMSVOL

DYNFILE

EAVUSE#R

ENHGDG

ERRORRC

EXCLPDS

EXCLVSAM

FORCONCE

IFADJ

IGNFLUSH

IGNGDGMB

IGNLIST

IGNVOLRF

MAXDAYS

MAXRUNS

MODGDGN

MSGLVL

MSG2SYSO

NCAT2

NCT2RC

NFILVS99

NONRSTDD

PROCRC

PRTDASD

PRTUNIT

SAMEGDG

SEARCH

SUPNCT2

SYSDB

TAPEMS

VOLISMS

AMBLK#R

The default number of blocks in the first logical extent of a Control‑M/Restart compressed sysout data set.

Maximum length: 5 digits

For more information about this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

AMBLKSZR

The block size that should be used for compressed sysout data sets.

For more information about this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

AMPREFR

Prefix of the Control‑M/Restart archived sysout data set names that are created by the Control‑M monitor (the first qualifier in the data set name).

• Mandatory

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

EAVUSE#R

Allows allocation of Control-R CDAM files on EAV (Extended Address Volumes).

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

AMUNITR

Default unit for archived sysout files. This unit will be used for the SYSDATA archived by the Control‑M monitor.

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

AMVOLR

Default volume serial numbers for Control‑M/Restart archived sysout data sets.

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

MAXDAYS

The default number of days the archived sysout data sets are to be kept.

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

ABNDTYP

How the special restart step inserted in the JCL of the job to be restarted terminates if the restart step encounters an unrecoverable error.

• Mandatory

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

ALLRUNS

Whether during post processing Control‑M considers all previous runs of a job, both original runs and restarts, or only the last run or restart.

For more information, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing, and the introduction chapter in the Control‑M/Restart for z/OS User Guide.

CTRSTAT

Whether the skipped steps statistics message CTR066I is displayed.

• Mandatory

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

IFADJ

Whether to simulate the IF condition in IF, THEN and ELSE DD statements so that a job can be restarted within an IF, THEN or ELSE DD statement.

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

IGNGDGMB

Whether Control‑M/Restart stops or allows processing of a job on detecting a missing base generation data set (base GDG) when processing a Control‑M/Restart facility.

For more information, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

MSGLVL

Message level of the Control‑M/Restart step.

• Mandatory

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

NCAT2

Whether to prevent NOT CATLGD 2 events in advance as a default.

For more information on this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

SEARCH

Controls the searching for uncataloged data sets on all mounted disks that Control‑M/Restart may perform in case of a restart of a job whose original run failed due to a system crash.

• YES – ControlM/Restart starts searching for uncataloged data sets, on all mounted disks, if it recognizes that the original run of job failed due to a system crash. Default.

• NO – Suppresses this processing; ControlM/Restart does not start searching.

• CONFIRM – ControlM/Restart issues messages CTR303I and CTR304I and then waits for confirmation from an operator before starting to search the data sets.

SYSDB

Specifies which type of archive (CDAM) data sets will be used by Control‑M and Control‑M/Restart for saving job outputs.

The SYSDB parameter in the CTRPARM member specifies the default archiving type. It may be overridden by the SYSDB parameter in the scheduling definition of any specific job.

• YES – Multi-job CDAM files are used for archiving the sysouts of jobs, meaning that each archive CDAM data set may contain the output of several jobs. Default.

• NO – Each archive CDAM file may contain the sysout of only one job.

AUTOXREF

Whether statistics are collected automatically during Control‑M/Restart PREVENT NCT2 processing for the Job Dataset Cross Reference report. These statistics are the same as those produced by the CTMJDS utility.

• Mandatory

Valid values are:

• Y – Statistics are automatically collected for the Job Dataset Cross Reference report.

• N – Statistics are not automatically collected for the Job Dataset Cross Reference report. Default.

CHKSEC

Security checks for data sets used by a job.

For more information about this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

DELFOVOL

(WR0085)

Controls whether Control‑M/Restart deletes a data set from the volume pointed to by the catalog in addition to deleting it from the volume identified in the JCL of the job (if they differ). Valid values are:

• Y – ControlM/Restart deletes the data set from the volume pointed to by the catalog in addition to deleting it from the volume identified in the JCL.
  This is useful when the user changes the volumes specified in JCL between runs of the job.

• N – If a data set is found on the volume specified in JCL, ControlM/Restart deletes the data set from that JCL volume only. If the data set is also cataloged in another volume, it is not deleted from that other volume. Default.

DYNFILE

(WR0266)

Controls the processing of dynamic (CDAM) data sets.

Valid values are:

• Y – ControlM/Restart processes dynamic (CDAM) data sets in exactly the same way as regular data sets. Default.

• N – ControlM/Restart skips processing of dynamic (CDAM) data sets.

ENHGDG

(WR0204)

Enhanced GDG handling.

For more information, see also MSG2SYSO, the following parameter in this table.

Valid values are:

• Y – ControlM/Restart issues special message CTR301I during Prevent NCT2 or List processing. This message contains information that may be useful for correct processing of GDG data sets during restart. Default.

• N – ControlM/Restart does not issue the CTR301I messages.

EXCLPDS

Specifies whether Control-M/Restart should exclude PDS and PDSE data sets from Control-M/Restart processing.

Valid values are:

• Y –Exclude PDS and PDSE data sets from Control-M/Restart processing.

• N – Do not exclude PDS and PDSE data sets from Control-M/Restart processing. Default.

EXCLVSAM

Specifies whether Control-M/Restart should exclude VSAM data sets from Control-M/Restart processing.

Valid values are:

• Y –Exclude VSAM data sets from Control-M/Restart processing.

• N – Do not exclude VSAM data sets from Control-M/Restart processing. Default.

FORCONCE

(WR0302)

Whether a DO FORCEJOB request is executed during the RESTART of a job.

• Mandatory

Valid values are:

• Y – The DO FORCEJOB statement is not executed during the RESTART of a job if this statement was already executed during the original run of the job or during a previous RESTART of the job.

IGNFLUSH

(WR0247)

Prevents, during the Restart process, the processing of new GDG data sets from being created by steps flushed during the original run of a job.

Valid values are:

• Y – During the Restart process, ControlM/Restart avoids processing of GDG data sets specified with DISP set to NEW if such a GDG data set is specified in a step that did not run (was flushed) during original run of a job. Such processing usually includes scratching and uncataloging corresponding GDG data set created by the original run of a job and correcting the name of the new GDG data set so that it has the same name as during original run.
  This parameter, together with the SAMEGDG parameter, described below, may be useful when several jobs may create new GDG generations for the same GDG base.

• N – This feature is not activated and ControlM/Restart processes GDG data sets the same way for all steps. Default.

IGNLIST

Whether Control‑M/Restart can ignore a missing input data set during Control‑M/Restart LIST processing.

For more information about this parameter, see the "Installing Control-M/Restart" chapter in the INCONTROL for z/OS Installation Guide: Installing.

IGNVOLRF

(WR0245)

Whether Restart Step Adjustment is performed when the job has a DD statement that refers to a tape data set with a volser specified by a backward reference, using a VOL=REF statement, to a step that is prior to the Restart step and is not to be executed during Restart

Valid values are:

• Y – Step Adjustment is not performed. The Restart begins at the selected step, and ControlM/Restart attempts to resolve the volser and avoid JCL errors.

• N – ControlM/Restart performs Step Adjustment to resolve VOL=REF statement specifications that refer to steps prior to the selected Restart step. Default.

MODGDGN

(WR0088)

Controls processing of GDG data sets specified with DISP set to MOD.

Valid values are:

• Y – If the GDG data set (with DISP set to MOD) exists, ControlM/Restart processes it as a data set with DISP set to OLD. That is, it corrects the reference rolls back to the GDG data set name.

• N – ControlM/Restart should process GDG data sets with DISP set to MOD in exactly the same way as it processes GDG data sets with DISP set to NEW. That is, DELETE and UNCATALOG the corresponding GDG data set created by original run of job. Default.

MSG2SYSO

(WR0209)

Controls the output data set to which CTR301I messages are sent when the ENHGDG parameter is set to Y.

For more information, see also ENHGDG, the preceding parameter in this table.

Valid values are:

• Y – ControlM/Restart issues messages CTR301I to the JESYSMSG data set (third MSGCLASS data set). Default.

• N – ControlM/Restart issues messages CTR301I to the JESMSGLG data set (first MSGCLASS data set).

NFILVS99

(WR0077)

Enables Control‑M/Restart job processing to create new files dynamically (using SVC 99).

Valid values are:

• Y – ControlM/Restart does not stop the job if one of the input data sets is missing, for example where the data set is referred to by a DDstatement in a step that is not the first step to be executed. The logic is to allow dynamic allocation in an application or the use of the IDCAMS utility.

• N – The restarted job is stopped if an input data set is missing. Default.

PRTDASD

(WR0065)

Controls the printing of parameter members used for Control‑M/Restart processing.

• Y – Print the contents of parameter members (from the ControlM/Restart PARM library) used by ControlM/Restart. Default.

• N – Suppress printing of the contents of parameter members (from the ControlM/Restart PARM library) used by ControlM/Restart.

PRTUNIT

(WR0063)

Controls the printing of the default UNIT Names table.

Valid values are:

• Y – ControlM/Restart prints the default UNIT Names table. Default.

• N – ControlM/Restart does not print the default UNIT Names table.

SAMEGDG

(WR0231)

Support of concurrent writing to the same GDG base by different jobs.

Valid values are:

• Y – ControlM/Restart supports concurrent writing to the same GDG base by different jobs. This includes additional checking before ControlM/Restart processes any GDG data set (such as scratching, uncataloging, and correcting data set name) that corresponds to a GDG data set (such as scratched, uncataloged, and used data set name) that was really created and/or used by the original run of the same job.
  This parameter, together with IGNFLUSH (described in this table), may be useful for the cases when several jobs may create new GDG generations for the same GDG base.

• N – This feature is not activated. Default.

SUPNCT2

(WR0143)

Controls suppression of part of the Prevent NCT2 Control‑M/Restart processing facility.

Valid values are:

• Y – ControlM/Restart does not change DISP=(OLD,CATLG) to DISP=(OLD,KEEP) for data sets that are to be cataloged in one of the previous steps of the job. This value is recommended for sites using SMS. Default.

• N – ControlM/Restart changes DISP=(OLD,CATLG) to DISP=(OLD,KEEP) for data sets that are to be cataloged in one of the previous steps of the job. This value is not recommended for sites using SMS.

VOLISMS

(WR0246)

Support of jobs having VOL=SER expressions for SMS-controlled data sets.

Valid values are:

• Y – ControlM/Restart ignores VOL=SER expressions that specify a non-mounted disk or a disk that does not contain corresponding data sets. Instead of using the volume specified by the VOL=SER expression, ControlM/Restart takes a volume according to a specified data set name or a volume taken from the Catalog.
  This parameter value should be used by sites that have implemented SMS, but that still have jobs with JCL that were developed before SMS implementation, and are accessing irrelevant volumes with the VOL=SER parameters.

• N – This feature is not activated and ControlM/Restart processes VOL=SER expressions the standard way. Default.

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

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.