TAA Tools
CVTOBJD         CONVERT OBJECT DESCRIPTION             TAAOBLG

The  Convert Object  Description  command  is  similar to  the  DSPOBJD
function of  creating an outfile.  Unlike DSPOBJD,  an object name such
as  '*XYZ*'  may  be  specified  to output  a  record  for  any objects
containing  'XYZ'  within  the   name  field.    Selection  by   object
attribute (eg PF) or owner may also be made.

The OUTFILE  format is  the same as  that used by  DSPOBJD.   The model
file is QADSPOBJ with a format name of QLIDOBJD.

Examples:

  **   A typical command would be:

             CVTOBJD       OBJ(LIBA/'*xyz*') OUTFILE(QTEMP/ABC) +
                             OBJTYPE(*FILE)

       The  OBJ name would  be folded to  ensure upper case.   A record
       would  be  output  for  any   *FILE  objects  in  library   LIBA
       containing XYZ in the name.

  **   The following  would request a record  be output with  any files
       with XYZ in the name and a PF or LF attribute.

             CVTOBJD       OBJ(LIBA/'*xyz*') OUTFILE(QTEMP/ABC) +
                             OBJTYPE(*FILE) OBJATR(PF LF)

  **   A generic name by itself may be used such as:

             CVTOBJD       OBJ(LIBA/XYZ*') OUTFILE(QTEMP/ABC) +
                             OBJTYPE(*FILE) OBJATR(PF LF)

       A  record would be output  for any *FILE  objects beginning with
       XYZ and having an attribute of PF and LF would be output.

  **   If the  OBJ  value  contains  a  leading  asterisk,  but  not  a
       trailing asterisk (not  generic), the object name must  end with
       the value provided.

             CVTOBJD       OBJ('*XYZ') OUTFILE(QTEMP/ABC) +
                             OBJTYPE(*ALL)

       A  record would be  output for any  object types where  the name
       ends  in XYZ.   For example, XYZ  and AXYZ would  be output, but
       not XYZA.

Performance
-----------

The system does  not support a function  to access objects by  a string
within  a name  or by  attribute.   The only  function supplied  by the
system  is to access by object (could  be generic), library, and object
type.

Consequently, when requesting objects by  a string within a name or  by
attribute,  a  DSPOBJD  outfile  is created  specifying  *ALL  for  the
objects  in the named library  and the object type  requested.  CVTOBJD
then reads  the  outfile  and  re-writes the  records  that  match  the
requested string  within the  name and  the attributes  requested.   If
the  number of  objects that  must be  accessed  to create  the DSPOBJD
outfile is considerable, CVTOBJD will be a slow performer.

If  a specific  owner is  requested, the  same type of  processing must
occur.

If you need  all or  generic objects without  a selection by  attribute
or owner, use DSPOBJD instead of CVTOBJD.

CVTOBJD escape messages you can monitor for
-------------------------------------------

      TAA9891    No objects were output

Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   OBJ           A  two part parameter  for the  object and  library to
                 be converted.

                 The  object  name  to be  searched  for  is  the first
                 part.  A specific name  (XYZ), a generic name  (XYZ*),
                 a search string ('*xyz*'), or *ALL may be entered.

                 A  search string  such as  '*xyz*' will  be folded  to
                 upper  case  and  will  find  any  objects  containing
                 'XYZ' in the object name.

                 A search string such as  '*xyz' will find any  objects
                 ending in XYZ such as XYZ or AXYZ, but not XYZA.

                 A value  of '**'  is invalid.   There must  be one  or
                 more characters between the asterisks.

                 The  library  name where  the  objects  reside is  the
                 second  part.    A  specific  library  or  the special
                 values  *LIBL, *USRLIBL,  *CURLIB,  *ALL,  or  *ALLUSR
                 may be entered.

   OUTFILE       The qualified  name of the  outfile to be  written to.

                 The  default library is  *LIBL which may  only be used
                 if the outfile  already exists.   The named file  must
                 have the same  level ID as the QADSPOBJ  file in QSYS.

                 If the  file does not exist, it  will be created using
                 the DSPOBJD model file  (QADSPOBJ) with a format  name
                 of QLIDOBJD.

                 Other  valid  library qualifiers  include  a  specific
                 name or *CURLIB.

   OBJTYPE       The  object  types to  be  selected.   The  default is
                 *ALL.    Use  the prompter  for  a list  of  the valid
                 object types.  Up to 100 values may be entered.

   OBJATR        The object  attributes to  be selected.   The  default
                 is *ALL.   Up to 100 values may be  entered.  There is
                 no checking of the values entered.

   OWNER         The owner to select.  *ALL is the default.

                 A specific owner may be named.

   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.

   MBR           The  name of the data base  file member to receive the
                 output.  A list of 2 elements is entered.

                 The first  element is the  member name.   The  default
                 is *FIRST.  A specific member may be named.

                 The  second element  determines whether  to clear  the
                 member  before  writing  records.    *REPLACE  is  the
                 default to clear the member.

                 *ADD may be specified to  add records to the  existing
                 data.

Restrictions
------------

None.

Prerequisites
-------------

The following TAA Tools must be on your system:

     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RSNLSTMSG       Resend last message
     RTVFMT          Retrieve format
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     TRNVAL          Translate value

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CVTOBJD       *CMD                   TAAOBLG       QATTCMD
   TAAOBLGC      *PGM       CLP         TAAOBLGC      QATTCL
   TAAOBLGR      *PGM       RPG         TAAOBLGR      QATTRPG
   TAAOBLGP      *FILE      PF          TAAOBLGP      QATTDDS
					

Added to TAA Productivity tools July 15, 2006


Home Page Up to Top