TAA Tools
CVTLIBAUT       CONVERT LIBRARY AUTHORITY              TAASEII

The Convert  Library Authority  command converts  the object  authority
information  of one, all  or generic objects  within a library  and the
library  object to an  outfile.  The  system command DSPOBJAUT operates
on only  a single  object.  The  outfile name  is OBJAUTP.   The  model
file is QAOBJAUT in QSYS with a format name of QSYDSAUT.

See the PRTLIBAUT  tool for a simple means  of printing the authorities
with selection.

See  the CVTLIBAUT2 tool for converting  authorities to library objects
(not the objects within a library).

A typical command would be:

             CVTLIBAUT    LIB(xxx) OUTLIB(QTEMP)

If  you  have  *ALLOBJ  special  authority,  all  authorities  will  be
converted.  If  you do not have  *ALLOBJ special authority, not  all of
the information  may be converted (objects are  bypassed if you are not
authorized).

OBJAUTP outfile
---------------

The file will  contain one record  for each object  that describes  the
*PUBLIC authority.   There will  also be one  record for each  user who
is authorized (including the owner).

Contrast with CVTLIBAUT2
------------------------

The  CVTLIBAUT2  command   provides  similar  information  for  library
objects  (not the  objects within the  library).  For  example, you can
output the  authorities for  all libraries,  user libraries,  libraries
on the user library list, etc.

CVTLIBAUT escape messages you can monitor for
---------------------------------------------

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

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

   LIB           The library containing the objects.

   OBJ           The object to  be converted.  The default  is *ALL for
                 all  objects in  the  library.   An object  or generic
                 object may also be named.

   OBJTYPE       The object  type  to be  converted.   The  default  is
                 *ALL.   A  specific object  type  may be  named.   The
                 command prompt includes the valid object types.

   OBJATTR       The  object attribute  to be  converted.   The default
                 is *ALL.  Object attributes such  as PF or RPG may  be
                 entered.    There  is  no  check  to  ensure  a  valid
                 attribute  exists  or  that  it  is  meaningful  if  a
                 specific object type is entered.

   OUTLIB        The  library  to  output  the OBJAUTP  file  to.   The
                 default  is *LIBL  which  may  only  be  used  if  the
                 OBJAUTP file  may be  found on the  library list.   If
                 the file does not exist, a library must be named.

   OUTMBR        The  member   to  be  written  to.    The  default  is
                 OBJAUTP.

   REPLACE       A *YES/*NO parameter for  whether to replace the  data
                 in the outfile.

                 *YES  is  the  default  which will  clear  the  member
                 before writing any records.

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

   PFTYPE        If  the object attribute  is PF,  a PFTYPE of  *DTA or
                 *SRC may be  entered to  convert only  data or  source
                 files.  The default is *ALL for all PF types.

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

None.

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

The following TAA Tools must be on your system:

      CHKALLOBJ      Check all object special authority
      EDTVAR         Edit variable
      RTVOBJLST      Retrieve object 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
   ------        ----    ---------      ----------    ----------

   CVTLIBAUT     *CMD                   TAASEII       QATTCMD
   TAASEIIC      *PGM       CLP         TAASEIIC      QATTCL
   TAASEIIP      *FILE      PF          TAASEIIP      QATTDDS
   TAASEIIL      *FILE      LF          TAASEIIL      QATTDDS

The  TAASEIIP  and TAASEIIL  files  are  used  to allow  a  program  to
process the  file in keyed  order by library, object,  and object type.
The files are created by CRTTAATOOL, but not used during CVTLIBAUT.
					

Added to TAA Productivity tools April 15, 2010


Home Page Up to Top