The Convert  Authorization  List Objects  command converts  information
about  library objects,  IFS objects, and  or *DLS  objects for  one or
more  Authorization Lists  to an outfile.   Each  object is represented
by one record which includes  the full path name.  Library  objects are
also  described  with their  library  names.    Several APIs  are  used
including QGYRATLO.

You must have *ALLOBJ special authority to use CVTAUTLOBJ.

A typical command would be:

             CVTAUTLOBJ   AUTL(xxx) FILESYS(*LIB) OUTLIB(QTEMP)

The  objects  in libraries  that  are controlled  by  the Authorization
List would be  output to  the AUTLOBJP  file in QTEMP  with one  record
per object.

Another typical command would be:

             CVTAUTLOBJ   AUTL(xxx) FILESYS(*ALL) OUTLIB(QTEMP)

By default,  all Authorization Lists owned  by QSYS are bypassed.   All
library  objects,  IFS  objects,  and  DLS  objects controlled  by  the
authorization  list  (not  owned  by  QSYS)  would  be  output  to  the
AUTLOBJP file  in QTEMP.   The full  path of each  object (up to  5,000
bytes)  would exist  in the  AOPATH field.   If  the full  path exceeds
5,000 bytes, the AOTRUN field is set to '1'.

The  CVTAUTLOBJ  data  area  is  placed  in  QTEMP  with  the following
values:

          1 - 10    Total Authorization Lists
         11 - 20    Excluded by EXCLQSYS
         21 - 30    AUTLs that control objects
         31 - 40    AUTLS with no objects being controlled

CVTAUTLOBJ escape messages you can monitor for
----------------------------------------------

      TAA9891    No records written to the output file

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

CVTAUTLOBJ Command parameters                         *CMD
-----------------------------

   AUTL          The name  or generic  name of  the Authorization  List
                 to  convert objects for.   *ALL  may be  specified for
                 all authorization lists.

   FILESYS       The file system to be used.

                 *ALL is the default for all file systems.

                 *LIB  is  the  default  for  objects within  libraries
                 except for those in QDOC.

                 *IFS may  be  specified  for IFS  objects  except  for
                 /DLS.

                 *DLS may be specified for QDLS objects.

   EXCLQSYS      A *YES/*NO  parameter for whether  Authorization Lists
                 owned by QSYS are bypassed.

                 *YES  is the  default to  not  include objects  if the
                 Authorization List is owned by QSYS

                 *NO  may   be   specified  to   include   QSYS   owned
                 Authorization Lists.

   WRTNOOBJ      A *YES/*NO  parameter for whether  Authorization Lists
                 that  do  not have  any  objects  specified should  be
                 output.

                 *NO  is the  default meaning  only those Authorization
                 Lists  that  control   objects  will  appear  in   the
                 outfile.

                 *YES  may be  specified to  provide the  normal output
                 and  in  addition if  an Authorization  List  does not
                 control any  objects one  record will  be output  with
                 ****  in the  AOITYP  field.   The identifying  fields
                 about  the Authorization List  will be  filled.  Other
                 fields will be blanks and zeros.

   OUTLIB        The  library  in  which  the  AUTLOBJP  file  will  be
                 placed.  The default  is *LIBL.  If the  AUTLOBJP file
                 does not  already exist, a library  must be specified.

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

   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 an  existing
                 file.


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

You must have *ALLOBJ special authority to use CVTAUTLOBJ.

The AOPATH field is limited to 5,000 bytes.

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

The following TAA Tools must be on your system:

     CHGOBJAUT2      Change object authority 2
     CHKALLOBJ       Check *ALLOBJ special authority
     CRTDUPPF        Create duplicate physical file
     CVTOBJD4        Convert object description 4
     EDTVAR          Edit variable
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     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
   ------        ----    ---------      ----------    ----------

   CVTAUTLOBJ    *CMD                   TAASEKN       QATTCMD
   TAASEKNC      *PGM       CLP         TAASEKNC      QATTCL
   TAASEKNR      *PGM       RPGLE       TAASEKNR      QATTRPG
   TAASEKNR2     *PGM       RPGLE       TAASEKNR2     QATTRPG
   TAASEKNP      *FILE      PF          TAASEKNP      QATTDDS