TAA Tools
SCNALLDTAA      SCAN ALL DATA AREAS                    TAAARAP

The Scan All  Data Areas command allows  a scan for up to  20 different
values for  one, generic, or all  data areas in one  or more libraries.
This  can  be  helpful when  attempting  to identify  where  values are
located.

A typical command would be:

            SCNALLDTAA    DTAARA(*LIBL/*ALL) SCNVAL(ABC DEF)

A spooled  file of  the results  would be  displayed.   Each data  area
would  be listed with  an indication  of whether  the value  was found.
If both ABC and DEF are found in a data area, 2 lines are listed.

If  the scan  value is  longer than  the length of  the data  area, the
scan will not be found.

Scanning decimal data areas
---------------------------

Decimal  data  area  values  are  stored  in  packed  decimal   format.
Consequently, to scan for 123, you must specify X'123F'.

SCNALLDTAA escape messages you can monitor for
----------------------------------------------

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

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

   DTAARA        The qualified  name of  the data  area to  be scanned.
                 A  specific  name,  a generic  name,  or  *ALL may  be
                 entered.

                 The library  value  defaults  to *LIBL.    A  specific
                 library,  *CURLIB,  *USRLIBL,  *ALL,  or  *ALLUSR  may
                 also be entered.

   SCNVAL        A list  of up to  20 values to  scan for.   Each value
                 may be up to 20 bytes.

   TRANSLATE     A  *YES/*NO value  for whether  to translate  the data
                 in the data area to upper case before scanning.

                 *NO is the default to not translate.

                 *YES may be specified  to translate the data  to upper
                 case.

   PRTOPT        Whether  to list all  data areas  or just  those where
                 the scan value was found.

                 *ALL is the default to list all data areas.

                 *FOUND  should be specified  to list  only those where
                 the scan value was found.

   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:

     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RTVSYSVAL3      Retrieve system value 3
     SCNDTAARA       Scan data area
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   SCNALLDTAA    *CMD                   TAAARAP       QATTCMD
   TAAARAPC      *PGM       CLP         TAAARAPC      QATTCL
   TAAARAPR      *PGM       RPG         TAAARAPR      QATTRPG
					

Added to TAA Productivity tools February 1, 2005


Home Page Up to Top