The Scan Job Queue Attributes command scans one or more Job queue
objects for attribute values. This acts as a simple query to
determine the value of attributes of Job Queues.
A typical command would be:
SCNJOBQA ATTR(OPRCTL) JOBQ(QGPL/*ALL)
SCNVAL(*NO) SCNOPR(*EQ)
A spooled file would be displayed of all Job Queue objects that have
an OPRCTL attribute of *YES.
SCNJOBQA escape messages you can monitor for
--------------------------------------------
TAA9891 No Job Queue objects exist
Escape messages from based on functions will be re-sent.
SCNJOBQA Command parameters *CMD
---------------------------
ATTR The Job Queue attribute to be scanned for. The
value must be one the following:
AUTCHK. The authority required to hold or release
the job queue. A value of *OWNER or *DTAAUT may be
entered.
NBRJOBS. The number of jobs on the job queue. A
number may be entered.
OPRCTL. The type of operator control required to
operate on jobs on the job queue. A *YES or *NO
value may be entered.
STATUS. The status of the job queue. A value of
RLS or HLD may be entered for the scan value.
SUBSYSTEM. The name of a subsystem where the job
queue is attached. An *EQ or *NE scan operator must
be used.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
JOBQ The qualified name of the Job Queue object to be
scanned. A single job queue, a generic name, or
*ALL may be entered.
The library qualifier defaults to *LIBL. *USRLIBL,
*CURLIB, *ALL, *ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM
may be entered. For a full description of these
values, see the CVTLIBOBJD command.
SCNVAL The value to be scanned for. Up to 10 bytes may be
entered.
If SCNOPR(*CT) is entered, the SCNVAL should be
entered without quotes as the object text
description will be folded to upper case before
scanning.
SCNOPR The scan operator to be used. *EQ is the default.
*NE, *GT, *GE, *LT, *LE, or *CT (contains) may be
entered. Non-meaningful functions such as scanning
the OPRCTL attribute (supports only *YES or *NO) for
a scan operator other than *EQ/*NE are rejected.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTJOBQA Convert class attributes
CVTLIBOBJD Convert library object description
RTVVALA Retrieve value attributes
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SCNJOBQA *CMD TAAJOEX QATTCMD
TAAJOEXC *PGM CLP TAAJOEXC QATTCL
TAAJOEXR *PGM RPG TAAJOEXR QATTRPG
|