TAA Tools
CVTOBJD3        CONVERT OBJECT DESCRIPTION 3           TAAOBLU

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
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top