DSPLSTUSE       DISPLAY LAST USE                       TAAOBLF

 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

Added to TAA Productivity Tools November 15, 2005


Home Page

Powered by AS/400Powered by AS/400 Last modified on January 12, 2010 © 1995, 2010 - Jim Sloan, Inc.