TAA Tools
SCNALLSRC       SCAN ALL SOURCE FILES          TAASRCE

The SCNALLSRC  command  provides a  simple method  of  scanning all  or
some  source files  in a  library.   By  default, only  standard source
files  (QCLSRC, QRPGSRC, etc)  are scanned.  All  source files may also
be scanned.  An outfile is optional.

To scan  the library  SALES  for all  use of  the  argument ACCRCV  you
would specify:

         SCNALLSRC    ARGUMENT(ACCRCV) LIB(SALES)

The  SCNALLSRC command  submits a  job to  batch to  perform  the scan.
The  job description specified in the user  profile is used by default.

The SCNALLSRC command  uses the SCNSRC  command (TAA Tool  SCNSRC).   A
spooled  file is  created for  each source  file name  processed.   All
standard  source files in  the library would  be scanned.   The spooled
file name will  be the  name of  the file  scanned.   The spool  USRDTA
field will be SCNSRC.

By default  a spooled file is  created for each  source file.   You can
eliminate  the source  files that  do not  contain  the argument  to be
scanned for by specifying DLTSPLF(*YES).

An  option on the command  exists to specify the  source types that you
want to scan.  For example, you could have specified:

         SCNALLSRC    ARGUMENT(ACCRCV) LIB(SALES) TYPE(*CL *RPG)

This  would have  caused  a scan  against  only  the files  QCLSRC  and
QRPGSRC.

Contrast with SCNGENSRC
-----------------------

The SCNALLSRC  command scans  every member in  a file using  the OVRDBF
MBR(*ALL)  option.  This causes every member  to be opened and scanned.
SCNALLSRC defaults to  process only the standard  source file names  in
a library.

The SCNGENSRC  command scans  only the generically  named members  in a
file.   If a small percentage of members in  the file match the generic
name, performance  is better  with SCNGENSRC.   SCNGENSRC  defaults  to
process all source files in a library.

SCNALLSRC escape messages you can monitor for
---------------------------------------------

      TAA9893    Argument was not found in any source file

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

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

   ARGUMENT      Up to 20  bytes to use in  the scan.  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.   For example,  'ABC ', will  be treated
                 as 'ABC'.

                 To scan  for  lower  case  in the  source,  enter  the
                 value   in   quotes   such  as   'abc'   and   specify
                 TRANSLATE(*NO).

   LIB           The  library name which  contains the  source files to
                 be scanned.  The default  is *DFT meaning the  current
                 library if it exists  and if not the first  library on
                 the user portion of the library list is used.

   TYPE          The source  type that should be scanned.   The default
                 is  *STD  meaning  the  system  supplied  source files
                 such as QCLSRC,  QCMDSRC, etc as  defined in the  help
                 text  for the  system.   For a  listing of  these, use
                 the PRTSRCTYP tool.

                 *ALL  may be  specified  to scan  all source  files in
                 the library.

                 *SRC1, *SRC2, and  *SRC3 mean  that a  data area  must
                 exist on the  library list by the  corresponding names
                 of  SRCLST1, SRCLST2, and  SRCLST3.   These data areas
                 must contain  the  name  of the  source  files  to  be
                 checked.  Only  source files that exist and  match one
                 of  those  found in  the  data area  will  be checked.
                 See the discussion with the CRTSRCFLST tool.

                 *QATT  or  *QATT may  be  specified to  mean  the only
                 files  checked  must  match  those  described  in  the
                 RTVQATTF TAA  Tool.   This is either  a short  or long
                 list  of QATTxxx source file names.   Use the PRTQATTF
                 command for a listing of the files.

                 Using *QATT requires  that you must  know the Tool  ID
                 to specify  as the generic name.   The Tool ID  can be
                 determined  using  DSPTAA and  the name  in  the upper
                 right hand corner  of the  first page.   For  example,
                 the Tool ID for  ADDDAT is TAADATA.  The  *QATT values
                 only  work against  normal  source files  and  not the
                 TAA Archive.

                 Special  values such as *PF  (meaning QDDSSRC) or *RPG
                 (meaning QRPGSRC) may also be entered.

                 If a specific  type is requested,  it must exist.   If
                 a special  value such as *STD is  used, missing source
                 files are ignored.

   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.

   ADDBLANKS     The  number  of  blanks  to add  to  the  end  of  the
                 argument before scanning.

                 0  is the default meaning  the length of  the data for
                 each argument determines what is scanned for.

                 A value in a range of 0 to 3 must be entered.

                 The intent of  this parameter  is to  provide for  the
                 situation such as  when you want  to scan for  the end
                 of  a name  or word ending  in 'red',  but you  do not
                 want  words  such  as  'redeem'.    Using ADDBLANKS(1)
                 finds any words such  as 'altered' which are  followed
                 by a blank.

   CHGDAT        The date  to compare individual  source statements to.
                 *NONE  is the  default  meaning all  source statements
                 are considered.

                 A date  may be  entered in  job format  to compare  to
                 the   individual   source   statements   change   date
                 (positions  7-12)  of  a  source  statement.   If  the
                 source  statement  was   changed  on   or  after   the
                 specified CHGDAT, it  will be considered  for listing.
                 Specifying  a CHGDAT  value can  reduce the  number of
                 print lines that must be reviewed.

   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.

   DLTSPLF       A  *YES/*NO   parameter  for  whether  to  delete  the
                 spooled file if no arguments were found.

                 *NO is the default meaning  one spooled file would  be
                 created for each source file found.

                 *YES  may be  specified to  delete  the spooled  files
                 that do not contain a matching argument.

   OUTLIB        The  library   in  which  the  file  SCNSRCP  will  be
                 placed.  The  default is *NONE  meaning no outfile  is
                 created.

                 A library  may be  named or  *LIBL or  *CURLIB if  the
                 SCNSRCP file exists.

                 The  file  will contain  one  record  for each  detail
                 print line.

                 If  the SCNSRCP  file does  not exist,  a library must
                 be specified.

   OUTMBR        The member of  the SCNSRCP  file to be  used.  If  the
                 member does  not exist, it  is added.  The  default is
                 SCNSRCP.

   REPLACE       A  *YES/*NO  value for  whether the  member  should be
                 cleared before writing records  into it.  The  default
                 is *YES to clear the member before adding records.

                 *NO may  be specified  to add  records to  an existing
                 member.

   JOBD          The  job description to  submit the job  for.  *USRPRF
                 is the default  to use the  job description  specified
                 for the user profile.

                 A  specific job  description  may be  named.   If  the
                 library  value   is  blank,  *LIBL  is   assumed.    A
                 specific library or *CURLIB may also be used.

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

There is a limit of 999 source files in a library.

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

The following TAA Tools must be on your system:

      EXTLST        Extract list
      RTVLIBSRCF    Retrieve library source files
      SCNSRC        Scan source
      SNDCOMPMSG    Send completion message
      SNDDIAGMSG    Send diagnostic message
      SNDESCMSG     Send escape message

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

None, the tool is ready to use.

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

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

   SCNALLSRC     *CMD                      TAASRCE        QATTCMD
   TAASRCEC      *PGM          CLP         TAASRCEC       QATTCL
   TAASRCEC2     *PGM          CLP         TAASRCEC2      QATTCL
   TAASRCEC3     *PGM          CLP         TAASRCEC3      QATTCL

TAASRCEC2  is submitted if a specific  source type is named.  TAASRCEC3
is submitted if a special value is used.
					

Added to TAA Productivity tools April 1, 1995


Home Page Up to Top