z/OS DFSMSdfp Checkpoint/Restart
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


RD Parameter

z/OS DFSMSdfp Checkpoint/Restart
SC23-6862-00

You code the RD parameter in the JOB or EXEC statement to request automatic step restart if failure occurs, and/or to suppress, partially or totally, the action of the CHKPT macro instruction. If the RD parameter requests an automatic step restart if failure occurs, or if the RD parameter is not coded, the action of CHKPT is normal: CHKPT writes a checkpoint entry and requests a checkpoint/restart to be performed if failure occurs. The RD parameter is ignored for system tasks and generalized start jobs.

The RD parameter, coded on an EXEC statement, applies to the step corresponding to the statement or to all steps of the cataloged procedure referred to by the statement. Coded on a JOB statement, the RD parameter applies to all steps of the corresponding job and overrides an RD parameter coded in any EXEC statement of the job. The syntax of the parameter is:

   RD[.procstepname]={R|NC|NR|RNC}

The possible definitions are:
RD=R
(Restart) Requests an automatic step restart if failure occurs. If the CHKPT macro instruction is executed in the step, the resulting request for an automatic checkpoint/restart overrides the request for an automatic step restart. This parameter is ignored if the job does not contain a job journal. For JES2 and JES3, this parameter forces job journaling.
RD=NC
(No checkpoint) Does not request an automatic step restart. It totally suppresses the action of the CHKPT macro instruction if the macro instruction executes in the step. This allows use of a program containing CHKPT when the checkpoint function is not wanted. It can also suppress the checkpoint at end-of-volume.
RD=NR
(No automatic restart) Does not request an automatic step restart. It suppresses the request for an automatic checkpoint/restart that is made when the CHKPT macro instruction executes in the step. If CHKPT executes, it writes a checkpoint entry normally. A deferred restart can be performed from the checkpoint entry.
RD=RNC
(Restart and no checkpoint) Requests an automatic step restart if failure occurs. It totally suppresses the action of CHKPT if CHKPT executes in the step. It can suppress the checkpoint at end-of-volume. If the job does not contain a job journal, the step is ineligible for automatic restart. For JES2 and JES3, this parameter forces job journaling.

If RD=value is coded on an EXEC statement that invokes a cataloged procedure, the parameter applies to all steps of the procedure and overrides all RD parameters present in the EXEC statements of the procedure. RD.procstepname=value can be coded instead of RD=value; it applies to the specified procedure step and overrides the RD parameter that may be coded on the EXEC statement of the procedure step. RD.procstepname=value can be coded once for each step of the procedure.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014