The Convert  IFS  Data Authority  command converts  the  output of  the
RTVIFSEAUT   or   CVTIFSEAUT   commands   individual  fields   to   the
description  for data authorities  that is seen  using WRKLNK (option 9
for Work with Authorities).   For example, if Read and Execute  are the
only  individual data  authorities  that are  specified,  *RX would  be
returned.

For a similar function for object authorities, see CVTOBJAUTD.

A typical series of commands would be:

             DCL        &READ *CHAR LEN(1)
             DCL        &ADD *CHAR LEN(1)
             DCL        &UPD *CHAR LEN(1)
             DCL        &DLT *CHAR LEN(1)
             DCL        &EXEC *CHAR LEN(1)
             DCL        &EXCLUDE *CHAR LEN(1)
             DCL        &DTAAUT *CHAR LEN(8)
              .
             RTVIFSEAUT ... READ(&READ) ADD(&ADD) UPD(&UPD) +
                              DLT(&DLT) EXECUTE(&EXEC) +
                              EXCLUDE(&EXCLUDE)
              .
             CVTIFSDAUT READ(&READ) ADD(&ADD) UPD(&UPD) +
                          DLT(&DLT) EXECUTE(&EXEC) +
                          EXCLUDE(&EXCLUDE) DTAAUT(&DTAAUT)

If  READ(X) ADD(X) UPD(X)  DLT(X) EXECUTE(X) was  specified, the DTAAUT
return parameter would contain *RWX.

Illogical requests such as READ(X)  and EXCLUDE(X) will return a  value
of 'USER DFN'.

CVTIFSDAUT escape messages you can monitor for
----------------------------------------------

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

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

   READ          An X or blank value for the read attribute.

   ADD           An X or blank value for the add attribute.

   UPD           An X or blank value for the update attribute.

   DLT           An X or blank value for the delete attribute.

   EXECUTE       An X or blank value for the execute attribute.

   EXCLUDE       An X or blank value for the exclude attribute.

   DTAAUT        The return value  for the data authority.   It must be
                 specified as  *CHAR LEN(8).  The  value will be *NONE,
                 *RWX, *RW,  *RX, *R,  *WX, *W,  *X, or  *EXCLUDE.   If
                 the input  values  cannot be  properly converted  (for
                 example  if  only READ(X)  and  DLT(X) are  specified,
                 'USER DFN' will be returned.


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

Because  the  CVTIFSDAUT command  returns a  variable, the  command may
only be used in a CL 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
   ------        ----    ---------      ----------    ----------

   CVTIFSDAUT    *CMD                   TAAIFUK       QATTCMD
   TAAIFUKC      *PGM       CLP         TAAIFUKC      QATTCL