The Convert Object Description 3 command converts DSPOBJD information
to a subset outfile using the same field names (such as ODOBNM for
object name). Not all fields from the system file are included. The
command is intended for the case where the program is created to run
on a prior release where the DSPOBJD model file may differ and cause
a file override error in a program. A list of object attributes may
be specified.
The model file is TAAOBLUP with a format name of OBJDR.
A typical command would be:
CVTOBJD3 OBJ(xxx/*ALL) OBJTYPE(*FILE) OUTLIB(QTEMP)
One record for each *FILE object type in the specified library would
be written to the OBJDP file in QTEMP.
CVTOBJD3 escape messages you can monitor for
--------------------------------------------
CPF9893 No objects of the type specified exist
TAA9892 No objects of the attribute specified exist
Escape messages from based on functions will be re-sent.
CVTOBJD3 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, a generic library name, or the special
values *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.
An illogical set of parameters is not checked for
such as an object type of *FILE and an object
attribute of RPG.
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.
OUTLIB The library for the OBJDP file. *LIBL is the
default. A specific library must be named if the
file does not already exist.
OUTMBR The member of the OBJDP file to be used. If the
member does not exist, it is added. The default is
OBJDP.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKOBJATR Check object attribute
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list 2
RSNLSTMSG Resend last message
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
------ ---- --------- ---------- ----------
CVTOBJD3 *CMD TAAOBLU QATTCMD
TAAOBLUC *PGM CLP TAAOBLUC QATTCL
TAAOBLUR *PGM RPG TAAOBLUR QATTRPG
TAAOBLUP *FILE PF TAAOBLUP QATTDDS
|
