The Scan Data Queue Attributes command scans one or more Data Queues
for attribute values. This acts as a simple query to determine the
value of attributes of Data Queue objects.
A typical command would be:
SCNDTAQA ATTR(NBRENT) DTAQ(QSYS/*ALL)
SCNVAL(100) SCNOPR(*GE)
A spooled file would be displayed of all Data Queue objects that have
100 or more entries.
SCNDTAQ escape messages you can monitor for
-------------------------------------------
TAA9891 No Data Queue objects exist
Escape messages from based on functions will be re-sent.
SCNDTAQA Command parameters *CMD
---------------------------
ATTR The Data Queue attribute to be scanned for. The
value must be one of the following:
FORCE. Whether to force the data queue entries to
auxiliary storage. A *YES or *NO may be entered for
the scan value.
KEYLEN. The length of the key for keyed data
queues. A number in the range of 1 to 256 may be
entered for the scan value.
MAXENTLEN. The maximum entry length of an entry. A
number in the range of 1 to 64215 may be entered for
the scan value.
NBRENT. The number of entries in the data queue. A
number in the range of 1 to 9999999 may be entered
for the scan value.
SENDERID. Whether the sender ID is included in the
entry. A *YES or *NO may be entered for the scan
value.
SEQ. The sequence of entries for the data queue. A
value of *FIFO, *LIFO, or *KEYED may be entered for
the scan value.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
DTAQ The qualified name of the Data Queue to be scanned.
A single data 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 FORCE 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:
CVTDTAQA Convert data queue 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
------ ---- --------- ---------- ----------
SCNDTAQA *CMD TAADTQS QATTCMD
TAADTQSC *PGM CLP TAADTQSC QATTCL
TAADTQSR *PGM RPG TAADTQSR QATTRPG
|
