The QRPLOBJ library contains  old versions of replaced objects  such as
programs,  commands, and files.   It  is automatically cleared  at each
IPL.

You  may also  clear QRPLOBJ  with the  CLRLIB command.   Clearing with
the CLRLIB command  should only be  done when you know  that no one  is
using an  old version  of a replaced  object.  If  a user  is currently
using  an object which is  deleted by CLRLIB, the  user will receive an
escape message and his job will probably be aborted.

The most  typical  case  where a  problem  may occur  is  with  program
objects.   Program  objects  can be  replaced while  they  are in  use.
Anyone  using the old  version will continue  to do so  even though the
old version  is placed  in QRPLOBJ.   Deleting  one of  these 'in  use'
objects will most  likely cause a  problem.  Program objects  are never
locked  so  there is  no  good  method of  determining  that a  program
object is in use.

The  purpose  of  the  DLTOLDQRPL  command is  to  allow  you  to clear
QRPLOBJ with  less concern over  users who  might be  using one of  the
objects.   It allows  you to specify  how many hours  old an  object in
QRPLOBJ must be before it is deleted.

DLTOLDQRPL  is  designed for  those  environments where  IPL  is rarely
done, but periodic cleanup is needed.

A typical command would be entered as:

        DLTOLDQRPL  HOURS(10)

Any objects which had  been placed in QRPLOBJ  over 10 hours ago  would
be deleted.  Only the common object types are supported.

To use DLTOLDQRPL,  you must have *ALLOBJ authority  (Program adopt may
be used).

Implementation method
---------------------

DLTOLDQRPL  gets  an  outfile  of  objects  in  QRPLOBJ.    The  change
date/time of the  object in  QRPLOBJ is  the time it  was moved  there.
This  time  is  compared against  the  HOURS  value  specified  on  the
command and the objects are deleted as needed.

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

   HOURS         The  numbers of  hours that  an  object must  exist in
                 QRPLOBJ  before  it is  deleted.   The default  is 10.
                 Any objects newer  than 10 hours  would remain.  If  a
                 value is entered, it must be between 1 and 999.

   LIB           The  library to clear  the objects  from.   QRPLOBJ is
                 the default.

                 If  IASPs are  used, a  different QRPLOBJ  library may
                 be named such as QRPLOBJ033.

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

You must have  *ALLOBJ authority to use  DLTOLDQRPL (Program adopt  may
be used).

Only the  common object types are  deleted.  Messages appear  for those
object types that must be deleted manually.

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

The following TAA Tools must be on your system:

     CLCDATDIF    Calculate date difference
     CLCTIMDIF    Calculate time difference
     EDTVAR       Edit variable
     RTVDAT       Retrieve date
     SNDCOMPMSG   Send completion message
     SNDDIAGMSG   Send diagnostic message
     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
   ------        ----        ---------      ----------    ----------

   DLTOLDQRPL    *CMD                       TAASYSH       QATTCMD
   TAASYSHC      *PGM           CLP         TAASYSHC      QATTCL