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.
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
|
