The Display  User Auditing  command displays  a list of  users and  the
attribute  information  about  object  auditing.    A  single  user,  a
generic  name,  or all  users  may be  requested.   You  may optionally
bypass any user who does not have user auditing requested.

Only a user with *ALLOBJ authority may use DSPUSRAUD.

For an  overview of  the system  and  TAA auditing  functions, see  the
documentation member 'AUDITING'.

A typical command would be:

             DSPUSRAUD  USRPRF(*ALL)

A list of  all user profiles on the system would  be displayed with the
information  about   the  object  auditing  attribute  along  with  any
entries for the audit level action.

DSPUSRAUD escape messages you can monitor for
---------------------------------------------

      TAA9891    No user profiles exist as per the request

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

DSPUSRAUD Command parameters                           *CMD
----------------------------

   USRPRF        The user  profile  name  to  display  the  information
                 for.   A generic  name may be  entered or  the special
                 value *ALL

   LSTALL        A  *YES/*NO  value that  determines  whether  all user
                 profiles will be  listed or  only those  with a  value
                 in the OBJAUD attribute that is other than *NONE.

                 *YES causes all user profiles to be listed.

                 *NO  causes only  those  user  profiles that  have  an
                 object  auditing  attribute  other  than *NONE  to  be
                 listed.

   REFRESH       An  option  to  determine  if  the  DSPUSRPRF  OUTFILE
                 function is used to  refresh the TAASECKP file  in the
                 TAASECURE library.   The  default is *YES  meaning the
                 file will be refreshed each time.

                 *DAYCHG  may  be entered  to  cause a  refresh  if the
                 last time the DSPUSRPRF  OUTFILE function was used  on
                 a  different   day.    This   assumes  that   you  are
                 repetitively  using the  command on  the same  day and
                 you do not  want to keep  refreshing the  information.

                 *NO may  be specified to  use the  existing data.   If
                 no data exists, the file is output.

   OUTPUT        How  to  output the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  The spooled  file is deleted after  it
                 is displayed.

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


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

Only an *ALLOBJ user may use DSPUSRAUD.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKGENERC       Check generic
     RTVDAT          Retrieve date
     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
   ------        ----    ---------      ----------    ----------

   DSPUSRAUD     *CMD                   TAASEHI       QATTCMD
   TAASEHIC      *PGM       CLP         TAASEHIC      QATTCL
   TAASEHIR      *PGM       RPG         TAASEHIR      QATTRPG