The Print by Create User command prints the objects in one or more
libraries by the user who created the object. This may not be the
current owner of the object. The user who created the object may not
exist on your system. Selection can be used on a minimum create
date, a minimum last used date, and the size of the object.
PRTCRTUSR can be helpful in cleaning up the system if group profiles
own most of the objects.
You must have *ALLOBJ special authority to describe a library of *ALL
or *ALLUSR.
A typical command would be:
PRTCRTUSR LIB(*ALLUSR) SELUSEDAYS(180)
A listing would be produced by create user of all objects in user
libraries that have have never been used or not used in the last 180
days.
You may also select on the create date and the size of the object.
All selection criteria must be satisfied to list the object.
PRTCRTUSR escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
LIB The library or libraries to be scanned. A list of
to 300 libraries may be entered. A generic name may
be used or the special values *LIBL, *USRLIBL,
*CURLIB, *ALL, or *ALLUSR.
You must have *ALLOBJ special authority to specify
*ALL or *ALLUSR.
ASPDEV Specifies the auxiliary storage pool (ASP) device
name where storage for the library containing the
object is allocated. If the library resides in an
ASP that is not part of the thread's library name
space, this parameter must be specified to ensure
the correct library is searched.
This parameter can be specified as a list of two
values (elements) or as a single value. The
possible single values are:
* = The ASPs that are currently part of the thread's
library name space will be searched to locate the
library. This includes the system ASP (ASP 1), all
defined basic user ASPs (ASPs 2-32), and, if the
thread has an ASP group, the primary and secondary
ASPs in the thread's ASP group.
*ALLAVL = All available ASPs will be searched. This
includes the system ASP (ASP 1), all defined basic
user ASPs (ASPs 2-32), and all available primary and
secondary ASPs, (ASPs 33-255) with a status of
'Available'.
*CURASPGRP = If the thread has an ASP group, the
primary and secondary ASPs in the thread's ASP group
will be searched to locate the library. The system
ASP (ASP 1) and defined basic user ASPs (ASPs 2-32)
will not be searched. If no ASP group is associated
with the thread, an error will be issued.
*SYSBAS = The system ASP (ASP 1) and all defined
basic user ASPs (ASPs 2-32) will be searched to
locate the library. No primary or secondary ASPs
will be searched even if the thread has an ASP
group.
Element 1: Device
The device name of the primary or secondary ASP to
be searched. The primary or secondary ASP must have
been activated (by varying on the ASP device) and
have a status of 'Available'. The system ASP (ASP
1) and defined user basic ASPs (ASPs 2-32) will not
be searched.
Element 2: Search type
*ASP = Specifies that only the single auxiliary
storage pool (ASP) device named in element 1 is to
be searched.
*ASPGRP = Specifies that the entire group of the
primary auxiliary storage pool (ASP) device named in
element 1 is to be searched.
LIBTYPE The type of library to be processed. The default is
*ALL for both production and test.
*PROD may be used for just production libraries.
*TEST may be used for just test libraries.
OMITLIB A list of up to 300 libraries (including generic
names) to be omitted.
An omit list may not be entered for LIB(*CURLIB).
Any library entered is checked for existence.
No check occurs to see if an omit library would have
been selected. For example, if LIB(*LIBL) is
entered with OMITLIB(ABC) and library ABC is not on
the library list, no error occurs.
CRTUSR The create user to print the objects for. The
default is *ALL. A specific name or a generic name
may be entered.
SELCRTDAYS The number of days since the object was created to
select on. The default is 0, meaning the create
date is not considered for selection.
A specific number of days may be entered. Based on
the number entered, a date in the past is
determined. All objects created on or after that
date are considered for selection. For example, if
30 is entered, all objects created within the last
30 days will be considered.
SELUSEDAYS The number of days since the object was last used to
select on. The default is 0, meaning the last used
date is not considered for selection.
A specific number of days may be entered. Based on
the number entered, a date in the past is
determined. All objects that have never been used
or last used on a date that is less than or equal to
the determined date are considered for selection.
For example, if 30 is entered, all objects that have
not been used in the last 30 days will be
considered.
SELSIZE The size of the objects to be selected. The default
is 0 meaning that any size is considered for
selection.
To select on size, enter a number in bytes. All
objects greater than or equal to the number entered
will be considered for selection.
Restrictions
------------
You must have *ALLOBJ special authority to specify *ALL or *ALLUSR.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADDDAT Add date
CHKALLOBJ Check *ALLOBJ special authority
CHKDUPLST Check duplicate list
CHKGENERC Check generic
CHKGENOBJ Check generic object
CHKOBJ3 Check object 3
CVTDAT Convert date
CVTLIBOBJD Convert library object description
DUPTAADBF Duplicate TAA data base file
EXTLST Extract list
EXTLST2 Extract list 2
RTVSYSVAL3 Retrieve system value 3
RTVUSRTXT Retrieve user text
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
SNDSTSMSG Send status message
SORTDBF Sort data base file
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
PRTCRTUSR *CMD TAASEGA QATTCMD
TAASEGAC *PGM CLP TAASEGAC QATTCL
TAASEGAC2 *PGM CLP TAASEGAC2 QATTCL
TAASEGAR *PGM RPG TAASEGAR QATTRPG
|
