Use JobHold to put a JES job, a JES data set group, or a POWER job on hold, that is, to modify it in such a way as to suppress the automatic initiation of processing of the entry.
JobHold may also be entered as Hold[Job] or HoldP.
Optional Operands
JOB is the JES job or POWER job to hold or the JES job containing the JES data set group to hold.
GROUP [JES jobs only]. is the JES data set group to hold. To hold a JES job (as opposed to JES data set group), do not specify GROUP.
JobHold can also be invoked by entering the ContextHold command while a JobLibrary session is current. To take a job entry off hold, use JobRelease.
JES Notes
If neither JOB nor GROUP is specified, the last referenced job (and data sets) are held. (If last referenced job (and data sets) was specified with a DSET operand, JobHold will be rejected because JES provides no facility to hold by data set.)
To put a JES job (as opposed to data sets) on hold, specify the JOB operand but do not specify the GROUP operand. To usefully hold a JES job, the job must not have started processing. JobHold operates on all data sets within the 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 JobReleased 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.
JobHold sets the last referenced job (and data sets).
POWER notes
If JOB is not specified, the last referenced job is held.
JobHold sets the last referenced job.
When Valid
Check with your System Administrator to determine the restrictions on access to jobs and job data sets at your site. The exit routine distributed with host BIM-EDIT provides several restriction schemes your System Administrator can select from.
Return Codes
OK Successful.
NF Job or data sets not found.
PW Rejected by POWER.
-- Other codes as set by BIXPWQA exit routine.
JES examples
Put the last referenced job (and data sets) on hold:
=> hold
Put out group 2 of job 1934 on hold:
=> hold 1934,2.
POWER examples
Hold a POWER job in the LST queue, identifying it with queue and job name:
=> hold lst.asm100
Hold a POWER job in the RDR queue, identifying it with queue and job number:
=> hold rdr.1278
Hold a POWER job in the LST queue, identifying it with queue, name, and number:
=> hold lst.xmlist.2700
Hold a POWER job in the LST queue, identifying it with just the job number:
=> hold 3426
Hold the last referenced job:
=> hold