TAA Tools
CVTIFSDAUT      CONVERT IFS DATA AUTHORITY             TAAMBRI

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
					

Added to TAA Productivity tools January 15, 2013


Home Page Up to Top