The Find Object Text command searches for a string of characters in
the object descriptions in a single library, multiple libraries, or
all libraries. Either messages are sent or a spooled file is output.
The intent of FNDOBJTXT is to assist you when you cannot remember the
object name, but you do remember some string of characters in the
object text.
You must have *ALLOBJ special authority to specify a library value of
*ALL, *ALLUSR, *ALLUSR2, or *IBM.
A typical command would be:
FNDOBJTXT STRING(xxx) LIB(LIBA)
Messages would be produced for all objects that have the string
within the text description of any object 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 object are translated
to upper case before scanning the text.
FNDOBJTXT escape messages you can monitor for
---------------------------------------------
TAA9892 No objects exist in the library
TAA9893 The string is not found in any object 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 object 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 object are translated to upper case before
scanning the text.
LIB The library containing the object to be checked or
the special values *LIBL, *USRLIBL, *CURLIB,
*ALLUSR, *ALLUSR2, *IBM, or *ALL.
A generic library name may also be entered. The API
used does not support a generic library name. The
function occurs by using *ALL for the library and
then selecting the individual objects to see if they
exist in the generic library name. Because of this
approach, if a short generic object name is entered,
the performance can be slow as many objects may need
to be accessed and checked for the generic library
name.
For *LIBL and *USRLIBL, if a current library exists,
it will also be searched.
*ALLUSR means any library that was not created by
the system according to the CHKIBMLIB command.
*ALLUSR2 means any library that meets the criteria
specified for the SAVLIB LIB(*ALLUSR) function.
This excludes # libraries such as #SEULIB and
includes QUSRSYS, QGPL, etc. See the help text for
the SAVLIB LIB parameter for a complete description.
An entry of *IBM causes all libraries to be included
as per the definition of the CHKIBMLIB tool.
Product libraries are never included.
OBJTYPE The object type to be searched for. The default is
*ALL. See the command prompt for a complete list.
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
CHKOBJ3 Check object 3
CVTLIBOBJD Convert library object description
EDTVAR Edit variable
PRINT Print from a CL program
RTVOBJLST Retrieve object list
RTVVALA Retrieve variable 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
------ ---- --------- ---------- ----------
FNDOBJTXT *CMD TAAOBKS QATTCMD
TAAOBKSC *PGM CLP TAAOBKSC QATTCL
|
