Start Tracking Job Queue (STRTRKJOBQ)

Where allowed to run: All environments (*ALL)
Threadsafe: Yes

The Start Tracking Job Queue (STRTRKJOBQ) command starts the tracking of jobs submitted to a job queue.

Restrictions:

You must have job control (*JOBCTL) special authority to use this command.
You must have system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes

Keyword	Description	Choices	Notes
ASPDEV	ASP device	Name	Required, Positional 1
JOBQ	Job queue	Qualified object name	Required, Positional 2
	Qualifier 1: Job queue	Name
	Qualifier 2: Library	Name
RETENTION	Job retention period	1-10000, *NONE	Optional
NODE	Cluster node	Name, *	Optional

ASP device (ASPDEV)

Specifies the name of the ASP device that the job queue is in.

This is a required parameter.

name

Specify the name of the ASP device.

Job queue (JOBQ)

Specifies the name of the job queue.

This is a required parameter.

Qualifier 1: Job queue

name

Specify the name of the job queue. A job queue can be registered even if it does not exist. Job queues in libraries QSYS and QGPL that start with Q are not eligible to be added.

Qualifier 2: Library

name

Specify the name of the library. The library does not need to exist.

Job retention period (RETENTION)

Specifies the number of minutes job tracking information will be retained in the tracking file after the job has ended. Once this time period has elapsed, the job tracking information becomes eligible to be removed from the job tracking file.

*NONE

The job tracking information is immediately eligible for removal when the job ends.

1-10000

Specify the number of minutes.

Cluster node (NODE)

Specifies the name of the node.

*

Specifies the local node.

name

Specifies the name of the node.

Examples for STRTRKJOBQ

Example: Start tracking of a job queue on an IASP device

STRTRKJOBQ ASPDEV(IASP001) JOBQ(PRDLIB/BATCHJOBQ)

This command starts tracking of jobs submitted to job queue BATCHJOBQ in library PRDLIB in device IASP001 on the local node.

Error messages for STRTRKJOBQ

*ESCAPE Messages

HAE002B

&1 command failed.