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

Last modified on November 19, 2014 © 1995, 2014 - TAA Tools, Inc.