CRTJOBQ (Create Job Queue)

CRTJOBQ Command syntax diagram

 

Purpose

The Create Job Queue (CRTJOBQ) command creates a new job queue. A job queue contains entries for jobs submitted by using the following commands that are being processed by the system:

To add an entry for this job queue to a subsystem description, use the Add Job Queue Entry (ADDJOBQE) command.

 

Required Parameters

JOBQ
Specifies the qualified name of the job queue being created.

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

*CURLIB: The job queue is created in the current library for the job. 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 where the job queue is created.

Note: The temporary library QTEMP is not a valid library name. Job queues must be in permanent libraries.

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

 

Optional Parameters

OPRCTL
Specifies whether a user who has job control authority is allowed to control this job queue.

*YES: A user with job control authority can control the queue.

*NO: This queue cannot be controlled by users with job control authority unless they have some other special authority.

AUTCHK
Specifies whether the commands that check the requester's authority to the job queue also check for ownership authority or data authority.

*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 job queue owner, or running a program that adopts the job queue owner's authority.

*DTAAUT: The requester who does not have the appropriate data authority to the job queue (*READ, *ADD, and *DELETE) cannot pass the job queue authorization test.

AUT
Specifies the authority given to users who do not have specific authority to the job queue, who are not on an authorization list, and whose user group has no specific authority to the job queue.

*USE: The user can perform basic operations on the job queue, such as running a program or reading a file. The user cannot change the job queue. *USE authority provides object operational authority, read authority, and execute authority.

Note: The user can control jobs submitted by other users if AUTCHK(*DTAAUT) is specified.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the job queue.

*EXCLUDE: The user cannot access the job queue.

*LIBCRTAUT: The public authority for the job queue is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the job queue). The public authority is determined when the job queue is created. If the CRTAUT value for the library changes after the job queue is created, the new value does not affect any existing objects.

authorization-list-name: Specify the name of the authorization list used.

TEXT
Specifies the text that briefly describes the job queue. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTJOBQ 

CRTJOBQ   JOBQ(DEPTA)  AUT(*EXCLUDE)
  TEXT('Special queue for Dept A jobs')

This command creates a job queue named DEPTA and puts it in the current library. Because AUT(*EXCLUDE) is specified and OPRCTL(*YES) is assumed, the job queue is used and controlled only by the user who created the queue and by users with job control authority (*JOBCTL). Also, users with spool control authority (*SPLCTL) can control the queue.

Error messages for CRTJOBQ

*ESCAPE Messages

CPF2182
Not authorized to library &1.
CPF2192
Object &1 cannot be created into library &3.
CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3323
Job queue &1 in &2 already exists.
CPF3351
Temporary library &1 invalid for job queue &2.
CPF3354
Library &1 not found.
CPF3356
Cannot allocate library &1.
CPF3371
Spool user profile QSPL damaged or not found.
CPF9818
Object &2 in library &3 not created.