TAA Tools
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


Home Page Up to Top