Previous Topic: RESOLV ExamplesNext Topic: RM Command


RESTART Command

The RESTART top line command restarts a job awaiting restart in the request queue. This function is available as the F option on the QM.1 CPU Jobs Status Prompt panel. You can also use QM.4 CPU Job in Restart Status Prompt panel to accomplish a job restart. If CA WA Restart Option is used, the CMT is updated with the appropriate restart data.

Note: For more information about CA WA Restart Option, see the Interface Reference Guide.

If CA WA Restart Option is not installed, the starting and ending steps have no significance, nor does USAGE, PROCESS, CONDCD, or SUP11STP.

Note: Cross-platform jobs never use CA WA Restart Option services for restart functions.

This command has the following format:

►►─ RESTART ─ ,JOB= ─┬─ jobname ───┬─┬───────────────────────┬────────────────►
                     └─ jobnumber ─┘ └─ ,BYPGDG= ─┬─ NO ◄ ─┬─┘
                                                  ├─ YES ──┤
                                                  ├─ VER ──┤
                                                  └─ CAT ──┘

 ►─┬────────────────┬─┬──────────────────────────┬─┬─────────────┬────────────►
   └─ ,CONDCD=nnnn ─┘ └─ ,FORCECOMP= ─┬─ NO ◄ ─┬─┘ └─ ,LCC=nnnn ─┘
                                      └─ YES ──┘

 ►─┬──────────────────┬─┬───────────────────┬─┬──────────────────────┬────────►
   └─ ,LSTP=stepname ─┘ └─ ,LPSTP=procname ─┘ └─ ,PROCSTRT=procname ─┘

 ►─┬─────────────────────┬─┬─────────────────┬─┬────────────────┬─────────────►
   └─ ,PROCEND=procname ─┘ └─ ,PROCESS=code ─┘ └─ ,REASON=text ─┘

 ►─┬────────────────────┬─┬────────────────────────────┬──────────────────────►
   └─ ,STPEND=stepname ─┘ └─ ,STPSTRT= ─┬─ stepname ─┬─┘
                                        ├─ *CMT* ────┤
                                        ├─ *RERUN* ──┤
                                        └─ *RESUBP* ─┘

 ►─┬─────────────────────────┬─┬───────────────┬──────────────────────────────►◄
   └─ ,SUP11STP= ─┬─ NO ◄ ─┬─┘ └─ ,USAGE=code ─┘
                  └─ YES ──┘
JOB

Indicates the unique CA Workload Automation SE job name or job number of the job to be restarted. The job must be in the request queue.

jobname

Indicates a specific job name.

Limits: 1 to 8 alphanumeric characters

jobnumber

Indicates a specific CA Workload Automation SE job number.

Limits: 1 to 4 numeric characters

BYPGDG

(Optional) Indicates whether CA WA Restart Option should bypass GDG logic on a restart/rerun. Value can be NO, YES, VER, or CAT.

Default: CA WA Restart Option default value

CONDCD

(Optional) Indicates an optional CA WA Restart Option condition code to be set by the CA WA Restart Option step when the rerun is executed. This option is honored only if CA WA Restart Option is in use and CA Workload Automation SE is inserting the RMS step. See the INSERT-RMS field on the DB.1 panel.

Limits: 1 to 4 numeric characters from 0 to 4095

FORCECOMP

(Optional) Indicates whether to flag the job as normally completed. If FORCECOMP=YES, the job's previous abnormal status is ignored, and normal job completion processing is performed instead of a restart. Value can be NO or YES. NO is the default.

LCC

(Optional) Indicates an optional condition code value that replaces the last condition code value for the step referenced by the LSTP and, optionally, LPSTP keywords. This option is honored only if CA WA Restart Option is in use.

Default: 0

Limits: 1 to 4 numeric characters from 0 to 4095

LSTP

(Optional) Indicates an optional step name that has its last condition code value reset in the CA WA Restart Option CMT. LSTP and LCC must be coded if LPSTP is specified. LSTP requires that a STPSTRT value be specified and that the LSTP step name occurs in the job's JCL prior to the STPSTRT step name. This option is honored only if CA WA Restart Option is in use.

Limits: 1 to 8 alphanumeric characters

LPSTP

(Optional) Indicates an optional step name referencing a procedure that has its last condition code value reset in the CA WA Restart Option CMT. If LPSTP is used, LSTP and LCC must also be coded. This option is honored only if CA WA Restart Option is in use.

Limits: 1 to 8 alphanumeric characters

PROCSTRT

(Optional) Indicates an optional step name referencing a procedure where processing is to start. If PROCESS=R and PROCSTRT are used, STPSTRT must also be coded. This option is honored only if CA WA Restart Option is in use.

Limits: 1 to 8 alphanumeric characters

PROCEND

(Optional) Indicates an optional step name referencing a procedure where processing is to end. If PROCESS=R and PROCEND are used, STPEND must be coded. This option is honored only if CA WA Restart Option is in use.

Limits: 1 to 8 alphanumeric characters

PROCESS

(Optional) Indicates an optional CA WA Restart Option processing function code character to be used in the restart/rerun. This option is honored only if CA WA Restart Option is in use and CA Workload Automation SE is inserting the RMS step. See the INSERT-RMS field on the DB.1 panel. Value can be F, P, S, N, O or R.

Default: P

Limits: 1 alphabetic character

REASON

(Optional) Specifies a reason for the restart. If the CA WA Restart Option Reason-for-Rerun module is available, a code of up to four characters can be input and it is expanded. Any reason input or expanded is copied to the run log. This field is optional unless CA WA Restart Option requires a reason or REASON=YES was specified in the RESTART statement in the initialization file. For more information about the initialization file, see the Systems Programming Guide.

Limits: 1 to 40 alphanumeric characters

STPEND

(Optional) Indicates an optional step name or number at which processing is to end. If not specified, the last step of the job is assumed to be the ending step. STPEND must be coded if PROCEND is specified. This option is honored only if CA WA Restart Option is in use.

Limits: 1 to 8 alphanumeric characters

STPSTRT

(Optional) Indicates an optional step name or number at which processing is to start. If STPSTRT is not coded, the first step of the job is assigned to be the starting step. STPSTRT must be coded if PROCSTRT is specified. This option is honored only if CA WA Restart Option is in use.

stepname

Specifies the step name or number at which processing is to start.

*CMT*

Indicates the job is to restart with the step values currently on the CMT record.

*RERUN*

Indicates the total job is to be rerun. If there are no restartable steps, *RERUN* must be specified.

*RESUBP*

Indicates the job's CMT record is set to production, and then the job is submitted.

SUP11STP

(Optional) Indicates if insertion of the CA WA Restart Option RMS step is to be suppressed. If the job is resubmitted with SUP11STP=YES, the CA WA Restart Option step is not inserted. Only valid if CA Workload Automation SE is inserting the CA WA Restart Option step. See the INSERT-RMS field on the DB.1 panel. Value can be NO or YES. NO is the default.

USAGE

(Optional) Indicates an optional CA WA Restart Option usage code of the character to be used in the restart/rerun. For values, see the CA WA Restart Option documentation. This option is honored only if CA WA Restart Option is in use and CA Workload Automation SE is inserting the RMS step. See the INSERT-RMS field on the DB.1 panel.

Limits: 1 alphanumeric character

More information:

QM.1 CPU Jobs Status Prompt Panel

QM.4 CPU Job In Restart Status Prompt Panel