TAA Tools
TAASEEC         CHECK *SECADM SPECIAL AUTHORITY        TAASEEC

The Check  *SECADM  Special Authority  command determines  if the  user
has the  special authority *SECADM.  Group  profile, supplemental group
profiles,  and  program adoption  authority are  also considered.   The
*SECADM special  authority is  needed for  various functions  involving
user profiles.

The command  will send CPF9898  as an escape  message if the  user does
not have *SECADM.  A simple version of the command would be:

             CHKSECADM
             MONMSG        MSGID(CPF9898) EXEC(DO)
               .
               .

This  would  check  that  the  current  user  has  the *SECADM  special
authority.

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 CHKSECADM.   If PGMB contains a  standard error
handling routine, the error text would be sent to PGMA.

          CHKSECADM      ERRTXT('You must have *SECADM +
                          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.

CHKSECADM can  be  useful if  a user  is to  make a  request  to use  a
function that  will require  changing a user  profile or  re-creating a
program  that adopts the owners  authority.  It allows  checking to see
if the function can be performed from a security viewpoint.

Note that if the check occurs  in an interactive job to check before  a
command 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 CHKSECADM  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  CHKSECADM 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
   ------        ----    ---------      ----------    ----------

   CHKSECADM     *CMD                   TAASEEC       QATTCMD
   TAASEECC      *PGM       CLP         TAASEECC      QATTCL
					

Added to TAA Productivity tools January 1, 1999


Home Page Up to Top