The  Display Storage  Use  command  displays  or lists  the  amount  of
storage  used  in  descending order  by  user  profile.   A  percentage
(default  of  90%) may  be specified  to flag  those profiles  that are
approaching the  maximum storage  allowed  per profile.   DSPSTGUSE  is
helpful  in  understanding what  users  have  used  versus the  maximum
allowed for each.

A typical command would be:

             DSPSTGUSE

By  default, IBM profiles are  bypassed.  The  user profile records are
sequenced in  descending  order by  the amount  of  storage used.    By
default, any  user profile  that has  used 90% or  more of  its maximum
allowed storage would be flagged.

DSPSTGUSE escape messages you can monitor for
---------------------------------------------

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

DSPSTGUSE Command parameters                          *CMD
----------------------------

   BYPIBM        A  *YES/*NO value for whether  to bypass IBM profiles.

                 *YES is  the default  to  bypass profiles  like  QSYS.
                 Profiles  designed for  user  use  such as  QPGMR  and
                 QSECOFR are  not bypassed.  The check  is performed by
                 the CHKIBMPRF command.

                 *NO may be specified to include IBM profiles.

   PCTUSE        The  percentage used to cause  flagging to occur.  90%
                 is the  default.  A  value between 1  and 100 must  be
                 specified.

   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.

                 *DAYCHG may  be specified  which means  the file  will
                 be  refreshed if  the last  time  the file  was output
                 was on  a different  day.   *DAYCHG assumes  that  you
                 are  using the  command repeatedly  on  the same  day,
                 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
------------

You must have *ALLOBJ special authority to use DSPSTGUSE.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKIBMPRF       Check IBM profile
     EDTVAR          Edit variable
     RTVDAT          Retrieve date
     DSPSECRVW       Display security review
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPSTGUSE     *CMD                   TAASEHX       QATTCMD
   TAASEHXC      *PGM       CLP         TAASEHXC      QATTCL
   TAASEHXC2     *PGM       CLP         TAASEHXC2     QATTCL
   TAASEHXR      *PGM       RPG         TAASEHXR      QATTRPG