Change Job Queue (CHGJOBQ)

The Change Job Queue (CHGJOBQ) command allows the user to change the attributes of the specified job queue.

Parameters

Keyword Description Choices Notes
JOBQ Job queue Qualified object name Required, Key, Positional 1
Qualifier 1: Job queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TEXT Text 'description' Character value, *SAME, *BLANK Optional
OPRCTL Operator controlled *SAME, *YES, *NO Optional, Positional 2
AUTCHK Authority to check *SAME, *OWNER, *DTAAUT Optional

Job queue (JOBQ)

Specifies the job queue that is to have its attributes changed.

This is a required parameter.

Qualifier 1: Job queue

name
Specify the name of the job queue to be changed.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
name
Specify the name of the library in which the job queue is located.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text, if any, is not to be changed.
*BLANK
No text is to be specified.
'description'
Specify no more than 50 characters, enclosed in apostrophes.

Operator controlled (OPRCTL)

Specifies whether a user with job control authority is allowed to control and make changes to jobs with entries on this job queue.

*SAME
The current value specified for the operator control attribute of the job queue does not change.
*YES
A user with job control authority can control the queue and make changes to the entries on the queue.
*NO
This queue and its entries cannot be manipulated or changed by users with job control authority unless they also have some other special authority.

Authority to check (AUTCHK)

Specifies what type of authorities to the job queue allow the user to control all the jobs on the queue. Users with some special authority may also be able to control the jobs.

*SAME
The current value of the authority check attribute that is specified for the job queue is not to be changed.
*OWNER
The requester must have ownership authority to the job queue to pass the job queue authorization test. The requester can have ownership authority by being the owner of the job queue, sharing a group profile with the queue owner, or running a program that adopts the owner's authority.
*DTAAUT
Any user with add, read, and delete authority to the job queue can control all jobs on the queue.

Examples

CHGJOBQ   JOBQ(QBATCH)  OPRCTL(*NO)

This command takes away the ability to control or manage jobs on job queue QBATCH for users with job control special authority unless the user has some other special authority.

Error messages

*ESCAPE Messages

CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3330
Necessary resource not available.
CPF3307
Job queue &1 in &2 not found.