TAA Tools
SCNALLSRC2      SCAN ALL SOURCE 2                      TAASRCF

The Scan All Source 2  command will scan for up to 20  arguments in all
source files  in one or more  libraries.  Special values  exist for the
library  name such as *ALLUSR.   An omit list  of libraries may also be
named.    The  command  is  submitted  to  batch  with  JOBD  and  JOBQ
parameters.  An outfile is optional.

A typical command would be:

             SCNALLSRC2  ARGUMENT(ABC DEF) LIB(AAA BBB CCC)

The  defaults for  JOBD (*USRPRF)  and JOBQ  (*JOBD) would  be  used to
submit to batch.

The arguments  ABC and DEF would be scanned  for in all source files in
libraries AAA,  BBB, and  CCC.   A spooled  file would  be created  for
each source file  containing an argument.   A line would be  listed for
each statement that contained a string that matches an argument.

Batch job
---------

The  batch job is named  SCNALLSRC2.  A  batch job is  used as scanning
many members  may  overflow  the  internal job  log.    The  batch  job
prevents the overflow by removing messages from inactive jobs.

SCNALLSRC2 escape messages
--------------------------

      TAA9894    No arguments were found

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

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

   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.

                 If  the  value  in  the  source  is  in  lower   case,
                 consider the use of TRANSLATE(*YES).

   LIB           Specifies  1  to  300  libraries  or  generic  library
                 names  to  be  searched.    QTEMP  may  not  be  named
                 because  it  is  not  in  the  system  file  that   is
                 searched.

                 The special  value *LIBL may  be used to  describe all
                 libraries  on the current  library list.   The current
                 library  is  also  considered  to  be  part  of *LIBL.
                 QTEMP is  bypassed  if *LIBL  is requested.    Product
                 libraries are not considered.

                 The  special value  *USRLIBL may  be used  to describe
                 all  user libraries on the current  library list.  The
                 current library  is  also  considered to  be  part  of
                 *USRLIBL.     QTEMP   is  bypassed   if  *USRLIBL   is
                 requested.  Product libraries are not considered.

                 The  special  value  *ALL  may  be  used to  mean  all
                 libraries  (except  QTEMP).     You  must  have   *USE
                 authority  to  the TAACVTLIBD  authorization  list  to
                 use *ALL.

                 The  special value  *ALLUSR may  be  used to  mean all
                 user  libraries.   These are the  same libraries saved
                 by SAVLIB  LIB(*ALLUSR).  For  a full definition,  see
                 the SAVLIB  prompt.  You  must have *USE  authority to
                 the TAACVTLIBD authorization list to use *ALLUSR.

                 The  special value  *ALLUSR2 may  be used to  mean all
                 normal user libraries.   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.  You  must have  *USE authority
                 to   the   TAACVTLIBD   authorization  list   to   use
                 *ALLUSR2.

                 The  special value  *ALLNONQ may  be used  to mean all
                 libraries that  begin  with  a letter  other  than  Q.
                 You  must  have  *USE   authority  to  the  TAACVTLIBD
                 authorization list to use *ALLNONQ.

                 The  special value *IBM  may be used to  mean the same
                 libraries saved  by  SAVLIB  LIB(*IBM).   For  a  full
                 definition,  see the  SAVLIB  prompt.   You must  have
                 *USE  authority to  the TAACVTLIBD  authorization list
                 to use *IBM.

   OMITLIB       A list  of  up to  300  libraries or  generic  library
                 names to be omitted.

                 The  omit  function  takes  precedence  over  the  LIB
                 parameter.       If    you   specify    LIB(ABC)   and
                 OMITLIBS(AB*),  the  ABC  library  files  will  not be
                 output.

   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.

   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.

   JOBQ          The job queue  to submit  the job  to.   *JOBD is  the
                 default to  use  the job  queue specified  in the  job
                 description.

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

   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.

   FILE          The name or generic  name of the file to  be searched.
                 The default is *ALL meaning all file names.


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

None.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTLIBDBF       Convert library data base file
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     SCNSRC          Scan source
     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
   ------        ----    ---------      ----------    ----------

   SCNALLSRC2    *CMD                   TAASRFA       QATTCMD
   TAASRFAC      *PGM       CLP         TAASRFAC      QATTCL
   TAASRFAC2     *PGM       CLP         TAASRFAC2     QATTCL
					

Added to TAA Productivity tools April 15, 2009


Home Page Up to Top