TAA Tools
DSPEMTIFS       DISPLAY EMPTY IFS                      TAAIFUB

The Display  Empty IFS command  is a front-end  to DSPIFS to  provide a
listing  of the  empty IFS  stream files.   Stream  files that  have an
object  size of 0 are  displayed.  Note that  this is not the allocated
size of the  stream file.   The DSPIFS command  is used internally  and
the output appears with the title of 'Display IFS'.

You must be authorized to the TAACVTIFS *AUTL to use DSPEMTIFS.

A typical command to display your home directory would be:

             DSPEMTIFS

DSPEMTIFS escape messages you can monitor for
---------------------------------------------

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

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

   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.

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

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

                 Embedded  asterisks  and ?   as  any  single character
                 are  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

   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.

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


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

None.

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:

     DSPIFS          Display IFS

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

None, the tool is ready to use.

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

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

   DSPEMTIFS     *CMD                   TAAIFUB       QATTCMD
					

Added to TAA Productivity tools July 15, 2011


Home Page Up to Top