TAA Tools
SCNSRCTYP       SCAN SOURCE TYPE                       TAASRDP

The Scan Source  Type command scans all  the source files in  a library
(or  libraries)  of  a specified  type  (or  types)  for  a string  (or
strings).   The command  can be helpful  when you want  to scan for the
existence of some string  of data and you  are not sure where the  data
may exist.

Because  the command  must  find the  source  files and  may scan  many
source  members, the command should be submitted  to batch in a typical
situation.

A typical command would be:

             SBMJOB        JOB(SCAN) CMD(SCNSRCTYP LIB(*ALLUSR2) +
                             SRCTYP(*CLP) ARGUMENT(ABCDE))

The command  would be  submitted to  batch.   All source  files in  all
normal user  libraries would be  found.  The  CLP type members  in each
source file would be scanned for the string ABCDE.

A  spooled file would be  output for each member  containing the string
describing the statement number and  the statement.  A summary  spooled
file named SUMSRC  would be output with  one line per member  where the
string was found and a summary of the files and members scanned.

If the  special values *ALL,  *ALLUSR2, or *ALLNONQ are  used, the user
must have *USE authority to the TAACVTLIBD authorization list.

When  scanning all  source files on  the system,  certain libraries may
be omitted by use of the OMITLIBS parameter.

The CVTLIBDBF TAA  command is used  to access the  source files in  the
designated libraries.   The  RTVMBRLST2 TAA command  is used  to access
the  list of members in each  file.  The SCNSRC TAA  command is used to
scan the members that match the specified source type(s).

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

   LIB           The  library  (or  libraries)  containing  the  source
                 files  to  be scanned.    A  specific library  may  be
                 named,  a list of up  to 40 libraries,  or the special
                 values  *USRLIBL  (user  library  list  including  the
                 current   library),  *ALL   (all   libraries  on   the
                 system),   *ALLUSR2   (normal   user  libraries),   or
                 *ALLNONQ   (libraries  that  do  not  begin  with  the
                 letter Q).

                 If you want  to scan all  of user source, the  typical
                 entry   would  be   *ALLUSR2.     This  includes   all
                 libraries  that do  not begin  with the letter  Q plus
                 the QGPL  library  and  excludes  the  S/36  libraries
                 #LIBRARY,   #CGULIB,   #COBLIB,    #DFULIB,   #RPGLIB,
                 #SDALIB, #SEULIB, and #DSULIB.

   SRCTYP        A list  of up to 40 source  types or the special value
                 *ALL.   Only  those  source types  specified  will  be
                 scanned.    For  a  complete  list  of  the  supported
                 source types, use the command prompter function.

   ARGUMENT      Up  to 20  bytes  to  use in  the  scan and  up  to 20
                 arguments.   This is  the string that  will be scanned
                 for.   You may need  to surround  the value in  quotes
                 and enter in  upper case depending on the  value.  For
                 typical  field names (e.g.  ACCRCV),  the value may be
                 entered  in  lower  case  without  quotes.    Trailing
                 blanks will be trimmed off.

   TRANSLATE     A *YES/*NO option  that defaults to *NO.   *YES causes
                 the  source statement to  be translated  to upper case
                 before scanning for the argument.   This is useful  if
                 you  have both  upper  and  lower case  versions  that
                 should  be found or  you are not  sure of the  case in
                 the statement.

   SELCOL6       Whether  to select  only certain  source records based
                 on the value  of column 6  of the source data  portion
                 of  the record.    The default  is  *ANY meaning  that
                 column  6  is  not  considered  and  the  entire  data
                 portion of the record is scanned.

                 This option  is designed  for RPG/RPGLE  and to  allow
                 selection of the  type of specification such  as I, D,
                 C,  etc.     For  example,  if   C  is  entered,  only
                 statements with a  C in  column 6 of  the source  data
                 will be  scanned.   Note  that this  may include  some
                 array and table data.

                 A value  should only be entered when  you are limiting
                 the  scan to RPG/RPGLE  source types.   The scan which
                 occurs is not sensitive  to the source type  and would
                 probably provide  misleading information if  a non-RPG
                 type of source was scanned.

   PRTFOLSTM     A  *YES/*NO option that  defaults to *NO.   *YES means
                 that if  a  hit is  found  on  a statement,  the  next
                 statement  will be  printed whether  it has  a hit  or
                 not.

                 The  purpose of  the *YES  option  is for  a situation
                 such as when you are  scanning for a command name  and
                 want to  determine whether  a keyword  has been  used.
                 If  the  command  is  continued  to  a  second  source
                 statement,  the  keyword  you  may  want  to  look for
                 could be on the  second line.  After the  spooled file
                 is  output,  you  can  use  DSPSPLF to  scan  for  the
                 keyword.

   OMITLIBS      A  list of up to  40 libraries to  be omitted if *ALL,
                 *ALLNONQ,  or   *ALLUSR2   are  specified   for   LIB.
                 OMITLIBS(*NONE)  must  be  specified   if  a  specific
                 library   or   libraries  are   named   for   the  LIB
                 parameter.

Restrictions
------------

If a special value for  the LIB parameter is  used, the user must  have
*USE authority to the TAACVTLIBD authorization list.

Prerequisites
-------------

The following TAA Tools must be on your system:

     BLDPRTLIN       Build print line
     CVTLIBDBF       Convert library data base files
     EDTVAR          Edit variable
     EXPVAL          Expand value
     EXTLST          Extract list
     EXTLST2         Extract list 2
     PRINT           Print a spooled file
     RTVMBRLST2      Retrieve member list 2
     SCNSRC          Scan source
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   SCNSRCTYP     *CMD                   TAASRDP       QATTCMD
   TAASRDPC      *PGM       CLP         TAASRDPC      QATTCL
					

Added to TAA Productivity tools March 1, 1998


Home Page Up to Top