The Find Source Member command searches for a member name, a generic
member name, or a string of characters in a member name. 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 FNDSRCMBR is to
assist you when you can remember something about the member name, but
not necessarily the full name or where you placed the member.
If a single library is specified, you must be authorized to the
library and any source file to be checked in the library. Program
adopt may not be used.
If a library value of *ALL, *ALLNONQ, or *ALLUSR2 is specified, you
must have *USE authority to the TAACVTLIBD authorization list.
A typical command would be:
FNDSRCMBR MBR(MBR1) LIB(LIBA)
An informational message would be sent for each source member in LIBA
that contained MBR1 as the member name.
If the command is submitted to batch or OUTPUT(*PRINT) is specified,
a spooled file is output with the same information.
For a description of how to enter a generic name or a string, see the
MBR parameter description.
FNDSRCMBR escape messages you can monitor for
---------------------------------------------
TAA9892 No source files exist in the library
TAA9893 No member is found in any source file
TAA9894 The library does not exist
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
MBR The member name to be searched for. The name may be
a specific name, a generic name, or a string (two
forms of string are supported).
If ABC (specific member) is entered, only the exact
member name ABC would be searched for. Member names
such as XABC or ABCX would not satisfy the search.
If ABC* (generic) is specified, member names such as
ABC, ABCX, and ABCXYZ would satisfy the search.
Member names such as XABC would not satisfy the
search.
If *ABC* is entered (string), the command can only
be entered by using the prompter. This is similar
to the same type of entry supported by the OBJ
parameter of WRKOBJPDM (you can use a command line
if you surround the value in quotes such as '*ABC'
for the MBR parameter). Member names ABC, ABCX,
XABC, XABCX, and JKLMNOPABC would satisfy the
search. Note that if you prompt and enter a lower
case value such as '*abc*', the command returned
will have the MBR value in lower case. However, the
value is translated to upper case before searching
for a member name.
If *ABC is entered (second form of string), member
names such as ABC, XABC, and JKLMNOPABC would
satisfy the search. The second form of string
requires that blanks follow the string in the member
name or that the name end with the string to be
scanned for. Values such as ABCX would not satisfy
the search.
LIB The library containing the source files to be
checked.
The special value *ALL may be used to mean all
libraries. You must have *USE authority to the
TAACVTLIBD authorization list to use *ALL.
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.
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.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTLIBDBF Convert library data base files
EDTVAR Edit variable
PRINT Print from a CL program
RTVMBRLST Retrieve member list
SCNVAR Scan variable
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
TRNVAL Translate value
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
FNDSRCMBR *CMD TAASRDK QATTCMD
TAASRDKC *PGM CLP TAASRDKC QATTCL
|
