The Display User Authority 4 command lists all objects in a library
that a named user is not explicitly authorized to.  For example, if
the user should have *CHANGE authority to all objects in the library,
a line would be listed for each object where the user has 1) no
explicit authority, 2) is specified as *EXCLUDE, or 3) has only *USE
authority.

A user has explict authority to an object if the user appears on the
object's list of authorized users or on the object's authorization
list.

You must have *ALLOBJ special authority to use DSPUSRAUT4.

A typical command would be:

            DSPUSRAUT4  LIB(LIBA) USER(SMITH) AUT(*CHANGE)

A display would appear of all objects in the library that SMITH did
not have at least *CHANGE authority to.

DSPUSRAUT4 escape messages you can monitor for
----------------------------------------------

      TAA9891    The user has not authority to the library

Escape messages from based on functions will be re-sent.

DSPUSRAUT4 Command parameters                         *CMD
-----------------------------

   LIB           The library where the objects exist to be checked.

   USER          The user name to check authority for.  It must be an
                 existing user or *PUBLIC.

   AUT           The authority to check for.  *USE is the default.

                 *CHANGE or *ALL may be specified.

                 The 'USER DEF' value is not supported.

   OUTPUT        How to output the results.  * is the default to
                 display the spooled file if the command is entered
                 interactively.  If the display is ended with F3/F12
                 or the Enter key, the spooled file is deleted after
                 it is displayed.  To retain the spooled file, you
                 may use the the System Request 'Cancel' function and
                 the spooled file will exist in a HLD status.

                 If the command is entered in batch or *PRINT is
                 specified, the spooled file is output and retained.


Restrictions
------------

You must have *ALLOBJ special authority to use DSPUSRAUT4.

A 'USER DEF' authority value is not supported.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     CVTLIBOBJA      Convert library object authority
     RTVOBJAUT       Retrieve object authority
     RTVOBJD2        Retrieve object description 2
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   DSPUSRAUT4    *CMD                   TAASELH       QATTCMD
   TAASELHC      *PGM       CLP         TAASELHC      QATTCL
   TAASELHR      *PGM       RPG         TAASELHR      QATTRPG