CHKALLOBJ CHECK ALL OBJECT AUTHORITY TAASECY |
The Check All Object Authority command determines if the user has the
special authority *ALLOBJ. Group profile and program adoption
authority are also considered.
The command will send CPF9898 as an escape message if the user does
not have *ALLOBJ. A simple version of the command would be:
CHKALLOBJ
MONMSG MSGID(CPF9898) EXEC(DO)
.
.
There is an optional parameter ERRTXT that allows you to supply the
message text sent for the CPF9898 message. This is intended for
situations where you are using a Standard Error handling routine and
just want to bubble the message back. For example, assume PGMA calls
PGMB and PGMB contains CHKALLOBJ. If PGMB contains a standard error
handling routine, the error text would be sent to PGMA.
CHKALLOBJ ERRTXT('You must have *ALLOBJ +
special authority to use the +
xxxx function')
If the command completes normally, the error text is not used. If
the user is not authorized, the CPF9898 message is sent with the
error text provided.
There is no completion message if the user is authorized.
CHKALLOBJ is useful when a user makes a request to use a function
that will require accessing all objects or all user objects on the
system. You want to check first before using all the system
resources for a user who is not authorized.
Note that if the check occurs in an interactive job before a job to
run against the entire system is submitted to batch, the command does
not ensure that the user will have authority in the batch job.
Program adopt is not passed to the batch job. You should use
CHKALLOBJ in the batch job in addition.
Command parameters *CMD
------------------
ERRTXT The error text to be used if an error occurs. The
default is *STD which produces standard error text.
The intent of allowing you to enter the text is if
you are using the CHKALLOBJ command in a program
that uses a standard error handling routine to
bubble up the message text to the caller. You can
supply some specific text relative to the function
of your program.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKALLOBJ *CMD TAASECY QATTCMD
TAASECYC *PGM CLP TAASECYC QATTCL
|
Added to TAA Productivity tools May 1, 1996