Effect of JCL Changes on U11RMS

ca11 must gain control whenever a job is executed to maintain continuous current catalog and data set information. This control is imperative for either a production run or a rerun. In a production run, ca11 gathers job step and data set information and stores it for use in setting up a possible rerun/restart. In a rerun/restart situation, ca11 performs the necessary catalog and data set maintenance and controls which steps are executed.
ca11
CA WA Restart Option
must gain control whenever a job is executed to maintain continuous current catalog and data set information. This control is imperative for either a production run or a rerun. In a production run,
CA WA Restart Option
gathers job step and data set information and stores it for use in setting up a possible rerun/restart. In a rerun/restart situation,
CA WA Restart Option
performs the necessary catalog and data set maintenance and controls which steps are executed.
Processing Actions
During production processing,
CA WA Restart Option
compares the submitted JCL with the job's CMT entry. If a significant JCL change is detected,
CA WA Restart Option
takes one of two actions depending on the setting of the Automatic Format (AUTOF) user installation option. AUTOF is only triggered during production processing.
  • If AUTOF=YES,
    CA WA Restart Option
    switches to format processing to build a new CMT entry for the job.
  • If AUTOF=NO,
    CA WA Restart Option
    issues a user abend. The user must then force format processing to occur.
Six types of JCL changes trigger an AUTOF:
  • Adding a new step.
  • Changing the name of an existing step.
  • Deleting an existing step.
  • Adding a significant DD statement to an existing step.
  • Deleting a significant DD statement from an existing step.
  • Changing the DDNAME, DATA SET NAME, GDG INDEX, or GDG BIAS on a significant DD statement within an existing step.
A significant DD statement is defined as any DD statement which contains a DSN other than NULLFILE, an && temporary name, SYSIN, or SYSOUT.
The philosophy of
CA WA Restart Option
R processing is to exactly reproduce the production run.
CA WA Restart Option
allows some JCL changes prior to executing a rerun, but certain situations can occur where you need to make significant changes to the JCL preventing
CA WA Restart Option
from being able to handle the restart. In this situation, a step restart using the RESTART= parameter on the JOB statement would be required to bypass the U11RMS step.
A special case involving a JCL change deals with the detection of a changed VOL parameter for a DD during P processing. If AUTOF=YES, the CMT DD record is updated to reflect the new VOLSER.
Procedure
The following is a suggested procedure to use for executing a rerun/restart in case significant JCL changes are made.
  1. If the installation option is OLMAINT=YES, the PRE command or U11PRE performs all necessary catalog maintenance. If OLMAINT=NO, use the following command online with the stepname to determine what catalog maintenance
    CA WA Restart Option
    would have done and do the required maintenance manually.
    SIM R,jobname
  2. Add RESTART=
    stepname or procstep.stepname
    on the JOB statement.
CA WA Restart Option
is
not
available on subsequent abends of this job since the CMT is incorrect until the next F processing. Use the RESTART= parameter on the JOB statement and manual catalog maintenance until successful.
The following table shows the result of certain JCL changes encountered by U11RMS. The Change to JCL column indicates input or output data sets and the JCL change that is detected. Notice that three columns indicate the various processing types. The effect of a JCL change can vary from P processing to R processing and within R processing depending on whether Bypass GDG logic is in effect. Under the P Processing column, observe that certain JCL changes cause format processing (AUTOF) or an abend with a message (U/0020) issued, depending on the AUTOF option selected.
IN specifies input data set. OUT specifies output data set. SDS specifies simple data set (non-GDG). VC specifies verification code.
Change to JCL
P Processing
R,BYPGDG=NO/CAT
R,BYPGDG=YES
ADD DD DUMMY
O K
O K
O K
DEL DD DUMMY
O K
O K
O K
IN-CHG TO DUMMY
AUTOF/U0020
O K
O K
OUT-CHG TO DUMMY
AUTOF/U0020
O K
O K
IN-SDS-CHG DSN
AUTOF/U0020
O K
O K
IN-SDS-ADD DD
AUTOF/U0020
O K
O K
IN-SDS-DEL DD
AUTOF/U0020
O K
O K
OUT-SDS-CHG DSN
AUTOF/U0020
U0020-VC=24
U0020-VC=24
OUT-SDS-ADD DD
AUTOF/U0020
U0020-VC=24
U0020-VC=24
OUT-SDS-DEL DD
AUTOF/U0020
U0020-VC=24
U0020-VC=24
IN-GDG-CHG INDEX
AUTOF/U0020
U0020-VC=24
O K
IN-GDG-CHG BIAS
AUTOF/U0020
U0020-VC=36
O K
IN-GDG-ABS OVERIDE
AUTOF/U0020
O K
O K
IN-GDG-ADD DD
AUTOF/U0020
U0020-VC=24
O K
IN-GDG-DEL DD
AUTOF/U0020
U0020-VC=24
O K
OUT-GDG-CHG INDEX
AUTOF/U0020
U0020-VC=32
U0020-VC=32
OUT-GDG-CHG BIAS
AUTOF/U0020
U0020-VC=36
U0020-VC=36
OUT-GDG-ABS OVERIDE
AUTOF/U0020
O K
O K
OUT-GDG-ADD DD
AUTOF/U0020
U0020-VC=32
U0020-VC=32
OUT-GDG-DEL DD
AUTOF/U0020
U0020-VC=20
U0020-VC=20
R,BYPGDG=VER only looks at GDG data sets and produces a U0020 abend whenever the GDGNUM in the CMT does not match the relative GDG in the catalog.