TAA Tools
CVTOBJD5        CONVERT OBJECT DESCRIPTION 5           TAAOBLZ

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
					

Added to TAA Productivity tools July 15, 2010


Home Page Up to Top