TAA Tools
WRKIFS2         WORK IFS 2                             TAAIFUO

The Work  IFS 2 command is  designed for a  review of IFS  entries, but
does  not  allow  any  changes  to  be  made.   Several  selection  and
sequencing  options exist.   The WRKIFS command  is similar, but allows
removal of entries and access to WRKLNK.

From the WRKIFS2  display the user has  options to display stream  file
data, display/print the attributes, and display the authoriity.

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

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

Depending  on what is requested,  the internal command  CVTIFS can take
a long time (also the use of  F5=Refresh on the display) to create  the
file used  by WRKIFS2.   You  may use  the CVTIFS  command directly  to
create  the file  and then  specify  OBJ(*EXISTS) function  if repeated
use will occur.

A typical command would be:

             WRKIFS2   OBJ(xxx) SIZE(1000000 *GE)

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

If WRKIFS2  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.

WRKIFS2 escape messages you can monitor for
-------------------------------------------

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

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

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKIFSE         Check IFS entry
     CHKOBJ3         Check object 3
     CHKSPCAUT       Check special authority
     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
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message
     TRNVAL          Translate value
     WRKIFS          Work IFS

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   WRKIFS2       *CMD                   TAAIFUO       QATTCMD
   TAAIFUOC      *PGM       CLP         TAAIFUO       QATTCL
   TAAIFUOR      *PGM       RPG         TAAIFUOR      QATTRPG
   TAAIFUOD      *FILE      DSPF        TAAIFUOD      QATTDDS
					

Added to TAA Productivity tools January 15, 2014


Home Page Up to Top