Restarting a job in execution *RESTART,main

Function

Use the *RESTART,main command to restart a job that is already in execution. The *RESTART,main command causes the failure option for the job to be taken unless the job is registered with automatic restart management. If the job is registered with automatic restart management, the FAILURE option will be ignored and automatic restart management will decide if the job will be restarted. If automatic restart management decides not to start the job, then the job will be canceled.

If automatic restart management decides to start the job, all non-spin sysout data sets created during the previous execution will be deleted.

If you want to restart a job but do not want it to execute immediately, place the job in hold status with an *MODIFY command, and then issue the *RESTART,main command. The *RESTART,main command actually cancels the job on the main, making its resources available to other jobs. When the job can be released, using an *MODIFY command, it is rescheduled without having to be read into the system again. For information about restarting MVS™ jobs, see z/OS MVS System Commands.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-+-*RESTART-+--,--main--+-,--jobname-+-----------------------><
   '-*R-------'           '-,--jobno---'   

Parameters

main
Specifies the main name, as defined during JES3 initialization, on which the specified job is currently being executed.
jobname or jobno
Specifies the job to be restarted.
The job will be restarted provided the system failure option for the job is RESTART. The failure option can be specified in this order:
  1. //*MAIN statement
  2. CLASS initialization statement
  3. STANDARDS initialization statement

If RESTART was not specified, the job is processed according to its failure option.