The  Convert IFS  entry  authority  command converts  detail  authority
information  of  a  single  IFS  object  to  a  data  base  file  named
IFSEAUTP.   The file can then be  processed by user written programs to
extract  desired   information.     See  the   CVTIFSAUT  command   for
converting authorities for more than a single object.

The  name of  the model  files used  by CVTIFSEAUT  is TAAIFSPP  with a
format name of IFSEAUTR.  To see a description of the format, enter:

        DSPFMT      TAAIFSPP

You  must have  use authority  to the  TAACVTIFS authorization  list to
use CVTIFSEAUT.

The API used is Qp01GetAttr.

A typical command would be:

        CVTIFSEAUT  OBJ('/home/mydir/mydoc.txt') OUTLIB(xxx)

Security discussion
-------------------

The CVTIFSEAUT  command and  programs  must be  run by  a user  who  is
authorized  to  the TAACVTIFS  authorization  list.   This  allows  the
command  to adopt authority  during execution so  that authority errors
can be avoided.

You are responsible for controlling who is authorized to TAACVTIFS.

The program adopt function does not  operate on IFS objects.   However,
using program  adopt allows  the program  to swap  the current  profile
for QSECOFR  during the running of  the command and then  swaps back to
the  original  using  profile  when the  command  completes.   Swapping
occurs by the use of an API.

The swapping  of profiles  avoids  conversion problems,  but creates  a
problem  in that the  user could  use system  request to  'end request'
during  the running of  the command and henceforth  operate as QSECOFR.
This is  avoided by making  the CL  program a  'request processor'  and
monitoring for  'end request'.   If 'end request'  occurs, the  swap of
profiles occurs back to the original profile.

CVTIFSEAUT escape messages you can monitor for
----------------------------------------------

      CPFA0A9    Object not found.

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

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

   OBJ           The  path name  of the  object to  be converted.   The
                 object path  name can  be either  a simple  name or  a
                 name  that   is  qualified  with   the  name   of  the
                 directory in which the object is located.

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

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

   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
                 member.

   USRPRF        The user  profile that will be  switched to during run
                 time.   QSECOFR  is the  default.   For  file  systems
                 (such as QNTC),  CVTIFS will fail if QSECOFR  does not
                 exist.

                 *CURRENT may  be used or a specific  user profile, but
                 the profile must have *ALLOBJ special authority.

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

You  must have  use authority  to the  TAACVTIFS authorization  list to
use CVTIFSEAUT.

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

The following TAA Tools must be on your system:

     CRTDUPPF        Create duplicate PF
     RTVSYSVAL3      Retrieve system value 3
     SNDESCMSG       Send escape message
     SNDCOMPMSG      Send completion message

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

None, the tool is ready to use.

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

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

   CVTIFSEAUT    *CMD                   TAAIFSP       QATTCMD
   TAAIFSPC      *PGM    CLP            TAAIFSPC      QATTCL
   TAAIFSPR      *PGM    RPGLE          TAAIFSPR      QATTRPG
   TAAIFSPP      *FILE   PF             TAAIFSPP      QATTDDS