FNDSRCTXT -- Find Source Text

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

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