TAA Tools
WRKIFS          WORK IFS                               TAAIFST

The Work  IFS command  is designed for  those users  who are  trying to
cleanup  the IFS.   Selection  criteria exists  (such  as size  or last
used  date) which  can be  used to  minimize what  is displayed  in the
work display.  You  may also sequence the  display.  From the  display,
the  user can display  or print  attributes and  access WRKLNK  for any
object.  *STMF object types may be removed.

If  the default  for OBJ is  used, CVTIFS  is run  internally which can
take a long  time.  An  option exists to  use CVTIFS  ahead of time  to
create a file  (using OUTFILFMT = *TYPE2)  that can be used  by WRKIFS.

You  must be  authorized  to the  TAACVTIFS authorization  list  to use
WRKIFS.

A typical command would be:

             WRKIFS    OBJ(xxx) SIZE(1000000 *GE)

WRKIFS uses CVTIFS internally unless you  have done a prior CVTIFS  and
specify  OBJ(*EXISTS).    For   the  fastest  use  of  WRKIFS,   it  is
recommended that  you use CVTIFS  first (it can  be a long  runner) and
then  query  the output  with  the WRKIFS  command.   You  must specify
OUTFILFMT(*TYPE2) when using  CVTIFS.  The  file name must be  IFSDIRT.

If  WRKIFS is  used to  create the  IFSDIRT file,  the IFSDIRT  file is
left  in the library specified  (such as QTEMP).   You can then specify
OBJ(*EXISTS) and the IFSDIRPLIB library  to allow faster processing  of
a different type of request.

Differences with DSPIFS
-----------------------

DSPIFS  provides  the  same selection  and  sequencing  capability  and
prints  a listing.   Because the  object names  can be very  long, they
are truncated on the listing  so you may not  be able to determine  the
actual path name of an object you want to remove.

WRKIFS  allows  a  simple '4=Remove  option'  once  you  determine  the
object that should be removed.

You may  also use WRKIFS  with the '7=Print attributes'  option to hand
the  spooled output  to another  user to  either remove or  justify why
the object should exist.

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

                 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  IFSDIRT   file.     You  must   specify
                 OUTFILFMT(*TYPE2) when using CVTIFS.

If WRKIFS is used to  create the IFSDIRT file, the file is  left in the
library specified  (such as QTEMP).  You  can then specify OBJ(*EXISTS)
and  the IFSDIRPLIB to  allow faster processing of  a different type of
request.

   SORTBY        Whether  the  display   should  appear  in  a   sorted
                 sequence.   The default  is *NONE  meaning to  use the
                 sequence  of the data in the  IFSDIRT file (created by
                 CVTIFS).

                 *OWNER may be  entered to sort  by owner name  (IFOWNR
                 field).

                 *SIZE  may be  entered  to sort  by  the  size of  the
                 object.   See the SIZETYPE  parameter for whether this
                 is the allocated or actual size of the object.

                 *CRTDATE may be entered to  sort by the creation  date
                 of the object (IFCRDT field).

                 *CHGATTR may  be entered  to sort  by the last  change
                 date of  the attributes of the  object (IFCHDT field).

                 *CHGDATA  may be  entered to  sort by  the last change
                 date of the data in the object (IFMODT field).

                 *USEDATE may  be  entered to  sort  by the  last  used
                 date of the object (IFLUDT field).

                 *DAYSUSED  may be  entered to  sort by  the  number of
                 days  used   (IFDYSU  field).    This  information  is
                 updated once  per  day.   It is  not  a count  of  the
                 number of times  used.  This data may  not be accurate
                 for system objects.

                 *TYPE  may be entered  to sort  by the type  of object
                 (IFOTYP field).

   SEQ           The sequence of  the sort if  specified.  The  default
                 is *ASCEND  for ascending sequence.   *DESCEND  may be
                 specified for descending sequence.

                 This parameter  is ignored if the  SORTBY parameter is
                 *NONE.

   OBJNAM        The object name to select.  The default is *ALL.

                 A  specific name  may be  entered or  a generic* name.
                 The generic  name  can be  any  one of  the  following
                 types:

                      ABC* Select all names beginning with ABC.

                      A*C Select names like ABC ABBC AXYZC

                      A*C* Select names like ABC ABCD ABBCD

                      *AB* Select names like AAB AABC XAB XABC

                 however,  if an embedded  * exists  (such as  A*C), or
                 multiple  *s   (such  as  A*C*),  the  value  must  be
                 entered in quotes.

   OBJTYP        The object type  to select.  The  default is *ALL  for
                 all object types.   Some typical IFS  object types are
                 shown  in the command  prompt.  Depending  on the path
                 name, it is  also possible to  use other object  types
                 such as *LIB.

   OWNER         The owner  of the object  to select  on.  The  default
                 is *ALL for all owners.

                 A specific  user name (or a generic  user name) may be
                 entered or the special values:

                      *USER   for  non-system   supplied  user  profile
                      names.

                      *SYS for system user profile names.

                 The determination of  whether the profile is  a system
                 supplied name is done by the tool RTVIBMPRF.

   SIZE          The  size selection  if any.   This  is a  two element
                 parameter.

                 The  first element  is the  size value  which defaults
                 to *ALL meaning that size  will not be considered  for
                 selection.    A size  may  be  entered  that is  0  or
                 greater.     The  size  selected  on  depends  of  the
                 SIZETYPE value specified.

                 The  second  element  is  the  'size  operator'   that
                 determines  how  to  compare  the  size  value.    The
                 default  is *GE.   The standard Boolean  operators are
                 supported.   The  operator is  ignored for SIZE(*ALL).

   SIZETYPE      The type  of size  to be  displayed.   The value  also
                 determines    how   the    SIZE   and    SORTBY(*SIZE)
                 specifications will be processed.

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

   CRTDATE       The  create date of  the object to  select for if any.
                 This is a two element parameter.

                 The  first element  is  the  create date  value  which
                 defaults to  *ALL meaning  that create dates  will not
                 be  considered for selection.   A date  may be entered
                 in job format.  The field selected on is IFCRDT.

                 The second  element  is  the  'create  date  operator'
                 that  determines  how  to  compare   the  date.    The
                 default  is *GE.   The standard  Boolean operators are
                 supported.       The   operator    is   ignored    for
                 CRTDATE(*ALL).

   CHGDATE       The change date  of the object  to select for  if any.
                 This is a two element parameter.

                 The  first  element is  the  change  date value  which
                 defaults  to *ALL  meaning that change  dates will not
                 be considered for  selection.  A  date may be  entered
                 in  job  format.    Both  the  attribute  change  date
                 (IFCHDT  field)  and  the  data  change  date  (IFMODT
                 field)  are   used   for  selection   with   an   'or'
                 condition.

                 The  second  element  is the  'change  date  operator'
                 that  determines   how  to  compare  the  date.    The
                 default is *GE.   The standard  Boolean operators  are
                 supported.       The   operator    is   ignored    for
                 CHGDATE(*ALL).

   USEDATE       The 'last  used date' of  the object to  select for if
                 any.  This is a two element parameter.

                 The  first  element  is  the  'last  used  date' value
                 which  defaults  to  *ALL  meaning  that   'last  used
                 dates' will  not be considered for selection.   A date
                 may  be entered in job format.   The field selected on
                 is IFLUDT.

                 The second element  is the  'last used date  operator'
                 that  determines  how  to  compare   the  date.    The
                 default  is *GE.   The standard  Boolean operators are
                 supported.       The   operator    is   ignored    for
                 USEDATE(*ALL).

   DAYSUSED      The 'number of days  used' to select on if  any.  This
                 is a two element parameter.

                 The  first  element  is  the  'number of  days'  value
                 which  defaults to  *ALL meaning  that days  used will
                 not be considered  for selection.   A 'number of  days
                 used'  may be  entered  that  is 0  or  greater.   The
                 field selected on is IFDYSU.

                 The  second  element  is  the  'number  of  days  used
                 operator' that determines  how to  compare the  value.
                 The default  is *GE.   The standard  Boolean operators
                 are   supported.     The   operator  is   ignored  for
                 DAYSUSED(*ALL).

                 The system  only  updates this  information  once  per
                 day.  The value  does not reflect the number  of times
                 an  object  has  been  used.    The data  may  not  be
                 accurate for system objects.

   IFSDIRPLIB    The   library   of  the   existing  IFSDIRT   file  if
                 OBJ(*EXISTS)  is specified.    The default  is  *LIBL.
                 *CURLIB may also be entered.

                 The file must  have been created by the  use of CVTIFS
                 with OUTFILFMT(*TYPE2).

   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.

   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.

A  maximum  of 9,999  IFS objects  can be  processed,  due to  a system
limitation.  Trying  to display a file  over 9,999 records will  result
in a  message stating all entries  cannot be displayed.   In this case,
the  user should  consider re-running CVTIFS  with a  greater filter to
reduce the resulting file size so all records can be shown.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKIFSE         Check IFS entry
     CHKOBJ3         Check object 3
     CVTDAT          Convert date
     CVTTIM          Convert time
     DSPERRMSG       Display error message
     DSPIFSED        Display IFS entry description
     EDTVAR          Edit variable
     FILEFDBCK       File feedback
     PMTOPR          Prompt operator
     RSNLSTMSG       Resend last message
     SNDESCMSG       Send escape message
     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
   ------        ----    ---------      ----------    ----------

   WRKIFS        *CMD                   TAAIFST       QATTCMD
   TAAIFSTC      *PGM       CLP         TAAIFSTC      QATTCL
   TAAIFSTC2     *PGM       CLP         TAAIFSTC2     QATTCL
   TAAIFSTR      *PGM       RPG         TAAIFSTR      QATTRPG
   TAAIFSTD      *FILE      DSPF        TAAIFSTD      QATTDDS
					

Added to TAA Productivity tools June 1, 2002


Home Page Up to Top