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:

           OALIB      Library
           OANAME     Object name
           OATYPE     Object type
           OAGRPN     Group name
           OAUSR      User

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

  **   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
                 entered.

   OBJ           The  name or generic  name of  the objects  to convert
                 authorizations  for.    The default  is  *ALL  for all
                 objects.

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

   OUTMBR        The member  of the  LIBOBJAUTP file  to be  used.   If
                 the member does  not exist, it is added.   The default
                 is LIBOBJAUTP.

   REPLACE       A  *YES/*NO  value for  whether the  member  should be
                 cleared before writing records  into it.  The  default
                 is *YES.

                 *NO  may  be  specified to  add  records  to  existing
                 data.

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

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.

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

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

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

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