The Convert  Object Authority  Description command converts  individual
authorities to  an authority description of *ALL,  *USE, *CHANGE, 'USER
DEF',  or *EXCLUDE.  This  can be helpful when  dealing with an outfile
such as that used by DSPUSRPRF TYPE(*OBJAUT).

For a similar function for IFS authorities, see CVTIFSDAUT.

A typical series of commands would be:

             DCLF       FILE(QADSPUPA)
             DCL        &OBJAUT *CHAR LEN(10)
             DSPUSRPRF  USRPRF(xxx) TYPE(*OBJAUT) OUTPUT(*OUTFILE) +
                          OUTFILE(QTEMP/OBJAUTP)
             OVRDBF     FILE(QADSPUPA) TOFILE(QTEMP/OBJAUTP) +
                          SECURE(*YES)
             RCVF
             MONMSG     MSGID(CPF0864) EXEC(GOTO ENDFILE)
             CVTOBJAUTD OBJOPR(&OAOPR) +
                          OBJMGT(&OAMGT) +
                          OBJEXIST(&OAEXS) +
                          OBJALTER(&OALT) +
                          OBJREF(&OAREF) +
                          OBJREAD(&OAREAD) +
                          OBJADD(&OADD) +
                          OBJUPD(&OUPD) +
                          OBJDLT(&OADLT) +
                          OBJEXEC(&OAEXEC) +
                          OBJEXCLUDE(&OAEXCL) +
                          OBJAUT(&OBJAUT)

The return  value  &OBJAUT would  contain  *ALL, *USE,  *CHANGE,  'USER
DEF', or *EXCLUDE.

CVTOBJAUTD escape messages you can monitor for
----------------------------------------------

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

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

   OBJOPR        A  X  or  blank  to describe  the  object  operational
                 authority.

   OBJMGT        A  X  or  blank  to  describe  the  object  management
                 authority.

   OBJEXIST      A  X  or  blank  to  describe  the   object  existence
                 authority.

   OBJALTER      A X or  blank to describe the  object alter authority.

   OBJREF        A  X   or  blank  to  describe  the  object  reference
                 authority.

   OBJREAD       A X or  blank to describe  the object read  authority.

   OBJADD        A X or blank to describe the object add authority.

   OBJUPD        A  X   or  blank   to  describe   the  object   update
                 authority.

   OBJDLT        A   X  or   blank  to   describe  the   object  delete
                 authority.

   OBJEXEC       A   X  or  blank  to  describe  the  object  execution
                 authority.

   OBJEXCLUDE    A  X   or  blank  to   describe  the  object   exclude
                 authority.

   OBJAUT        The  return description  which  will be  one of  *ALL,
                 *USE,  *CHANGE, 'USER  DEF', or  *EXCLUDE.  This  is a
                 required return  variable  that must  be  declared  as
                 *CHAR LEN(10).


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

Because CVTOBJAUTD  returns a  variable, it may  only be  used in  a CL
type program.

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

The following TAA Tools must be on your system:

     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   CVTOBJAUTD    *CMD                   TAASEKW       QATTCMD
   TAASEKWC      *PGM       CLP         TAASEKWC      QATTCL