The Display Generic Object command displays, prints a list, or
creates an outfile of objects. A single object, all objects, a
generic name, or a name including wild card characters may be used.
If a display is requested, an option exists to use the TAA Display
Object Description command which provides more information about the
object.
If the object name is entered with wildcards, quotes must be used
around the name such as OBJ('ab%*D*').
Performance is better if the object name has several letters before
using a wildcard (such as 'abcd%e*'). and a specific library is
named.
If an outfile is requested, the model file is TAAOBLJP with a format
name of QLIDOBJD. This is the same format as used by the DSPOBJD
model outfile QADSPOBJ.
A typical command would be:
DSPGENOBJ OBJ('ab%*D*') LIB(xxx)
Letters A-Z are folded to upper case.
The % symbol is the default for a fixed wildcard meaning any
character in that position of the object name will satisfy the
search.
The embedded * is the default for a floating wildcard. This allows
any character or characters following the fixed wildcard position to
satisfy the search if a 'D' appears later in the name.
The trailing * makes a generic like request meaning any characters
after the 'D' will satisfy the search.
The following are examples of object names that would be displayed:
ABCDE
ABCDExxx
ABCFFFFD
ABCFFFFDxx
For more examples of wildcard use, see the CMPWLDCRD tool.
The OBJ parameter is not defined as a qualified name because wildcard
characters are allowed. The LIB parameter is a separate parameter
that is required and supports the typical qualified library values.
If wildcard characters are specified, performance is better if a
value such as ABCx is entered (where x is a wildcard). This allows
the use of a DSPOBJD outfile generic request of ABC* to minimize the
number of objects in the outfile that must be checked to see if they
match the wildcard characters.
DSPGENOBJ escape messages you can monitor for
---------------------------------------------
CPF2105 A single object request is not found
CPF2123 A multiple object request is not found
TAA9895 No objects meet the selection criteria
Escape messages from based on functions will be re-sent.
DSPGENOBJ Command parameters *CMD
----------------------------
OBJ The name of the object. A specific name, *ALL, a
generic name (eg ABC*), or a name containing
wildcard characters (eg AB%*D*) may be entered A
wildcard may not be specified immediately following
a floating wildcard.
If the object name is entered with wildcards, quotes
must be used around the name such as OBJ('ab%*D*').
Any lower case letters A-Z are folded to upper case
before searching occurs.
The % symbol is the default for a fixed wildcard
meaning any character in that position of the object
name will satisfy the search.
The embedded * is the default for a floating
wildcard. This allows any character or characters
following the fixed wildcard position to satisfy the
search if a 'D' appears later in the name.
The trailing * makes a generic like request meaning
any characters after the 'D' will satisfy the
search.
The following are examples of object names that
would be displayed with a search of OBJ('ab%*D*').
ABCDE
ABCDExxx
ABCFFFFD
ABCFFFFDxx
For more examples of wildcard use, see the CMPWLDCRD
tool.
LIB The library where the object exists. *LIBL is the
default. A specific library may be entered or the
special values *USRLIBL, *CURLIB, *ALL, or *ALLUSR.
OBJTYPE The object type to be selected. The default is
*ALL. Use the prompter for a list of the supported
object types.
OBJATTR The object attribute to be selected such as CLP or
PF. Not all object types have an attribute.
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.
FIXWLDCRD The character that is the fixed wildcard. The
default is '%'.
FLTWLDCRD The character that is the floating wildcard. The
default is '*'.
OUTPUT How to output the results. * is the default which
provides an interactive display.
If the command is entered in batch or *PRINT is
specified, the DSPGENOBJ spooled file is output.
*OUTFILE may be specified to create the GENOBJP
file. The OUTLIB parameter must be specified.
OUTLIB The library to output the GENOBJP file to. The
default is blank meaning no outfile is used. A name
or the special value *LIBL may be entered if
OUTPUT(*OUTFILE) is specified. A library name must
be used if the GENOBJP file cannot be found on the
library list.
OUTMBR The member to be written to. The default is
GENOBJP.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADJVAR Adjust variable
CMPWLDCRD Compare wildcard
RTVASPSTS Retrieve ASP status
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
TRNVAL Translate value
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPGENOBJ *CMD TAAOBLJ QATTCMD
TAAOBLJC *PGM CLP TAAOBLJC QATTCL
TAAOBLJR *PGM RPG TAAOBLJR QATTRPG
TAAOBLJD *FILE DSPF TAAOBLJD QATTDDS
TAAOBLJP *FILE PF TAAOBLJP QATTDDS
|
