The Scan Message Queue Attributes command scans one or more Message
Queues for attribute values. This acts as a simple query to
determine the value of attributes of Message Queue objects.
A typical command would be:
SCNMSGQA ATTR(NBRMSGS) MSGQ(QSYS/*ALL)
SCNVAL(100) SCNOPR(*GE)
A spooled file would be displayed of all Message Queue objects that
have 100 or more messages.
SCNMSGQA escape messages you can monitor for
--------------------------------------------
TAA9891 No Message Queue objects exist
Escape messages from based on functions will be re-sent.
SCNMSGQA Command parameters *CMD
---------------------------
ATTR The Message Queue attribute to be scanned for. The
value must be one of the following:
ALWALR. Whether alerts may be generated when an
alert message is sent to the message queue. A *YES
or *NO may be entered for the scan value.
BRKPGM. The name of a break program may be entered.
An *EQ or *NE scan operator must be used.
BRKPGMLIB. The name of a library containing the
break program may be entered. An *EQ or *NE scan
operator must be used.
DLVRY. The delivery method used for the message
queue. The scan value of *HOLD, *BREAK, *NOTIFY, or
*DFT may be entered.
FORCE. Whether messages sent to the message queue
are forced to auxiliary storage. A *YES or *NO may
be entered for the scan operator.
MSGQFULL. The action to be taken when the message
queue is full. A value of *SNDMSG or *WRAP may be
entered for the scan value.
NBRMSGS. The number of messages on the message
queue.
SEV. The severity code filter assigned to the
message queue. A number of 00 to 99 may be entered.
SIZE. The size of the message queue in bytes.
TEXT. A string of characters to be found in the
text description may be entered with the operator
*CT.
MSGQ The qualified name of the Message Queue to be
scanned. A single message 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.
To scan for non-blank entries for BRKPGM or
BRKPGMLIB, enter ' ' and SCNOPR(*NE).
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 ALWALR 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:
CVTMSGQA Convert message 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
------ ---- --------- ---------- ----------
SCNMSGQA *CMD TAAMSJF QATTCMD
TAAMSJFC *PGM CLP TAAMSJFC QATTCL
TAAMSJFR *PGM RPG TAAMSJFR QATTRPG
|
