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.
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
|
