The Display Object 2 command provides a subfile display of one or
more objects. The display format is similar to WRKOBJ, but supports
only a single option 5=Display. This invokes the TAA DSPOBJD2
command which provides other display options such as DSPOBJAUT and
the F8 option which changes based on the object type to allow a
display of additional details. The QGYOLOBJ and QGYGTLE APIs are
The advantage of DSPOBJ2 is that only 'display' functions are
provided for users who need a general object display, but should not
be authorized to change functions.
DSPOBJ2 is also helpful for a quick review of what exists by library,
by object type, by generic name, etc.
A typical command would be:
All objects starting with the generic name on the library list would
Option 5 may be used for the DSPOBJD2 command. This will display
high level details of the object. F8 may be used to display further
information about the specific object type.
DSPOBJ2 escape messages you can monitor for
None. Escape messages from based on functions will be re-sent.
DSPOBJ2 Command parameters *CMD
OBJ The qualified name of the object to be displayed. A
generic name may be entered.
The library value defaults to *LIBL. A specific
library or *CURLIB may also be used.
OBJTYPE A list of up to 300 object types to be displayed.
The default is *ALL. For a list of the specific
values, use the prompter.
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
*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
ASP Device name. 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. Specifies that only the
*ASP = Specifies that only the single auxiliary
storage pool (ASP) device named in element 1 is to
*ASPGRP = Specifies that the entire group of the
primary auxiliary storage pool (ASP) device named in
element 1 is to be searched.
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CHKALLOBJ Check *ALLOBJ special authority
CHKOBJ3 Check object 3
DSPOBJD2 Display Object Description 2
RTVASPSTS Retrieve ASP status
RTVLCKEXCL Retrieve lock exclusive
SNDESCINF Send escape information
SNDESCMSG Send escape message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPOBJ2 *CMD TAAOBMP QATTCMD
TAAOBMPC *PGM CLP TAAOBMPC QATTCL
TAAOBMPC2 *PGM CLP TAAOBMPC2 QATTCL
TAAOBMPC3 *PGM CLP TAAOBMPC3 QATTCL
TAAOBMPR *PGM RPG TAAOBMPR QATTRPG
TAAOBMPR2 *PGM RPGLE TAAOBMPR2 QATTRPG
TAAOBMPD *FILE DSPF TAAOBMPD QATTDDS