TAA Tools
RTVIFSSUM    RETRIEVE IFS SUMMARY                      TAAIFSJ

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
					

Added to TAA Productivity tools August 15, 2001


Home Page Up to Top