The Find 2 command is intended to assist you in identifying all the
objects of a generic name on the library list, in a specific library,
all libraries, etc. Messages are returned when an object is found.
The command works best on the full command entry display (CALL QCMD)
where more message lines exist than with a command line on a menu.
A typical command would be:
FIND2 ABC
All generic ABC objects on the user portion of the library list would
be searched for and a message would appear for each one found.
You may also ask for all ABC generic objects on the system such as:
FIND2 OBJ(*ALL/ABC)
You can also do the following:
- Request by specific object type
- Request all of a specific type
- Request a non-generic search
- Request for a specific library, *LIBL,
*CURLIB, *ALL, or *ALLUSR
For each object found, a message is sent with the object name,
library, type, object attribute, and an abbreviated text description.
By default, after 15 detail messages have been sent, a summary
message is sent describing the total number of objects found.
Comparison with CHKOBJ4
-----------------------
CHKOBJ4 is a similar command, but uses the system convention where
you must enter a generic name to gain the generic function.
Performance
-----------
The TAA Tool RTVOBJLST is used to retrieve the object information.
It uses the QUSLOBJ API.
If you limit your request so that hundreds of objects will not be
found, the performance is usually very good. Requesting a search for
all libraries or all user libraries takes longer.
Authorization considerations
----------------------------
You must be authorized to the library that is specifically named. If
not, an escape message will occur.
If a library you are not authorized to is included in the special
library value (such as *ALLUSR), the objects are not considered.
If you are authorized to the library, but not the object, a special
string of text will appear in the object Text description.
Locks, damage, etc.
-------------------
If an object is exclusively locked or damaged, an indication will
appear in the text description.
Command parameters *CMD
------------------
OBJ The qualified name of the object to be found. The
string of characters that are entered must be a
name, but is treated as a generic value by default
(do not enter an *). See the GENERIC parameter for
a non-generic search. The special value *ALL may
also be used.
The library value defaults to *LIBL. *CURLIB,
*USRLIBL, *ALL, or *ALLUSR may also be specified.
OBJTYPE The object type to be checked for. The default is
*ALL. For a full list of the supported object
types, use the command prompting facility.
GENERIC A *YES/*NO value for whether the object to be
searched will use a generic name. *YES is the
default.
*NO may be specified to cause a search only by the
object name.
MAXMSGS The maximum number of duplicate objects for which
detail messages will appear. The default is 15. A
summary message will describe the number of objects
that match the criteria and whether all appear as
detail messages. If you want a different number of
detail messages, you may enter a value between 1 and
75.
Restrictions
------------
See the previous comments.
Prerequisites
-------------
The following TAA Tools must be on your system:
EDTVAR Edit variable
RTVOBJLST Retrieve object list
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
FIND2 *CMD TAAOBKB QATTCMD
TAAOBKBC *PGM CLP TAAOBKBC QATTCL
|
