The Display Last Use  command displays or prints a listing  of one line
per  object in  a library identifying  the create  date, the  last used
date,  and  the use  count.   Objects  that  have never  been  used are
always listed.  An  option exists to list  those objects that have  not
been  used  prior to  a  specified number  of  days.   DSPLSTUSE  helps
determines what objects may be deleted because of lack of use.

A typical command would be:

             DSPLSTUSE    LIB(xxx) OMITDAYS(365)

A  display would  appear with  one line  per object  if the  object has
never been used or not used in the last 365 days.

Objects created from source
---------------------------

If an object should  be deleted that was  created from source, you  may
also want  to delete the  source member used for  the create step.   If
so, consider the following TAA commands:

         DLTPGMSRC
         DLTFSRC
         DLTCMDSRC

These special  DLT commands will delete both  the object and the source
member if the member  still exists where the  object was created  from.

If you want to save  the source prior to deleting it,  consider the use
of the  Source Archive (SRCARC)  tool which will archive  the source if
the  archive version  is not  current.  If  the source  is needed after
you have removed the member  with a command such as DLTPGMSRC,  you can
retrieve the last captured version with the WRKSRCARC command.

The  SRCARC tool  provides a  more  efficient method  of retaining  and
backing  up source than  normal source members.   Normal source members
require a  member header,  a  minimum amount  of allocated  space,  and
require  a slower  backup  process.   The  SRCARC  tool compresses  the
source and stores all data in a single member.

DSPLSTUSE escape messages you can monitor for
---------------------------------------------

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

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

   LIB           The library to print a listing of objects from.

   OMITDAYS      An  option  to omit  objects  if they  have  been used
                 within the  number of  days specified.   Objects  that
                 have never been used are always listed.

                 The default is  *NONE meaning all objects  are listed.

                 If a  value is entered, the only  objects that will be
                 listed  are those  that have  never been  used or last
                 used prior to the number of days specified.

   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
------------

None.

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

The following TAA Tools must be on your system:

     ADDDAT          Add date
     CVTDAT          Convert date
     EDTVAR          Edit variable
     RTVDBFA         Retrieve data base file attributes
     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
   ------        ----    ---------      ----------    ----------

   DSPLSTUSE     *CMD                   TAAOBLF       QATTCMD
   TAAOBLFC      *PGM       CLP         TAAOBLFC      QATTCL
   TAAOBLFC2     *PGM       CLP         TAAOBLFC2     QATTCL
   TAAOBLFR      *PGM       RPG         TAAOBLFR      QATTRPG