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