TAA Tools

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:

                         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

                 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

   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

                 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

   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.




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


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

Added to TAA Productivity tools July 15, 2009

Home Page Up to Top