TAA Tools
CVTLIBOBJD      CONVERT LIBRARY OBJECT DESCRIPTION     TAALICJ

The  Convert Library  Object  Description  command builds  the  LIBOBJP
data  base file of  selected libraries (one  record per library).   You
may  specify a list of libraries  (including generic names), or use the
special  values   *LIBL,  *USRLIBL,  *CURLIB,   *ALL,  *IBM,   *ALLUSR,
*ALLUSR2 or *ALLNONQ.  An omit list may also be specified.

The default model  file used is TAALICJP with a format  of LIBRCDR.  It
is  a subset  of the  DSPOBJD outfile.   An option  exists to  make the
output file in  keyed sequence.   See the ACCPATH  parameter.  If  *KEY
is specified,  the model  file is  TAALICJQ with a  key on  the library
name field (LBLIB).

A typical command would be:

            CVTLIBOBJD  LIB(*ALLUSR) OUTLIB(xxx) OMITLIB(ABC DEF)

One  record  per library  would be  written  to the  LIBOBJP  file that
meets the criteria.

Considerations
--------------

  **   If a current library exists  for LIB(*LIBL) or LIB(*USRLIBL),  a
       record for the current  library will be written and  will appear
       before  the first  library on  the user  portion of  the library
       list.

CVTLIBOBJD escape messages you can monitor for
---------------------------------------------

      TAA9892    The 'omit library' (or generic library) does not exist
                    Is bypassed by ESCAPE(*NO)
      TAA9893    LIB(*CURLIB) specified, but no current lib exists
      TAA9894    LIB(*CURLIB) specified with an omit list
      TAA9895    No library objects meet the criteria

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

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

   LIB           The  list of  libraries to  be processed.   Up  to 300
                 libraries may  be  entered (including  generic  names)
                 or  the  special   values  *LIBL,  *USRLIBL,  *CURLIB,
                 *ALLUSR, *ALLUSR2, *ALLNONQ, *IBM, or ALL.

                 For  *LIBL and *USRLIBL, if  a current library exists,
                 it will  be written  as a  record  before the  records
                 for the  user portion  of the  library list.   If  the
                 current  library is also  part of the  user portion of
                 the library  list, it  will only  appear once  (it  is
                 removed from the user portion list).

                 *ALLUSR omits  certain  # libraries  such as  #RPGLIB.
                 *ALLUSR  also  omits  all  Q  libraries  with  certain
                 exceptions  such as QGPL.   See the  help text for the
                 SAVLIB command  for a  complete  list.   Note that  if
                 you have your  own library which begins with  Q, it is
                 omitted.

                 *IBM  causes  all libraries  to be  included  based on
                 the definition for DSPOBJD LIB(*IBM).

                 *ALLUSR2 is similar to *ALLUSR.   It omits the same  #
                 libraries, but  also omits any library  beginning with
                 Q.   Note  that  if you  have your  own  library which
                 begins with Q, it is omitted.

                 *ALLNONQ means any  library that does  not begin  with
                 the  letter  Q.   If  *ALLNONQ  is  used,  the  ASPDEV
                 parameter must use the default.

   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.

                 The 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.    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.

   ASPNBR        The  ASP  number  for the  libraries  that  are  to be
                 converted.  The default is *ALL.

                 A number  in  the range  of  1-39  may be  entered  to
                 subset the  libraries that are  output by the  LIB and
                 ASPDEV parameters.

   OUTLIB        The  library   where  the  LIBOBJP  file  will  exist.
                 *LIBL  is   the  default.     *CURLIB   may  also   be
                 specified.   If  the file  does not  exist, a  library
                 must be  specified.  The first member  is always used.

                 The  model  file  used  varies  as  described  by  the
                 ACCPATH parameter.

   REPLACE       Whether  to replace  the  data  in the  LIBOBJP  file.
                 *YES is the  default.  *NO may be  specified to add to
                 existing data.

   LIBTYPE       Whether  to select  all or  a specified  library type.
                 *ALL is the default to select all types.

                 *PROD may  be used  to select  only production  (PROD)
                 libraries.

                 *TEST  may  be   used  to  select  only   test  (TEST)
                 libraries.

   OMITLIB       A  list  of up  to  300 libraries  or  generic library
                 names that should be omitted.   *NONE is the  default.

                 An omit list may not be entered for LIB(*CURLIB).

                 If ESCAPE(*YES) is  specified, any library  entered is
                 checked  for existence unless  a non-default  value is
                 used for the ASPDEV parameter.

                 No  check occurs to see if  an omit library would have
                 been  selected.     For  example,  if  LIB(*LIBL)   is
                 entered with  OMITLIB(ABC) and  library ABC is  not on
                 the library list, no error occurs.

   ACCPATH       The  type of access  path to be used  for the outfile.
                 The outfile name  is always LIBOBJP.   The default  is
                 *ARR to  create an arrival  sequence file.   The model
                 file used is TAALICJP.

                 If *ARR  is used and specific  libraries are named for
                 the  LIB   parameter,  the   output  occurs   in   the
                 specified sequence (the  libraries may not be  in name
                 order).

                 *KEY may  be specified to create a  keyed file with an
                 access  path  on  library  name  (LBLIB  field).   The
                 model file used is TAALICJQ.

                 If  the outfile  already  exists,  it must  have  been
                 created  with the  same ACCPATH  type as  is specified
                 on the current use of CVTLIBOBJD.

   ESCAPE        A  *YES/*NO parameter  for  whether an  escape message
                 (TAA9892) should be sent if  an omit library does  not
                 exist.

                 *YES is the default to send the escape.

                 *NO may be specified to bypass the escape.

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

See the Considerations section.

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

The following TAA Tools must be on your system:

     CHKDUPLST       Check duplicate list
     CHKGENERC       Check generic
     CHKGENOBJ       Check generic object
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     EXTLST          Extract list
     RTVLIBL         Retrieve library list
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   CVTLIBOBJD    *CMD                   TAALICJ       QATTCMD
   TAALICJC      *PGM       CLP         TAALICJC      QATTCL
   TAALICJR      *PGM       RPG         TAALICJR      QATTRPG
   TAALICJP      *FILE      PF          TAALICJP      QATTDDS
   TAALICJQ      *FILE      PF          TAALICJQ      QATTDDS
					

Added to TAA Productivity tools February 28, 2000


Home Page Up to Top