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
|
