HOLD-JOB-STREAM

Put job stream on hold

Component:	BS2000
Functional area:	Job processing
Domain:	JOB
Privileges:	TSOS OPERATING
Routing code:	J

Function

The HOLD-JOB-STREAM command places a job stream on hold. The job scheduler that was active in the suspended job stream cannot carry out its function until the HOLD state has been canceled by means of the RESUME-JOB-STREAM command. During this time user jobs for the job classes assigned to the job stream continue to be accepted but are not released for starting.
The HOLD-JOB-STREAM command is also permitted for the system job stream $SYSJS, for which a total of 16 job streams can be managed.

The job stream is terminated normally if it takes place during the HOLD phase, and a message to this effect is issued at the operator terminal (see the STOP operand of the JMU statement DEFINE-JOB-STREAM in the “Utility Routines” manual [9]).

If a job stream cannot be placed in the wait state, a message to that effect is issued at the operator terminal.

The SHOW-SYSTEM-STATUS command can be used to show which job streams are in the HOLD state (INFORMATION operand, value *JOB-STREAM).

Format

HOLD-JOB-STREAM                                                                                                                                  

STREAM-NAME = <name 1..8>

Operands

STREAM-NAME = <name 1..8>
Name of the job stream to be placed on hold.
The system administration defines the name using the JMU statement DEFINE-JOB-STREAM. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	CMD0202	Syntax error
	32	CMD0221	System error
	64	JMS0630	Semantic error
	64	JMS0640	Command cannot be executed