DSPIFS          DISPLAY IFS                            TAAIFSK

 The Display IFS command  provides a display or listing  of IFS objects.
 The  outfile  from  the  TAA  command  CVTIFS  is used  for  the  data.
 Different  selection criteria  can be  specified as  well as a  sort on
 one of the fields.  A  standard listing format is used.  DSPIFS  can be
 used  to eliminate  the need  to write  simple query  functions  of IFS
 data.

 For  a  similar  function  that allows  deletion  of  IFS  objects, see
 WRKIFS.

 DSPIFS uses the outfile  created by CVTIFS.   Either type may be  used.
 When *TYPE2  is used,  the full  path name  is displayed.   The  *TYPE2
 file output  is IFSDIRT.  The  model file is TAAIFSAT  with a format of
 IFSDIR2.  If *TYPE1 is used, the  output file is IFSDIRP.  *TYPE1  uses
 the model file TAAIFSAP with a format name of IFSDIRR.

 You must be authorized  to the TAACVTIFS authorization list  to specify
 a path name.

 A typical command would be:

              DSPIFS       OBJ('*') SORTBY(*USEDATE) SEQ(*DESCEND)
                              SIZE((2000000 *GE))

 The  OBJ('*') means  to  use the  current  directory.   If  the current
 directory is at the root, '/home' is used.

 A  display would  appear of  all objects  in the selected  directory in
 descending sequence by  the date last  used.  An  object would only  be
 listed  if its  size  was greater  than  or equal  to 2,000,000  bytes.
 CVTIFS  would be  used internally  to create an  outfile of  objects in
 library QTEMP.

 If you have  already used CVTIFS to  create an outfile  of *TYPE2 in  a
 library, you could specify:

              DSPIFS       OBJ(*EXISTS) IFSDIRPLIB(xxx) ...

 Change dates
 ------------

 Two different  change dates are  provided in the  CVTIFS outfile.   One
 is set  when the attributes of  the object change (IFCHDT).   The other
 is set when the data in the object changes (IFMODT).

 Depending on the  function you  are using,  only one of  the dates  may
 change or both.

 You may sort on either field.

 You may select  on a single change  date in which case both  fields are
 checked.

 DSPIFS 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').

                  You    must   be    authorized   to    the   TAACVTIFS
                  authorization list to specify a path name.

                  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 file.   See the  OUTFILFMT parameter for
                  the file name.

    OUTFILFMT     The default  is  *TYPE2  which allows  the  full  path
                  name  to  be  displayed.     *TYPE2  causes  the  file
                  IFSDIRT  to be  output.   *TYPE2  uses the  model file
                  TAAIFSAT   with  a  format  name  of  IFSDIR2.    This
                  includes  the   IFOBJP   field  (5000   bytes)   which
                  contains  the  full path  name.    The  model file  is
                  TAAIFSAT with a format of IFSDIR2.

                  *TYPE1   may  be  specified   which  causes  the  file
                  IFSSIRP to  be output.   The  model  file is  TAAIFSAP
                  with a format name of IFSDIR.

    SORTBY        Whether  the   listing  should  appear  in   a  sorted
                  sequence.   The  default is *NONE  meaning to  use the
                  sequence of the data in the file being read.

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

                  *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   field  selected  on  is  either  the
                  allocated  size (IFASIZ)  or the  actual size (IFOSIZ)
                  based on the setting of the SIZETYPE parameter.

                  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  listed.   The value  entered
                  determines  which field  (IFASIZ  if *ALLOC  or IFOSIZ
                  if  *ACTUAL)  is   used  for  the   listing  and   the
                  SORTBY(*SIZE) specification.

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

    SELECT        A  list of  up to  ten two  part values  that let  you
                  include  or  omit files  and objects.    This provides
                  selection in  addition  to  the OBJ  parameter.    The
                  default is  to *INCLUDE  *ALL.   The default can  also
                  be considered to be '*', or '*.*'.

                  A  ?   as a single  character is  not supported.   The
                  matching logic is case-insensitive.

                  Examples:

                   *.txt      All files with a 'txt' extension
                   a*         All files where the name starts with 'a'
                   a*b*       All files starting with 'a' and having
                                 an extension that starts with 'b'
                   a.txt      All files named 'a' with a 'txt' extension

                  Multiple  * values are allowed  to represent 0 or more
                  characters.    For  example,  any  of   the  following
                  arguments   would  match   a   file   with  the   name
                  'empty.html'.  Case is ignored.

                     empty.hmtl
                     emp*.ht*
                     *e*M*p*h*t*


    OUTPUT        The  type  of output  to perform.    * is  the default
                  meaning  if  the  command  is  run  interactively,   a
                  display will appear.

                  If run  in batch  or if *PRINT  is entered,  a spooled
                  listing will result.

    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.

    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.

    CMD           The CMD  parameter allows the heading  of DSPIFS to be
                  changed to  say Display  Empty  IFS if  the  DSPEMTIFS
                  command is used.  The default is DSPIFS.

 Restrictions
 ------------

 The CVTIFS command is used internally and has some restrictions.

 You must be authorized  to the TAACVTIFS authorization list  to specify
 a path name.

 System  objects may  not properly reflect  the last  date used  and the
 number of days used.

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

 The following TAA Tools must be on your system:

      CHKGENERC       Check generic
      CHKOBJ3         Check object 3
      CVTDAT          Convert date
      CVTIFS          Convert IFS
      EDTVAR          Edit variable
      RTVSYSVAL3      Retrieve system value 3
      SNDCOMPMSG      Send completion 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
    ------        ----    ---------      ----------    ----------

    DSPIFS        *CMD                   TAAIFSK       QATTCMD
    TAAIFSKC      *PGM       CLP         TAAIFSKC      QATTCL
    TAAIFSKR      *PGM       RPG         TAAIFSKR      QATTRPG

Added to TAA Productivity Tools August 15, 2001


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.