TAA Tools
CVTIFSAUT       CONVERT IFS AUTHORITY                  TAAIFSR

The Convert IFS  Authority command converts  the authorities of  one or
more IFS  objects to an  outfile.  One  record is output  for each user
authorized  to an object.   The command  is helpful in  building a file
that can be analyzed.

The outfile name is  IFSAUTP.  The model  file name is TAAIFSPP with  a
format  of  IFSEAUTR.   Note  that  the  model  file  is also  used  by
CVTIFSEAUT.

CVTIFSAUT  will create  an  outfile for  multiple objects.   CVTIFSEAUT
creates an outfile  for a  single object.   You must  be authorized  to
the TAACVTIFS authorization list to use either command.

A typical command would be:

             CVTIFSAUT   OBJ('*') OUTLIB(xxx)

This  would  convert   authorities  for  all  objects   in  the  'home'
directory.

If  you  have  already  used  CVTIFS  with OUTFILFMT(*TYPE2),  you  may
specify OBJ(*EXISTS) and name  the library of the  IFSDIRT file in  the
IFSDIRTLIB parameter.

CVTIFSAUT escape messages you can monitor for
---------------------------------------------

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

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

   OBJ           The path  name of  the object  to convert  authorities
                 for.   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.   The
                 default is *.

                 Specifying  * will  start the  convert process  at the
                 current  directory level.    If the  current directory
                 level is at the root  ('/'), the convert process  will
                 start at the home directory ('/home').

                 A  special  value  of  *IFS  can  also  be  specified.
                 Specifying  *IFS  will start  the  convert  process at
                 the  root  directory  level  ('/')  excluding   /QDLS,
                 /QOPT and /QSYS.LIB.

                 If  an object  is  named  in  the OBJ  parameter  (not
                 *EXISTS),   the  user  must   be  authorized   to  the
                 TAACVTIFS authorization list.

                 The  special value  *EXISTS may  be entered  if CVTIFS
                 has already been run  and you want to use  the created
                 outfile.   If *EXISTS is used, the  IFSDIRTLIB and MBR
                 parameters  must  specify the  library  and  member of
                 the existing IFSDIRT file.

                 To use  *EXISTS,  the CVTIFS  command must  have  been
                 specified  as  OUTFILFMT(*TYPE2) to  create  the  file
                 IFSDIRT.

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

   OUTMBR        The  member of  the  IFSAUTP file  to  be used.    The
                 default  is IFSAUTP.   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.

   IFSDIRTLIB    The   library  of   the   existing  IFSDIRT   file  if
                 OBJ(*EXISTS) is  specified.   The  default  is  *LIBL.
                 *LIBL  must  be  used  if a  specific  OBJ  is  named.
                 *CURLIB may also be entered.

   MBR           The   member   of  the   existing   IFSDIRT   file  if
                 OBJ(*EXISTS) is  specified.   The default  is  *FIRST.
                 *LAST may also be entered.

                 This  parameter   is   ignored  if   *EXISTS  is   not
                 specified for the OBJ parameter.

   OMITDIR       If  the Object  parameter is  a directory,  specify up
                 to  10 subdirectory  names relative  to that directory
                 to be excluded.

                 Any of the  OMITDIR entries may  be a subdirectory  of
                 the  directory specified  for  the OBJ  parameter.   A
                 subdirectory  can go multiple  levels deep, but cannot
                 skip any directories along the  way.  For example,  if
                 'Sub1' is  a directory in  the home directory  and has
                 a   subdirectory  of   'Sub1A',  you   cannot  specify
                 OBJ('*') and OMITDIR('Sub1A').

                 Generic directories  are supported  by using  an *  as
                 the last  character of an  OMITDIR path.   This causes
                 any  directory  starting  with the  characters  before
                 the * to be omitted.

                 An  omitted directory cannot begin with  a / or \.  If
                 a directory  specified to be  omitted does not  exist,
                 no error occurs.

                 Examples:

                CVTIFS OBJ(*) OMITDIR('dir1')

                   Omits /home/xxx/dir1 and all its subdirectories

                CVTIFS OBJ(*) OMITDIR('dir*')

                   Omits /home/xxx/yyyy where yyyy is a subdirectory
                    beginning with 'dir' and all their subdirectories

   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 be authorized to the TAACVTIFS authorization list.

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

The following TAA Tools must be on your system:

     CRTDUPPF        Create duplicate PF
     CVTIFS          Convert IFS
     CVTIFSEAUT      Convert IFS entry authority
     EDTVAR          Edit variable
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDDIAGMSG      Send diagnostic message
     SNDJLGMSG       Send job log 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
   ------        ----    ---------      ----------    ----------

   CVTIFSAUT     *CMD                   TAAIFSR       QATTCMD
   TAAIFSRC      *PGM       CLP         TAAIFSRC      QATTCL
					

Added to TAA Productivity tools October 15, 2001


Home Page Up to Top