CVTLIBOBJA CONVERT LIB OBJECT AUTHORIZATIONS TAASEFM
The Convert Library Object Authorities command builds an outfile of
all the authorizations to objects in one or more libraries. The
outfile may then be used for a function such as the CMPLIBOBJA or the
CHGLIBOBJA TAA Tools.
CVTLIBOBJA may be used to capture authorizations to QSYS objects
(such as commands) before a new release is installed. This would
allow the CHGLIBOBJA command to restore the authorities after the new
release is installed.
You must have *ALLOBJ authority to use CVTLIBOBJA. This ensures that
you are authorized to access all objects in a library and that all
authorizations can be converted.
The model file used is TAASEFMP which is created from the system
model file QAOBJAUT used by DSPOBJAUT. The format name is QSYDSAUT.
Unlike the system file, the TAASEFMP file is keyed and requires
unique keys. The key structure is:
OANAME Object name
OATYPE Object type
OAGRPN Group name
A typical command would be:
CVTLIBOBJA LIB(xxx) OUTLIB(yyy)
The library names would be accessed and checked.
** Because the default for LIBOBJ is *YES, the authorizations for
each library object and each object within each library would
be copied to the LIBOBJAUTP file.
** Using CVTLIBOBJA LIB(QSYS) OBJ(*ALL) OBJTYPE(*LIB) creates a
file of the authorizations to library objects.
** Using CVTLIBOBJA LIB(xx) OBJ(*ALL) OBJTYPE(*FILE) LIBOBJ(*NO)
creates a file of the file object authorizations in the
** The QTEMP library is implicitly bypassed.
*GROUP user name
The outfile will have a user name of *GROUP (in the OAUSR field) if
the user who runs CVTLIBOBJA is a member of a group and the group
name is authorized to an object in the library. The group name
appears in the OAGRPN field.
CVTLIBOBJA escape messages you can monitor for
TAA9894 One or more objects were locked.
Escape messages from based on functions will be re-sent.
Command parameters *CMD
LIB The name or generic name of the libraries to convert
authorizations for. Up to 300 library names may be
OBJ The name or generic name of the objects to convert
authorizations for. The default is *ALL for all
OBJTYPE The object type to convert authorizations for. The
default is *ALL for all object types. Use the
prompter to see the supported types.
LIBOBJ A *YES/*NO parameter for whether to output the
authorizations for the library object (*LIB) of any
libraries specified. This parameter is ignored if
OBJTYPE(*LIB) is specified.
*YES is the default to output the authorizations for
the library object.
*NO may be specified to not output the
authorizations for the library object.
OUTLIB The library in which the LIBOBJAUTP file will be
placed. The default is *LIBL. If the LIBOBJAUTP
file does not already exist, a library must be
OUTMBR The member of the LIBOBJAUTP file to be used. If
the member does not exist, it is added. The default
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
*NO may be specified to add records to existing
You must have *ALLOBJ special authority to use CVTLIBOBJA.
Library QTEMP may not be specifically named and is bypassed when part
of a generic group (QT*) or if all libraries are processed.
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKDUPLST Check duplicate list
CHKGENERC Check generic
CHKGENOBJ Check generic object
CHKOBJ3 Check object 3
CVTLIBOBJD Convert Library Object Description
DUPTAADBF Duplicate TAA Data Base File
EDTVAR Edit variable
EXTLST Extract list
EXTLST2 Extract list 2
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
SNDSTSMSG Send status message
You cannot specify a generic library name that would include QSYS.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CVTLIBOBJA *CMD TAASEFM QATTCMD
TAASEFMC *PGM CLP TAASEFMC QATTCL
TAASEFMC11 *PGM CLP TAASEFMC11 QATTCL
TAASEFMP *FILE PF TAASEFMP QATTDDS
TAASEFMQ *FILE PF TAASEFMP QATTDDS
TAASEFMQ is created from the TAASEFMP source
Added to TAA Productivity tools March 15, 2003