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
|
