CHKOBJ3 CHECK OBJECT 3 TAAOBJY |
The Check Object 3 command is like the system CHKOBJ command except
that a better first level message (including the type of object) is
sent if the object is not found. CHKOBJ sends a CPF9801 message
where the first level text reads 'Object xxxx in library yyy not
found'. Typical error text from CHKOBJ3 would be 'File xxxx in yyy
not found'.
The command parameters are identical between CHKOBJ and CHKOBJ3
except that CHKOBJ3 also supports the value *LAST for the MBR
parameter.
The intent of CHKOBJ3 is that you would use it when you do not intend
to monitor for the CPF9801 not found message, but want a more
descriptive first level of error text sent.
The escape message sent is TAA9801 (not CPF9801). Most common object
type such as *PGM are spelled out as 'Program' in the text of the
message.
The other escape messages normally sent by CHKOBJ are re-sent by
CHKOBJ3 such as CPF9802 (not authorized) and CPF9815 (no member).
Command parameters *CMD
------------------
OBJ The qualified name of the object to be checked. The
library value defaults to *LIBL. *CURLIB may also
be used.
OBJTYPE The object type to be checked. The same values as
supported by CHKOBJ are provided. Prompt for the
list.
MBR The member to be checked for a data base file. The
default is *NONE meaning no member is checked. A
member name or the special values *FIRST or *LAST
may be used to check a member.
AUT The authorization to the object to be checked.
*NONE is the default meaning that only the existence
of the object will be checked and not if the user
has any authority to the object.
The same values as exist on CHKOBJ with the same
meaning may be specified. Prompt for the list.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
EXTLST2 Extract list 2
RTVOBJTYPD Retrieve object type description
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKOBJ3 *CMD TAAOBJY QATTCMD
TAAOBJYC *PGM CLP TAAOBJYC QATTCL
|
Added to TAA Productivity tools January 1, 1998