Run Time Module JCL Requirements

The following JCL is required to run the RestartPlus Run Time Module. Items in lower case need to be modified for your installation.

//UC4AGENT EXEC PGM=UC4REST,PARM='parms'

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

//SYSPRINT DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

//UC4IN DD DISP=SHR,DSN=uc4_restart_control_card_dataset

JCL Statements Explanation:

//UC4AGENT EXEC PGM=UC4REST,PARM='parms'

Required
The EXEC statement executes UC4REST, the RestartPlus Run Time Module. Valid PARM values are described later in this chapter.

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

Optional
RestartPlus must be installed into and executed from an APF-authorized library. If this library is not part of the system LINKLST or LPALIST concatenation, the STEPLIB DD must be specified.

//SYSPRINT DD SYSOUT=*

Required
The SYSPRINT DD statement specifies the print dataset for the RestartPlus Run Time Module.

//SYSUDUMP DD SYSOUT=*

Optional
The SYSUDUMP DD statement may be required if the RestartPlus Run Time Module encounters a problem and UC4 RestartPlus Technical Support is contacted.

//UC4IN DD DISP=SHR,DSN=uc4_restart_control_card_dataset OR //UC4IN DD *

Optional
This UC4IN DD is used to pass control statements to the RestartPlus Run Time Module. If a dataset is used, it must be LRECL=80, RECFM=FB. RestartPlus Run Time Module control statements are described later in this chapter.

Run Time Module PARMs

The RestartPlus Run Time Module is controlled by information passed in the PARM= field. The contents of the PARM= field are described below:

Code the following as required:

PARM='keyword=arg,keyword=arg [,keyword=arg.]'

The keywords accepted are:

RT= Runtype

Possible arguments:
- PR - Production Run: The Run Time Module is to run in production mode
- RR - Rerun/Restart run: The Run Time Module is to perform rerun processing
- SU - Suppress run: All actions of the Run Time Module are to be suppressed
- CL - Cleanup run: Dataset cleanup is done as if the job were restarted from the first step. All job steps are cancelled so that no job steps after the Run Time module step are executed
RS= Restart STEP

If RT=RR is specified, this keyword specifies the step to begin the rerun/restart.

Possible formats of the argument to this keyword:
- Numeric: (1-255) The STEP number with which to begin the rerun/restart
- Stepname: The name of the step that executes the program with which to begin the rerun/restart
- Stepname.procstep: The name of the step followed by the name of the step within a PROC that executes the program with which to begin the rerun/restart
ES= End STEP

If RT=RR is specified, this keyword specifies the step to end the rerun/restart. The argument to this keyword can have three possible formats:
- Numeric (1-255) The STEP number with which to end the rerun/restart
- Stepname The name of the step that executes the program with which to end the rerun/restart
- Stepname.procstep The name of the step followed by the name of the step within a PROC that executes the program with which to end the rerun/restart
RC= Run Time Module Return Code

If RT=RR is specified, this keyword specifies the return code with which the Run Time Module should terminate. This allows the execution of succeeding steps to be controlled via the COND= parameter during restart/rerun processing
GO= GDG options

If RT=RR is specified, this keyword specifies how GDG datasets should be handled.

Possible arguments:
- NO: Do not adjust GDG bias in the JOB
- YES: Perform standard GDG bias processing. This is the default and will be used if this parameter is not specified
SI=YES Simulate

Causes the Run Time module to simulate its processing and to produce messages indicating the actions that would be taken. No actions, however, are actually performed
SC= Step condition code

If RT=RR is specified, this keyword allows you to specify the return code that a specific step, skipped by rerun/restart processing, should appear to post.

Possible formats to the argument to this keyword:
- Stepname=rc The name of the step to post and the return code to post
- Stepname.procstep=rc The name of the step followed by the name of the step within a PROC to post and the return code to post

RestartPlus Run Time Module PROC

For convenience, the JCL required to execute the Run Time Module has been encapsulated in a PROC:

//UC4REST PROC TYPE=,START=,END=,RETCODE=,GDGOPT=,SIMULAT=,STPCODE=

//**********************************************************************

//* *

//* U C 4 R E S T A R T P L U S *

//* *

//* RUN TIME MODULE PROC *

//* *

//* TYPE= : PR- PRODUCTION RUN (DEFAULT), RR- RESTRAT/RERUN *

//* SU- SUPPRESS *

//* *

//* RESTART/RERUN INFO - *

//* IF TYPE=RR AND START IS NOT SPECIFY, STARTING POSITION IS *

//* DETERMINED BY JOURNAL DATA *

//* *

//* START= : IF TYPE=RR, STEP NUMBER (1-255), STEPNAME, OR *

//* PROCSTEP.STEP TO RESTART RERUN JOB *

//* END= : IF TYPE=RR, STEP NUMBER (1-255), STEPNAME, OR *

//* PROCSTEP.STEP TO END RERUN JOB *

//* RETCODE= : IF TYPE=RR, RC FOR RUN TIME MODULE TO POST *

//* GDGOPT= : IF TYPE=RR, YES (DEFUALT) - ADJUST GDG BIAS INFO *

//* NO - DO NOT PERFORM GDG BIAS PROCESSING *

//* SIMULAT= : YES - SIMULATE PROCESSING, NO (DEFAULT) - PERFORM *

//* NORMAL PROCESSING *

//* STPCODE= : IF TYPE=RR, STEPNAME=RC, PROCSTEP.STEPNAME=RC, POST *

//* THE SPECIFIED RC FOR THE SPECIFIED STEP *

//* *

//**********************************************************************

//UC4REST EXEC PGM=UC4REST,PARM='RT=&TYPE,RS=&START,ES=&END,GO=&GDGOPTX

// ,SI=&SIMULAT,SC=&STPCODE,RC=&RETCODE'

//* NOTE - STEPLIB IS NOT REQUIRED IF RESTARTPLUS

//* IS INSTALLED IN AN AUTHORIZED LINKLIST DATASET

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

//SYSPRINT DD SYSOUT=*

//UC4IN DD DISP=SHR,DSN=uc4_restart_control_card_dataset

// PEND

Customize the UC4REST PROC for your environment as follows:

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

Optional

RestartPlus must be installed into and executed from an APF-authorized library. If this library is not part of the system LINKLST or LPALIST concatenation, the STEPLIB DD must be specified

//UC4IN DD DISP=SHR,DSN=uc4_restart_control_card_dataset

Optional

This DD is used to pass control statements to the RestartPlus Run Time Module. If a dataset is used, it must be LRECL=80, RECFM=FB. RestartPlus Run Time Module control statements are described later in this chapter.

Using the UC4REST PROC in your JOBs can simplify JCL coding and make controlling Run Time Module JOB steps easier to understand. For example:

//UC4REST EXEC UC4REST,TYPE=PR

will cause a production run, while:

//UC4REST EXEC UC4REST,TYPE=RR,START=5,END=7

will cause a restart/rerun to rerun JOB steps 5, 6, and 7.

The parameters to the PROC are as follows:

TYPE= Runtype

Possible arguments:
- PR - Production Run: The Run Time Module is to run in production mode
- RR - Rerun/Restart run: The Run Time Module is to perform rerun processing
- SU - Suppress run: All actions of the Run Time Module are to be suppressed
START= Restart STEP

Possible arguments:
- Numeric: (1-255) The STEP number with which to begin the rerun/restart
- Stepname: The name of the step that executes the program with which to begin the rerun/restart
- Stepname.procstep: The name of the step followed by the name of the step within a PROC that executes the program with which to begin the rerun/restart
END= End STEP

If TYPE=RR is specified, this keyword specifies the step to end the rerun/restart. The argument to this keyword can have three possible formats:
- Numeric: (1-255) The STEP number with which to begin the rerun/restart
- Stepname: The name of the step that executes the program with which to begin the rerun/restart
- Stepname.procstep: The name of the step followed by the name of the step within a PROC that executes the program with which to begin the rerun/restart
RETCODE= Run Time Module Return Code

If TYPE=RR is specified, this specifies the return code with which the Run Time Module should terminate. This allows the execution of succeeding steps to be controlled via the COND= parameter during restart/rerun processing
GDGOPT= GDG options

If TYPE=RR is specified, this keyword specifies how GDG datasets should be handled. Possible arguments are:
- NO: Do not adjust GDG bias in the JOB
- YES: Perform standard GDG bias processing. This is the default and will be used if this parameter is not specified
SIMULAT=YES Simulate

Causes the Run Time Module to simulate its processing but not perform the actions
STPCODE= Step condition code.

If TYPE=RR is specified, this keyword allows you to specify the return code that a specific step, skipped by rerun/restart processing, should appear to post. The argument to this keyword can have two possible formats:
- Stepname=rc The name of the step to post and the return code to post
- Stepname.procstep=rc The name of the step followed by the name of the step within a PROC to post and the return code to post