The Check Old  Objects command prints a  list of objects that  have not
been used  since a specified use date.   A list of object  types may be
entered.    A  list  of  libraries  (including  generic)  or  all  user
libraries may be specified along with an omit list.

An outfile of  the old objects  is optional.   If requested, the  model
file  used is  the  same as  the  DSPOBJD model  file  QADSPOBJ with  a
format  name of  QLIDOBJD.   The  field ODSV10  will contain  the value
OLDOBJ.

A typical command would be:

           CHKOLDOBJ   LIB(LIBA LIBB LIBC) USEDATE(nnnnnn)

The use date  would be entered in  job format.   Any objects that  have
not been used prior to the date specified would be listed.

If an object  has never been used and  the create date is  prior to the
specified date, the object is also listed.

Another typical command would be:

           CHKOLDOBJ   LIB(*ALLUSR) USEDATE(nnnnnn)
                        OMITLIBS(LIBW LIBZ)

All  user  libraries  would be  checked.    The  TAATOOL and  TAASECURE
libraries would be  implicitly omitted  along with  libraries LIBW  and
LIBZ.  You must have *ALLOBJ special authority to use *ALLUSR.

The maximum number of libraries which can be processed is 3,270.

CHKOLDOBJ escape messages you can monitor for
---------------------------------------------

      TAA9894    No objects exist to be processed.

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

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

   LIB           A list  of  libraries (up  to 40)  to be  checked.   A
                 generic  library name  may  be entered.    The special
                 value *ALLUSR may be used for all user libraries.

                 You  must  be  authorized to  each  library specified.
                 If  *ALLUSR  is  specified,  you  must   have  *ALLOBJ
                 special authority.   The definition of  *ALLUSR is the
                 same  as that  defined for  SAVLIB LIB(*ALLUSR).   The
                 libraries  TAATOOL   and  TAASECURE   are   implicitly
                 bypassed if *ALLUSR is specified.

   USEDATE       The date  to compare the  objects 'last use  date' to.
                 The  date  must be  entered  in job  format.    If the
                 object has  never been  used and  the create  date  is
                 prior  to  the  date specified,  the  object  is  also
                 listed.

   OBJTYPE       The object  types to be  considered.  A list  of up to
                 10  object  types  may  be entered.    The  default is
                 *ALL.  See the  command prompt for the complete  list.

   OMITLIBS      A  list of  up to  40 libraries  that may  be omitted.
                 The  list is  checked  against any  library processed.
                 If  LIB(*ALLUSR)   is  specified,   the  TAATOOL   and
                 TAASECURE libraries are implicitly omitted.

   OUTPUT        How  to output  the results.   *PRINT  is the  default
                 and  causes only  spooled file  output.   *OUTFILE may
                 be entered  to  also  output an  outfile  of  the  old
                 objects.  The outfile is named CHKOLDP.

   OUTLIB        The  library  in  which  the   file  CHKOLDP  will  be
                 placed.   The default is  *LIBL.  If  the CHKOLDP file
                 does  not  already  exist, a  library  must  be named.
                 The model file used  is the same as the  DSPOBJD model
                 file  QADSPOBJ with a  format name  of QLIDOBJD.   The
                 field ODSV10 will contain the value OLDOBJ.

   OUTMBR        The  member  of the  CHKOLDP  file  to be  used.   The
                 default is CHKOLDP.  If  the member does not exist  it
                 is added.

   REPLACE       A  *YES/*NO value  for whether  the  member should  be
                 cleared before  writing records into it.   The default
                 is *YES.

                 *NO may be  specified to add  records to any  existing
                 data.

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

If specific or generic  libraries are specified, the maximum  number of
libraries which can be processed is 998.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check all object
     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVDAT          Retrieve date
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   CHKOLDOBJ     *CMD                   TAALICG       QATTCMD
   TAALICGC      *PGM       CLP         TAALICGC      QATTCL
   TAALICGC2     *PGM       CLP         TAALICGC2     QATTCL
   TAALICGR      *PGM       RPG         TAALICGR      QATTRPG