TAA Tools
FNDSRCTXT       FIND SOURCE TEXT                       TAAOBKS

The Find  Source Text command  searches for a  string of characters  in
the text  description of source members.   A single source  file or all
source   files  in  a  single   library,  multiple  libraries,  or  all
libraries may  be searched.   Either  messages  are sent  or a  spooled
file is  output.   The intent of  FNDSRCTXT is to  assist you  when you
cannot  remember  the source  member  name,  but you  do  remember some
string of characters in the member text description.

You must have *ALLOBJ special  authority to specify a library value  of
*ALL, *ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.

A typical command would be:

         FNDSRCTXT   STRING(xxx) LIB(LIBA)

Messages  would  be produced  for  all  source  members that  have  the
string within  the text description of any member  in the library.  For
example the string might be 'save' or 'copy'.

If the  string contains  a blank,  it must  be quoted  such as  'search
technique'.

Both the string and  the text description of the  member are translated
to upper case before scanning the text.

FNDSRCTXT escape messages you can monitor for
---------------------------------------------

      TAA9892    No source files exist in the library
      TAA9893    The string is not found in any member text
      TAA9894    The library does not exist

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

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

   STRING        The  string to  be searched  for  in the  member text.
                 Up to 30 bytes may be entered.

                 If  the  string contains  a blank,  it must  be quoted
                 such as 'search technique'.

                 Both the  string entered and  the text description  of
                 the  member  are  translated   to  upper  case  before
                 scanning the text.

   LIB           The library containing the object to be checked.

                 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.

   SRCFILE       The  name of  the source  file  to be  searched.   The
                 default  is *ALL  for  all source  files found  in the
                 library   or   libraries   specified   for   the   LIB
                 parameter.

   OUTPUT        How  the  output  should  be  presented.    *  is  the
                 default  and means that  messages will be  sent if the
                 command is  executed interactively.   If  the  command
                 is executed in batch, a spooled file is created.

                 *PRINT may be specified to cause a spooled file.

                 *DSP may  be specified  to display  a spooled file  if
                 in an interactive job.

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

You  must have *ALLOBJ  authority to specify  a library value  of *ALL,
*ALLUSR, *ALLUSR2, or *IBM.

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

The following TAA Tools must be on your system:

     CHKALLOBJ    Check *ALLOBJ special authority
     CVTLIBDBF    Convert library data base files
     EDTVAR       Edit variable
     PRINT        Print from a CL program
     RTVMBRLST2   Retrieve member list 2
     RTVVALA      Retrieve value attributes
     SNDCOMPMSG   Send completion message
     SNDESCMSG    Send escape message
     SNDSTSMSG    Send status message
     TRNVAL       Translate value

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

None, the tool is ready to use.

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

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

   FNDSRCTXT     *CMD                   TAASREM       QATTCMD
   TAASREMC      *PGM       CLP         TAASREMC      QATTCL
					

Added to TAA Productivity tools March 15, 2003


Home Page Up to Top