TAA Tools

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:

                         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

                 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

   DTAQ          The  qualified name of  the Data Queue  to be scanned.
                 A single data queue,  a generic name,  or *ALL may  be

                 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

                 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 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.




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


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

Added to TAA Productivity tools July 15, 2009

Home Page Up to Top