TAA Tools
SCNDTAQ         SCAN DATA QUEUE                        TAADTQR

The Scan  Data Queue command scans  the entries in  a data queue  for a
value.  Both  the scan value and the entry  are converted to upper case
before  scanning.   A listing  of the  entries containing the  value is
optional.   An option  also exists  to send  an escape  message if  the
scan value is not found.

A typical command would be:

              SCNDTAQ   DTAQ(xxx) SCNVAL(ABC)

A spooled  file would be displayed  for the data queue  and any entries
containing ABC would be listed.

If  the scan value is found  at position 92 or  greater, the print line
appears with  leading  and  trailing  ellipsis  (...)  surrounding  the
value which is adjusted to print position 5.

SCNDTAQ escape messages you can monitor for
-------------------------------------------

      TAA9895    No scan values found - if ESCAPE(*YES).
      TAA9896    No entries exist in the data queue

Escape messages from based on functions will be re-sent.

SCNDTAQ Command parameters                            *CMD
--------------------------

   DTAQ          The qualified  name of the  data queue to  be scanned.
                 The  library  value  defaults to  *LIBL.    A specific
                 library or *CURLIB may also be used.

   SCNVAL        The value to scan for.   Both the value and the  entry
                 data in  the data  queue are  converted to upper  case
                 before scanning.

   ESCAPE        A  *YES/*NO value for  whether to  send TAA9895  as as
                 escape message if the scan value is not found.

                 *NO  is the default.  A  completion message is sent if
                 the spooled file is not displayed.

                 *YES  may  be   specified  to  cause   escape  message
                 TAA9895 to  be sent  if the scan  value is  not found.
                 If  you specify OUTPUT(*)  in an  interactive job, you
                 must specify ESCAPE(*NO).

   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:

     CHKOBJ3         Check object 3
     CVTDTAQ         Convert data queue
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDTAQD        Retrieve data queue description
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     TRNVAL          Translate value

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SCNDTAQ       *CMD                   TAADTQR       QATTCMD
   TAADTQRC      *PGM       CLP         TAADTQRC      QATTCL
   TAADTQRR      *PGM       RPG         TAADTQRR      QATTRPG
					

Added to TAA Productivity tools January 15, 2009


Home Page Up to Top