REMOVE_TRACKED_JOB_QUEUE procedure

The REMOVE_TRACKED_JOB_QUEUE procedure removes a job queue from the tracked job queue list.

All information associated with the specified job queue is removed from the job tracking file.

Unless ignore-errors is YES, the tracking file's IASP must be in the caller's namespace or it must be the name of an IASP that does not exist. The IASP for the tracking file was specified on the QSYS2.ADD_TRACKED_JOB_QUEUE procedure with the tracking-file-iasp parameter. It is returned in the TRACKING_FILE_IASP column of the QSYS2.TRACKED_JOB_QUEUES view.

Authorization: The caller must have *JOBCTL special authority.

Read syntax diagramSkip visual syntax diagram REMOVE_TRACKED_JOB_QUEUE ( IASP_NAME =>  iasp-name , JOB_QUEUE_LIBRARY =>  job-queue-library , JOB_QUEUE =>  job-queue ,IGNORE_ERRORS => ignore-errors )

The schema is QSYS2.

iasp-name
A character string that contains the name of the ASP where job-queue-library is located. Can contain the following special value:
*SYSBAS
The job queue library is located in the system ASP (ASP 1) or any basic user ASPs (ASPs 2-32).
job-queue-library
A character string that contains the name of the library containing job-queue.
job-queue
A character string that contains the name of the job queue to be removed from being tracked.
ignore-errors
A character string expression that identifies what to do when an error is encountered while removing information from the job tracking file.
NO
An error is returned, and the job queue is not removed from tracking. This is the default.
YES
A warning is returned.

The job queue will be removed from tracking without removing associated information from the job tracking file.

Example

  • Remove job queue APPLIB/APPJOBQ from the list of tracked job queues.
    
CALL QSYS2.REMOVE_TRACKED_JOB_QUEUE(IASP_NAME         => '*SYSBAS',
                                    JOB_QUEUE_LIBRARY => 'APPLIB',
                                    JOB_QUEUE         => 'APPJOBQ');