Restarting allocation *RESTART,SETUP

Function

Use the *RESTART,S command to return a job to the allocation stage (after volume fetch). The *RESTART,S command is used when a volume or device requested or needed by the job is unavailable. Generally, the *RESTART,S command can be used to return any job in the main device scheduling (MDS) processing to the MDS allocate queue. If a job is MVS™ restarting and the *RESTART,S command is issued to restart that job, the job becomes eligible to run on any main rather than only on the main where it was originally selected.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-+-*RESTART-+--+-,--SETUP-+--+-,--jobno-------+--+--------+--><
   '-*R-------'  '-,--S-----'  '-,--(--jobno--)-'  +-,--CI--+   
                                                   +-,--E---+   
                                                   '-,--IUV-'   

Parameters

SETUP or S
Specifies that the job in MDS processing is returned to the allocation phase.
jobno
Specifies the job number of the job to which the SETUP message applies.
CI
Specifies that the job will restart from the beginning of C/I processing. This allows JES3 to restart jobs that completed C/I processing before a JES3 restart which changed the device configuration.
E
Specifies that extended information is to be sent to the console specified in the MDSLOG= parameter of the SETPARAM initialization statement during the next setup attempt by MDS if the job's eligibility for processing is reduced. The information given is identical to that inserted into the job's JESMSGLG data set.
IUV
Specifies that a job currently in the MDS volume unavailable queue be allowed to allocate volumes which have been made unavailable by the *MODIFY,S,VU= command. The IUV operand allows a volume restore or repair job to run, while preventing access by any other jobs which use the volume. If the job is in any other MDS queue, the operand is ignored.

To return the job to the volume unavailable queue, reissue the *RESTART,SETUP command, with or without the IUV operand, for that job.