The Convert Object Description 5 command provides an outfile for most
of the fields created by DSPOBJD and adds large fields for the object
and save size values to allow for 15 and 20 digit fields. Edited
values are also provided as separate fields. This provides a simple
means of working with large sizes. The model file is TAAOBLZP with a
format name of QLIDOBJD.
The QUSLOBJ API is used to access the information.
A typical command would be:
CVTOBJD5 OBJ(xxx/*ALL) OUTFILE(xxx/yyy)
All objects in the named library would be converted so that one
record per object would appear in the outfile. The ODBPUN (bytes per
unit) would be multiplied by the ODSIZU (size per unit) to create the
additional object size fields. The ODSBPU (bytes per save unit)
would be multiplied by the ODSSSZ (size per save unit) to create the
additional save object size fields.
A subroutine is used to edit the fields.
Additional fields
-----------------
The additional fields would be:
Name Def Description
------ ---- ------------------------------------
ODSZ15 15 0 Object size as 15 digits
ODSZ20 20 0 Object size as 20 digits
ODSS15 15 0 Save object size as 15 digits
ODSS20 20 0 Save object size as 15 digits
ODSE10 13 Edited object size of 10 digits
ODSE15 19 Edited object size of 15 digits
ODSE20 25 Edited object size of 20 digits
ODES10 13 Edited save object size of 10 digits
ODES15 19 Edited save object size of 15 digits
ODES20 25 Edited save object size of 20 digits
If the object size exceeds 10 digits, the ODOBSZ field is returned as
0. If the object size exceeds 15 digits, the ODOBSZ and ODSZ15
fields are returned as 0.
If the save object size exceeds 10 digits, the ODSSZU field is
returned as 0. If the save object size exceeds 20 digits, the ODSSZU
and ODSS15 fields are returned as 0.
Considerations
--------------
The following fields are returned as blanks (not supported):
ODSVMR An indication of more than 10 save volumes
ODOBLK Locked
ODOBDM Damaged
CVTOBJD5 escape messages you can monitor for
----------------------------------------------
None. Escape messages from based on functions will be re-sent.
CVTOBJD5 Command parameters *CMD
---------------------------
OBJ The qualified object name to be output. The object
name can be generic or the special value *ALL.
The library value defaults to *LIBL. The other
special values that may be entered are *USRLIBL,
*CURLIB, *ALL, or *ALLUSR.
OUTFILE The qualified name of the outfile to be written.
Any name may be used.
The library defaults to *LIBL. A specific library
or *CURLIB must be used if the file does not exist.
OUTMBR The member of the outfile to be written to. The
default is *FIRST.
REPLACE A *YES/*NO value for whether to clear the member
before writing any data. *YES is the default which
causes the member to be cleared.
*NO may be specified to add records to the existing
member.
OBJTYPE The object type to be converted. The default is
*ALL for all object types. See the prompter for the
list of supported values.
Restrictions
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
CVTDTS Convert DTS format
DUPTAADBF Duplicate TAA data base file
EDTVAR Edit variable
RTVDAT Retrieve date
RTVFMT Retrieve format
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
TAAEXC TAA Execute command
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CVTOBJD5 *CMD TAAOBLZ QATTCMD
TAAOBLZC *PGM CLP TAAOBLZC QATTCL
TAAOBLZR *PGM RPG TAAOBLZR QATTRPG
TAAOBLZP *FILE PF TAAOBLZP QATTDDS