The Print Last Use command prints a listing of the objects that have
not been used for a specified number of days. It is useful in
assisting in cleaning up your system for unused objects.
A typical command is entered as:
PRTLSTUSE LIB(xxxxx) OMITDAYS(100)
This prints a listing of all objects in the specified library that
have not been used in the last 100 days.
It is possible to reset the count of the 'days used', but the 'date
of last usage' will remain.
Various options exist for sorting and selection. The usage count is
also shown. The usage count can be misleading for multi-member files
such as source files. The system does not keep track at an object
level, but rather at a member level. When object level information
is shown, the usage count is the sum of the member usage counts. The
date of last usage reflects the member which was last used.
This is a slow running command and should be submitted to batch.
There are companion commands PRTUSECNT, PRTLSTCHG, and PRTCRTDAT that
allow operations by the usage count value, last change date, and
create date.
Command parameters *CMD
------------------
LIB A single library may be specified or the special
values *LIBL, *USRLIBL, *CURLIB or *ALLUSR.
OMITDAYS The number of days you want to omit before the
object was used. The default is *NONE. If you
specify 100 and the object has been used in the last
100 days, it will not appear in the report. This is
the 'omit before' date. It allows you to avoid
seeing any objects that have recently been used.
Objects which have never been used since Release
V1R3 was installed are blank in this field and will
appear in the report.
OMITDAYSA The number of days you want to omit after the object
was used. The default is *NONE. If you specify 100
and the object was last used over 100 days ago, it
will not appear in the report. This is the 'omit
after' date. It allows you to see only those that
have recently been used.
Objects which have never been used since Release
V1R3 was installed are blank in this field and will
not appear in the report. Both OMITDAYS and
OMITDAYSA cannot be specified on the same use of
PRTLSTUSE.
TYPE The type of report *OBJ or *MBR. TYPE(*OBJ) is the
default and shows each object and it's use count.
Members are not considered.
TYPE(*MBR) shows only members which have not been
used. See also the SRCFILES parameter to determine
if you want source files or data files included.
SEQUENCE A *YES/*NO value with *NO as the default which means
the objects will appear name within type. If *YES
is specified, the objects will appear in oldest last
used date first. Objects that have never been used
(since Release V1R3 was installed), appear first.
SRCFILES Whether source files should be included or not. The
default is *INCLUDE. The other values of *OMIT and
*ONLY can only be specified when TYPE(*MBR) is used.
*OMIT should be specified when you want to include
data files and exclude source files.
*ONLY should be specified when you want to include
source files and exclude data files.
PRTFILE The qualified name of the printer file to be used.
The default is QPRINT in *LIBL. The spooled file
name is the name of the LIB parameter.
Restrictions
------------
Any objects that have not been used since Release V1R3 was installed,
do not show the correct information.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADDDAT Add 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
------ ---- --------- ---------- ----------
PRTLSTUSE *CMD TAAOBJE QATTCMD
TAAOBJEC *PGM CLP TAAOBJEC QATTCL
TAAOBJER *PGM RPG TAAOBJER QATTRPG
|
