The Display Object Size command displays or lists objects and their
sizes. Selection can occur on a generic object name, object type,
object attribute, and owner. Sequencing can be requested by size.
DSPOBJSIZ provides a simple review of objects by size.
A typical command would be:
DSPOBJSIZ OBJ(xxx/*ALL) OBJTYPE(*FILE)
OBJTYPE(*PF) SEQ(*DESCEND)
The physical file objects in the named library would appear in
descending sequence by size.
DSPOBJSIZ escape messages you can monitor for
---------------------------------------------
CPF2123 No object types were found
Escape messages from based on functions will be re-sent.
DSPOBJSIZ Command parameters *CMD
----------------------------
OBJ The qualified name of the objects to be converted.
The object name may be a specific name, a generic
name, or the special values *ALL.
The library qualifier defaults to *LIBL. A specific
library, *USRLIBL, *CURLIB, *ALL, or *ALLUSR may be
entered.
OBJTYPE A list of one or more object types to be converted.
The default is *ALL for all object types. A list of
up to 100 object types may be entered. All of the
values supported by DSPOBJD are provided. Use the
prompter for the supported object types.
OBJATR A list of one or more object attributes such as PF
or RPG to be converted. *ALL is the default for all
attributes. Up to 100 attributes may be entered.
If an attribute is specified, the performance is
better if an associated object type is also
specified.
No error occurs by specifying an illogical
combination such as OBJTYPE(*FILE) and OBJATR(RPG).
OWNER The owner of the objects to select. The default is
*ALL. A specific owner may be entered.
Selection by owner occurs after the DSPOBJD outfile
has been created.
SEQ The sequence of the listing.
*DFT is the default meaning the order is the same as
the DSPOBJD outfile.
*ASCEND may be specified for ascending sequence by
size.
*DESCEND may be specified for descending sequence by
size.
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.
MINSIZE The minimum size object that must have to be listed.
The default is zero. A value may be entered between
0 and 999,999,999,999,999.
When the SEQ parameter is *ASCEND or *DESCEND, the
DSPOBJD outfile is sorted by the ODOBSZ parameter.
For very large objects, this is not the actual size
of the object, but is used as a multiplier in
conjunction with the ODBPUN field (size multiplier).
The size on the listing will be correct, but the
sequence may not be.
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.
Restrictions
------------
Sequencing occurs on the ODOBSZ field in the DSPOBJD outfile. The
listed value for size could be larger as it is based on the ODBPUN
and ODSIZU fields.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJATR Check object attribute
EXTLST Extract list
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape 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
------ ---- --------- ---------- ----------
DSPOBJSIZ *CMD TAAOBLW QATTCMD
TAAOBLWC *PGM CLP TAAOBLWC QATTCL
TAAOBLWR *PGM RPG TAAOBLWR QATTRPG
|
