HOLD-TASK

Put active batch task on hold

Component:	BS2000
Functional area:	Job processing
Domain:	SYSTEM-TUNING
Privileges:	TSOS OPERATING
Routing code:	J

Function

The HOLD-TASK command puts a batch job that has already been started on hold. During this time, the devices reserved by the task remain allocated.
The task remains on hold until it is released explicitly using the RESUME-TASK command. Only after this release the job can be terminated with the CANCEL-JOB command if desired. The HOLD-TASK command is rejected in the case of interactive jobs, spoolout, ARCHIVE or transaction tasks.
The HOLD-TASK command refers exclusively to batch jobs which have already been started; jobs which have not yet been started can be managed by a HOLD-JOB command.

Format

HOLD-TASK                                                                                                                                              

JOB-IDENTIFICATION = *TSN (...) / *MONJV(...)
	*TSN(...)
		|	TSN = <alphanum-name 1..4>
	*MONJV(...)
		|	MONJV = <filename 1..54 without-gen-vers>

Operands

JOB-IDENTIFICATION =
The batch job which is to be put on hold can be identified by either its task sequence number (TSN) or a declared monitoring job variable (MONJV), as preferred.

JOB-IDENTIFICATION = *TSN(...)
Preset value: the job is identified by its task sequence number.

TSN = <alphanum-name 1..4>
Task sequence number of the batch task to be placed in the wait state.

JOB-IDENTIFICATION = *MONJV(...)
The job is identified by its monitoring job variable.

MONJV = <filename 1..54 without-gen-vers>
Specifies the monitoring job variable for the batch job which is to be put into the wait state.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	EXC0708	HOLD-TASK command already being processed
12	64	EXC0707	Task is in process of LOGOFF (EXIT-JOB)
12	64	EXC0710	Task is a transaction task (TP)
12	64	EXC0711	Specified job number (TSN) not found
12	64	EXC0715	Command not allowed for this type of task