TAA Tools
DSPEMTARA       DISPLAY EMPTY DATA AREA                TAAARAS

The Display  Empty Data Area  command displays one  or more data  areas
that  have a blank  value or a  zero value for  decimal types.   A flag
may  be  set  if  the  data  area has  not  been  changed  (such  as by
CHGDTAARA) in  the last  n days.   An option  exists to  list all  data
areas.  DSPEMTARA can be helpful in cleaning up unused data areas.

You  must have  *ALLOBJ special  authority to  use a  library  value of
*ALL or *ALLUSR.

A typical command would be:

             DSPEMTARA    ARA(*ALLUSR/*ALL) FLAGDAYS(100)

All  data areas in  user libraries that  do not have any  data would be
listed.  Any  data areas  that have not  been changed in  the last  100
days would  be flagged.   The first  25 bytes of  value from  each data
area is displayed.

*DEC type  data areas that have  a 0 value are  considered empty.  Only
whole numbers  are  considered (not  decimal  positions).   Only  whole
numbers are listed for the abbreviated values shown.

DSPEMTARA escape messages you can monitor for
---------------------------------------------

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

DSPEMTARA Command parameters                          *CMD
----------------------------

   DTAARA        The  qualified  name  of  the  data   area  to  be  be
                 processed.   A single  data area,  a generic  name, or
                 the special value *ALL may be entered.

                 The  library  value  defaults to  *LIBL.    A specific
                 library, *CURLIB,  *USRLIBL, *ALL,  or *ALLUSR may  be
                 entered.

   FLAGDAYS      The number  of days  to flag the  data area if  it has
                 not been changed.  The default is 60 days.

                 A  data area is  considered changed if  a command such
                 as CHGDTAARA is used.

   ALLARA        Whether to list all  data areas regardless of  whether
                 they contain a value.

                 *NO is  the default  to list only  data areas  with no
                 values.

                 *YES may be specified to list all data areas.

   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 a  library value  of
*ALL or *ALLUSR.

*DEC type  data areas that have a  0 value are considered  empty.  Only
whole  numbers  are considered  (not  decimal positions).    Only whole
numbers are listed for the abbreviated values shown.

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

The following TAA Tools must be on your system:

     ADDDAT2         Add date 2
     CHKALLOBJ       Check *ALLOBJ special authority
     EDTVAR          Edit variable
     RTVDECARA       Retrieve decimal data area
     RTVDTAARAD      Retrieve data area description
     RTVSYSVAL3      Retrieve system value 3
     SCNVAR          Scan variable
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   DSPEMTARA     *CMD                   TAAARAS       QATTCMD
   TAAARASC      *PGM       CLP         TAAARASC      QATTCL
   TAAARASR      *PGM       RPG         TAAARASR      QATTRPG
					

Added to TAA Productivity tools October 15, 2010


Home Page Up to Top