The Compare Library  Object Authorities command compares the  output of
two uses of  CVTLIBOBJA and prints a list of  differences.  This may be
used  to compare  the authorizations  between what  should be  the same
library  on   different  systems   or   a  previous   version  of   the
authorizations from the same library.

Assume  you want  to  capture  the authorizations  to  the objects  one
month  and  then  compare  them  to  the  same  authorizations for  the
current  month.   During  each  month  you  would  use  the  CVTLIBOBJA
command such as:

             CVTLIBOBJA    LIB(xxx) OUTLIB(yyy) OUTMBR(MTHnn)

CVTLIBOBJA creates one  record for each user authorized  to each object
in a library or libraries.

You would then compare using:

             CMPLIBOBJA    FROMLIB(yyy) TOLIB(yyy)
                             FROMMBR(MTHnn) TOMBR(MTHnn)

A  spooled file would be  displayed with the results.   Both files have
the same key  structure.  Records  are attempted to be  matched in  the
'From member' to  the 'To member' and  then attempted to be  matched in
the 'To member' to the 'From member'.

Records in the 'From Member' are read first.

  **   If the  object in the  'From member' does  not exist in  the 'To
       member',  the 'From  member' record  is described  with an error
       indication.

  **   If the  user authorized to  the object in  the 'From member'  is
       not  authorized to  the object  in  the 'To  member', the  'From
       member' record is described with an error indication.

  **   If  the owner, authorization  list, or authority  (such as *USE)
       differs between the 'From member'  and the 'To member'  records,
       both objects  are listed and  the appropriate field  is flagged.

  **   If one  of the objects is specified  with a 'USER DEF' authority
       and differences exist,  both records are  listed along with  the
       individual differences and an error indication.

Records in the 'To Member' are then read.

  **   If the  object in the  'To member' does  not exist in  the 'From
       member',  the  'To member'  record  is described  with  an error
       indication.

  **   If  the user who is authorized to  the object in the 'To member'
       is not authorized  to the object in  the 'From member', the  'To
       member' record is described with an error indication.

CVTLIBOBJA escape messages you can monitor for
----------------------------------------------

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

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

   FROMLIB       The  'From'  library  containing the  LIBOBJAUTP  file
                 with  the records  created by the  CVTLIBOBJA command.

   TOLIB         The 'To' library containing  the LIBOBJAUTP file  with
                 the records created by the CVTLIBOBJA command.

   FROMMBR       The member  of the LIBOBJAUTP  file in the  FROMLIB to
                 be used.  The default is *FIRST.

   TOMBR         The member  of the LIBOBJAUTP file in  the TOLIB to be
                 used.  The default is *FIRST.

   OUTPUT        How to output the results.   The default is *  meaning
                 to  display the  results  if  the command  is  entered
                 interactively.  The spooled file is then deleted.

                 If  the  command runs  over  large  libraries, it  may
                 take a long time and should be submitted to batch.

                 If  run  in batch  or *PRINT  is specified,  a spooled
                 file is output.

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

You must have *ALLOBJ special authority to use CMPLIBOBJA.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTDAT          Convert date
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion 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
   ------        ----    ---------      ----------    ----------

   CMPLIBOBJA    *CMD                   TAASEFN       QATTCMD
   TAASEFNC      *PGM       CLP         TAASEFNC      QATTCL
   TAASEFNR      *PGM       RPG         TAASEFNR      QATTRPG