Where allowed to run: All environments (*ALL) |
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 |
---|---|---|---|
ASP device | Name | Required, Positional 1 | |
Job queue | Qualified object name | Required, Positional 2 | |
Qualifier 1: Job queue | Name | ||
Qualifier 2: Library | Name | ||
Job retention period | 1-10000, *NONE | Optional | |
Cluster node | Name, * | Optional |
ASP device (ASPDEV)
Specifies the name of the ASP device. The ASP device does not need to exist.
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.