The Display Library Size command displays or lists a summary of a
library with size and count information. One, generic, or many
libraries may be requested to be included. The library object record
is included in the size and count of objects. An outfile may also be
requested. The outfile model file in TAATOOL is TAALIDHP with a
format name of LIBSIZR.
The outfile includes many more fields than appear on the listing.
This allows you to write a simple query to include the fields you are
interested in.
You must have *ALLOBJ authority to specify a library value of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.
For libraries with a large number of objects, the conversion time to
access the information can be long. You may prefer to submit the
command to batch.
A typical command would be:
DSPLIBSIZ LIB(ABC* DEF)
One line per library would be listed for all libraries beginning with
ABC and the DEF library.
To create an outfile of the information, specify:
DSPLIBSIZ LIB(ABC* DEF) OUTPUT(*OUTFILE)
OUTLIB(QTEMP)
The same summary information would be written to the LIBSIZP file in
QTEMP. Additional fields in the output file would contain:
- the library create date
- the library save date
- the library restore date
- the most current create date of an object in the library
- the most current change date of an object in the library
- the most current use date of an object in the library
- the number of data members by type
- the number of logical files and size
- the number of physical data files and size
- the number of physical source files and size
and many more
Authorization
-------------
If a user is not authorized to an object the object may or may not be
counted (depending on the object type), but not the size information.
DSPLIBSIZ escape messages you can monitor for
---------------------------------------------
None. Escape messages from based on functions will be re-sent.
DSPLIBSIZ Command parameters *CMD
----------------------------
LIB The list of libraries to be summarized. Up to 300
libraries may be entered (including generic names)
or the special values *LIBL, *USRLIBL, *CURLIB,
*ALLUSR, *ALLUSR2, *ALLNONQ, *IBM, or ALL.
For *LIBL and *USRLIBL, if a current library exists,
it will be written as a record before the records
for the user portion of the library list. If the
current library is also part of the user portion of
the library list, it will only appear once (it is
removed from the user portion of the library list).
*ALLUSR omits certain # libraries such as #RPGLIB.
*ALLUSR also omits all Q libraries with certain
exceptions such as QGPL. See the help text for the
SAVLIB command for a complete list. Note that if
you have your own library which begins with Q, it is
omitted.
*IBM causes all libraries to be included based on
the definition for DSPOBJD LIB(*IBM).
*ALLUSR2 is similar to *ALLUSR. It omits the same #
libraries, but also omits any library beginning with
Q. Note that if you have your own library which
begins with Q, it is omitted.
*ALLNONQ means any library that does not begin with
the letter Q. If *ALLNONQ is used, the ASPDEV
parameter defaults.
QSYSLIB The name of the QSYS library. QSYS is the default.
A value such as QSYSnn may be 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.
*OUTFILE may be entered to write summary records to
the LIBSIZP file. No printed output will occur.
OUTLIB The library to output the LIBSIZP file to. The
default is *LIBL which may only be used if the
LIBSIZP file may be found on the library list. If
the file does not exist, a library must be named.
OUTMBR The member to be written to. The default is
LIBSIZP.
REPLACE A *YES/*NO parameter for whether to replace the data
in the outfile. The default is *YES. *NO may be
specified to add to the existing data.
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. If this parameter
is used when the library qualifier specified for the
Object prompt (OBJ parameter) is *CURLIB, *LIBL, or
*USRLIBL, ASPDEV(*) is the only valid value.
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.
Restrictions
------------
You must have *ALLOBJ authority to specify a library value of *ALL,
*ALLUSR, *ALLUSR2, *ALLNONQ, or *IBM.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKGENERC Check generic
CHKGENOBJ Check generic object
CVTLIBOBJD Convert library object description
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list 2
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
------ ---- --------- ---------- ----------
DSPLIBSIZ *CMD TAALIDH QATTCMD
TAALIDHC *PGM CLP TAALIDHC QATTCL
TAALIDHC2 *PGM CLP TAALIDHC2 QATTCL
TAALIDHR *PGM RPG TAALIDHR QATTRPG
TAALIDHR2 *PGM RPG TAALIDHR2 QATTRPG
TAALIDHP *FILE PF TAALIDHP QATTDDS
|
