HLDJOBQ (Hold Job Queue)

HLDJOBQ Command syntax diagram

 

Purpose

The Hold Job Queue (HLDJOBQ) command prevents the processing of all jobs currently waiting on the job queue and all entries that are added to the queue after the command is issued. The HLDJOBQ command has no effect on jobs that are running. Additional jobs can be placed on the job queue while it is being held, but they are not processed. The jobs are held until a Release Job Queue (RLSJOBQ) command is issued. When a job queue is being held, the jobs can be cleared with the Clear Job Queue (CLRJOBQ) command or a specific job can be canceled by the ENDJOB command.

Restriction: The QLPINSTALL job queue cannot be held.

 

Required Parameters

JOBQ

Specifies the qualified name of the job queue that has its current and future jobs withheld from further processing.

The name of the job queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

job-queue-name: Specify the name of the job queue being held

Example for HLDJOBQ

HLDJOBQ  JOBQ(QBATCH)

This command prevents the processing of the jobs currently on the QBATCH job queue and any jobs added to the queue. They are held until the queue is released or cleared. Individual jobs can also be ended with the ENDJOB command, which removes the job from the job queue.

Error messages for HLDJOBQ

*ESCAPE Messages

CPF2207

Not authorized to use object &1 in library &3 type *&2.

CPF2240

User &7 not authorized to use *&5 &6/&4.

CPF3307

Job queue &1 in &2 not found.

CPF3330

Necessary resource not available.

CPF3425

Job queue &1 in &2 already held.