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

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.