The Convert Object Description 2 command creates the OBJDSCP outfile
of objects similar to DSPOBJD. However, the output records contain
only the object, library, and object type. The advantage of this
approach is that the system does not have to determine the size of
the objects. If a file has many members, the basic information can
be retrieved quickly.
You must have *ALLOBJ special authority to use a library qualifier of
*ALL or *ALLUSR.
The model file is TAAOBLIP with a format name of OBJDSCR.
The QUSLOBJ API is used with the OBJL0100 format.
A typical command would be:
CVTOBJD2 OBJ(LIB1/ABC*) OBJTYPE(*ALL) OUTLIB(QTEMP)
The OBJDSCP file would be created in QTEMP with one record for each
ABC object object in LIB1.
To understand the performance benefits of the command, try it on a
large source library versus the time it takes for DSPLIB.
CVTOBJD2 escape messages you can monitor for
---------------------------------------------
TAA9891 No objects output
Escape messages from based on functions will be re-sent.
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, *ALLUSR, or
*ALLIBM.
The library qualifier defaults to *LIBL. A specific
library or one of the special values *USRLIBL,
*CURLIB, *ALL, or *ALLUSR may be specified.
OUTLIB The library in which the OBJDSCP file will be
placed. The default is *LIBL. If the OBJDSCP file
does not already exist, a library must be specified.
OBJTYPE The object type to be displayed. The default is
*ALL for all object types. All of the values
supported by DSPOBJD are provided.
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.
OUTMBR The member of the OBJDSCP file to be used. If the
member does not exist, it is added. The default is
OBJDSCP.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
*NO may be specified to add records to existing
data.
Restrictions
------------
You must have *ALLOBJ special authority to use a library qualifier of
*ALL or *ALLUSR.
Prerequisites
-------------
The following TAA Tools must be on your system:
CRTUSRSPC Create user space
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CVTOBJD2 *CMD TAAOBLI QATTCMD
TAAOBLIC *PGM CLP TAAOBLIC QATTCL
TAAOBLIR *PGM RPG TAAOBLIR QATTRPG
TAAOBLIP *FILE PF TAAOBLIP QATTDDS
TAAOBLIQ *FILE PF TAAOBLIQ QATTDDS
|
