Create Job Queue (CRTJOBQ)

The Create Job Queue (CRTJOBQ) command creates a new job queue. A job queue contains entries for jobs that are waiting to be processed by the system. Jobs can be placed on a job queue by using any of the following commands:

Start Database Reader (STRDBRDR)
Start Diskette Reader (STRDKTRDR)
Start Printer Writer (STRPRTWTR)
Start Diskette Writer (STRDKTWTR)
Submit Job (SBMJOB)
Submit Database Jobs (SBMDBJOB)
Submit Diskette Jobs (SBMDKTJOB)
Transfer Job (TFRJOB)

After you create a new job queue, you must add an entry for it in the appropriate subsystem description. To do this use the Add Job Queue Entry (ADDJOBQE) command.

Parameters

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

Top

Job queue (JOBQ)

Specifies the job queue being created.

This is a required parameter.

Qualifier 1: Job queue

name: Specify the name you want for the job queue being created.

Qualifier 2: Library

*CURLIB: The current library for the job is used to locate the job queue. If no current library entry exists in the library list, QGPL is used.
name: Specify the name of library where the job queue is to be located.
Note: The temporary library QTEMP is not a valid library name. Job queues must be in permanent libraries.

Operator controlled (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 also have some other special authority.

Authority to check (AUTCHK)

Specifies what type of authorities to the job queue allow the user to control the job queue by holding or releasing the queue. Users with some special authority may also be able to control the job queue.

*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: Any user with add, read, and delete authority to the job queue can control the queue.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*USE: Use authority allows the user to perform basic operations on the job queue, such as submit jobs to this queue.
*CHANGE: Change authority allows the user to control jobs submitted by other users if *DTAAUT was specified on the Authority to check (AUTCHK) parameter.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.

*EXCLUDE: The user cannot access the object.

*LIBCRTAUT: The authority for the object is the same as the value specified on the Create authority (CRTAUT) parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

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

*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.