HOLD-JOB-CLASS

Put job class on hold

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

Function

The HOLD-JOB-CLASS command puts a job class on hold.
Batch jobs for the suspended job class are placed in the job queue of the responsible job scheduler but are not released for starting. The command affects only job classes in which batch jobs are assembled; the system job class $SYSJC is also permitted.

The HOLD status is temporary and can be canceled by means of the RESUME-JOB-CLASS command. Successful execution of the command is acknowledged in a message issued at the console. The SHOW-SYSTEM-STATUS provides an overview of the job classes currently on hold.

Format

HOLD-JOB-CLASS                                                                                                                                     

CLASS-NAME = <name 1..8>

Operands

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

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

Notes

• The command is also accepted for system job class $SYSJC.

• If the particular job scheduler is inactive at the time the command is issued, the command is rejected with an error message.

• Batch jobs submitted for a suspended job class are entered to the job queue of the appropriate job scheduler. These jobs are not released for starting.