The Check Object 4 command is intended to assist you in identifying
all the objects of a name or 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:
CHKOBJ4 ABC
All ABC objects on the user portion of the library list would be
searched for and a message would appear for each one found.
You can request a generic search also such as:
CHKOBJ4 ABC*
You can also do the following:
- Request by specific object type
- Request all of a specific type
- 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.
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.
Comparison with FIND2 command
-----------------------------
The FIND2 TAA Tool command is a similar function, but assumes a
generic use. For example,
FIND2 ABC
will find all objects beginning with ABC.
Command parameters *CMD
------------------
OBJ The qualified name of the object to be found. A
generic name may be entered. The special value *ALL
may also be used.
The library value defaults to *LIBL. *CURLIB,
*USRLIBL, *ALL, or *ALLUSR may also be specified.
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.
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.
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
------ ---- --------- ---------- ----------
CHKOBJ4 *CMD TAAOBKC QATTCMD
TAAOBKCC *PGM CLP TAAOBKCC QATTCL
|
