SCNALLDTAA -- Scan All Data Areas

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

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