The Retrieve IFS Summary command retrieves summary information about
the IFS. The outfile from the TAA command CVTIFS is used for the
data. Count and size information is provided for the total IFS, user
objects, and system profile owned objects. You may also name one
profile to summarize information for.
RTVIFSSUM uses the outfile created by CVTIFS. Either the *TYPE1
(does not contain the full path name) or *TYPE2 (contains the full
path name) formats may be used. An existing outfile or a path name
may be specified. The *TYPE1 file output is IFSDIRP. The *TYPE2
file output is IFSDIRT.
You must be authorized to the TAACVTIFS authorization list to specify
a path name.
A typical command would be:
DCL &TOTOBJ *DEC LEN(11 0)
DCL &TOTSIZ *DEC LEN(15 0)
.
RTVIFSSUM OBJ(*IFS) TOTOBJ(&TOTOBJ) TOTSIZ(&TOTSIZ)
The return variables come in 4 sets:
** Total. This is the sum of the next 2 sets of values.
** User. This includes objects owned by non-IBM profiles.
** System. This includes objects owned by system supplied
profiles.
** Named owner. You may name a single owner to summarize totals
for.
Using an existing CVTIFS outfile
--------------------------------
RTVIFSSUM can be a very slow runner if a large number of IFS objects
must be converted.
If you are going to do some other processing of the IFS information
(such as DSPIFS or WRKIFS), it makes sense to use CVTIFS first and
then specify OBJ(*EXISTS) for RTVIFSSUM.
If you intend to use WRKIFS to assist you in removing some IFS
objects, you must use OUTFILFMT(*TYPE2) when using CVTIFS.
RTVIFSSUM 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 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. 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').
The special value of *IFS may also be entered.
Specifying *IFS will start the convert process at
the root directory level ('/') excluding /QDLS,
/QOPT and /QSYS.LIB. If directories are to be
excluded, CVTIFS must be used with the OMITDIR
parameter.
You must be authorized to the TAACVTIFS
authorization list to specify a path name.
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 IFSDIRPLIB and MBR
parameters must specify the library and member of
the existing file. See the OUTFILFMT parameter for
the file name.
OUTFILFMT The output file format to be used.
The default is *TYPE1 which creates or uses file
IFSDIRP. This contains all descriptive fields of
the object, but does not contain the full path name
of the object. The model file is TAAIFSAP with a
format of IFSDIRR.
Specifying *TYPE2 will create or use the file
IFSDIRT. This includes all the fields of *TYPE1
plus the IFOBJP field (5000 bytes) which contains
the full path name of the object. The model file is
TAAIFSAT with a format of IFSDIR2.
TOTOBJ The total number of objects for the specified path.
The value is the sum of USROBJ, and SYSOBJ. This is
an optional return parameter that if used must be
specified as *DEC LEN(11 0).
SIZETYPE The type of size to be returned for the TOTSIZ,
USRSIZ, SYSSIZ, and NAMOWNSIZ parameters.
*ALLOC is the default for the allocated size of the
objects. The IFASIZ field is used. This is the
same concept as used by i5/OS where object sizes
shown by commands such as DSPOBJD are for the
allocated size.
*ACTUAL may be specified for the actual size of the
objects. The IFOSIZ field is used. This is the
size that would be shown if viewing the object from
a PC.
TOTSIZ The total size of objects for the specified path.
The value is the sum of USRSIZ, and SYSSIZ. This is
an optional return parameter that if used must be
specified as *DEC LEN(15 0).
See the SIZETYPE parameter for whether the allocated
or actual size is used.
TOTDIR The total number of directories for the specified
path. The value is the sum of USRDIR, and SYSDIR.
A directory is one of the following object types
*DIR, *DDIR, *FLR, or *LIB. This is an optional
return parameter that if used must be specified as
*DEC LEN(7 0).
USROBJ The number of user objects for the specified path.
A user object is defined to be owned by a user
created profile as determined by the TAA CHKIBMPRF
command. This is an optional return parameter that
if used must be specified as *DEC LEN(11 0).
USRSIZ The size of user objects for the specified path. A
user object is defined to be owned by a user created
profile as determined by the TAA CHKIBMPRF command.
This is an optional return parameter that if used
must be specified as *DEC LEN(15 0).
See the SIZETYPE parameter for whether the allocated
or actual size is used.
USRDIR The number of user directories for the specified
path. A directory is one of the following object
types *DIR, *DDIR, *FLR, or *LIB. A user directory
is defined to be owned by a user created profile as
determined by the TAA CHKIBMPRF command. This is an
optional return parameter that if used must be
specified as *DEC LEN(7 0).
SYSOBJ The number of objects owned system supplied profiles
for the specified path. A system object is defined
to be owned by a system supplied profile as
determined by the TAA RTVIBMPRF command. This is an
optional return parameter that if used must be
specified as *DEC LEN(11 0).
SYSSIZ The size of objects owned by system supplied
profiles for the specified path. A system object is
defined to be owned by a system supplied profile as
determined by the TAA RTVIBMPRF command. This is an
optional return parameter that if used must be
specified as *DEC LEN(15 0).
See the SIZETYPE parameter for whether the allocated
or actual size is used.
SYSDIR The number of directories owned by system profiles
for the specified path. A directory is one of the
following object types *DIR, *DDIR, *FLR, or *LIB.
A system directory is defined to be owned by a
system supplied profile as determined by the TAA
RTVIBMPRF command. This is an optional return
parameter that if used must be specified as *DEC
LEN(7 0).
OWNER The owner to summarize objects for. The default is
*NONE in which case the NAMOWNxxx return values will
be 0. A specific user profile name may be entered.
NAMOWNOBJ The number of objects owned by the OWNER name. This
is an optional return parameter that if used must be
specified as *DEC LEN(11 0).
NAMOWNSIZ The size of objects owned by the OWNER name. be
specified as *DEC LEN(15 0).
See the SIZETYPE parameter for whether the allocated
or actual size is used.
NAMOWNDIR The number of directories owned by the OWNER name.
This is an optional return parameter that if used
must be specified as *DEC LEN(7 0).
IFSDIRPLIB The library of the existing file if OBJ(*EXISTS) is
specified. The default is *LIBL. *CURLIB may also
be entered. See the OUTFILFMT for the name of the
file.
MBR The member of the existing 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.
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 to specify
a path name.
See the CVTIFS command for restrictions on converting entries.
Prerequisites
-------------
The following TAA Tools must be on your system:
RTVIBMPRF Retrieve IBM Profile
CHKOBJ3 Check object 3
CVTIFS Convert IFS
SNDJLGMSG Send job log message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
RTVIFSSUM *CMD TAAIFSJ QATTCMD
TAAIFSJC *PGM CLP TAAIFSJC QATTCL
TAAIFSJC2 *PGM CLP TAAIFSJC2 QATTCL
|
