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
|
