Use JobRelease to take a JES job, a JES data set group, or a POWER job off hold, that is, alter it so it will be automatically processed by the job entry system (aka Spooler).
The job or data sets must be in hold status.
JobRelease may also be entered as JobRel[ease], Rel[easeJob], RelJ[ob], ReleaseP, or RelP.
Optional Operands
JOB is the JES job or POWER job to release or the JES job containing the JES data set group to release.
GROUP [JES jobs only]. is the JES data set group to release. To release a JES job (as opposed to JES data set group), do not specify GROUP.
JobRelease can also be invoked by entering the ContextRelease command while a JobLibrary session is current. To place a job or data sets on hold, use JobHold.
JES Notes
If neither JOB nor GROUP is specified, the last referenced job (and data sets) are released. (If last referenced job (and data sets) was specified with a DSET operand, JobRelease will be rejected because JES provides no facility to release by data set.)
To release a JES job (as opposed to data sets) specify the JOB operand but do not specify the GROUP operand. To usefully release a JES job, the job must not have started processing. JobRelease operates on all data sets within the JES job that meet the selection.
The relationship between the output queue and the hold queue is a little confusing. For a data set to be in the hold queue, HOLD=YES must have been specified or implied by the CLASS on the DD statement that created it and it must never have been released or altered to a CLASS that implies HOLD=NO. When a JobHold command is issued for a data set that is in the output queue, the data set is placed on hold status but remains in the output queue, and must therefore be accessed by out group rather than by class.
JobRelease sets the last referenced job (and data sets).
POWER Notes
If JOB is not specified, the last referenced job is released.
JobRelease sets the last referenced job.
When Valid
Check with your System Administrator to determine the restrictions on access to JES data sets at your site. The exit routine distributed with BIM-EDIT provides several restriction schemes your System Administrator can select from. (Use of, and changes to the BIXPWQA exit routine are described in the System Reference Manual.)
Return Codes
OK Successful.
NF Job or job data sets not found.
-- Other codes as set by BIXPWQA exit routine.
JES Examples
Release all data sets for JES job ASM100:
=> rel asm100
Release hold queue class G data sets for JES job 7823:
=> rel 7823,G
Release the last referenced job (and data sets):
=> rel
POWER Examples
Release a POWER job in the LST queue, identifying it with queue and job name:
=> rel lst.asm100
Release a POWER job in the RDR queue, identifying it with queue and job number:
=> rel rdr.1278
Release a POWER job in the LST queue, identifying it with just the job number:
=> rel 3426
Release the last referenced job:
=> rel