The Check IFS Save command displays or prints a listing of IFS
objects that need to be archived (saved). An outfile is optional.
Using WRKLNK and option 8 (Display attributes), you can see the 'Need
to archive (System)' information for an IFS object. It is changed to
'No' when the object is saved with a SAV command specifying
UPDHST(*YES). CHKIFSSAV allows a review of the objects needed to be
saved.
If an outfile is created, the model file used is the same as used
with CVTIFS. The model file name is TAAIFSAT with a format name of
IFSDIR2.
You must be authorized to the TAACVTIFS *AUTL to use CHKIFSSAV.
A typical command would be:
CHKIFSSAV OBJ(*)
This would display a listing of all IFS objects in your current
directory that need to be saved.
The system does not keep a last save date/time for IFS objects as it
does for library objects. Instead, it updates the field in the IFS
object description which is described as 'Need to archive (System)'.
A 'Yes' value indicates either 1) the object has never been saved or
2) the object has been saved since the last change, but with
UPDHST(*NO).
Commands that save library objects such as SAVOBJ or SAVLIB, default
to UPDHST(*YES). The SAV command used for IFS objects defaults to
UPDHST(*NO).
The 'Need to archive (System)' information is in the IFSARC field of
the IFSDIRT (based on the model file TAAIFSAT) file used by
CHKIFSSAV. A 'Y' value causes the object to be listed.
CHKIFSSAV escape messages you can monitor for
----------------------------------------------
TAA9891 No objects needing a save were found.
Escape messages from based on functions will be re-sent.
CHKIFSSAV Command parameters *CMD
----------------------------
OBJ The path name of the object to be checked. The
object path name must be a single object (either a
directory or a file). The default is *.
Specifying * will start the process at the current
directory level. If the current directory level is
the root ('/') directory, 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 ('/') excluding /QDLS, /QOPT and
/QSYS.LIB. If additional directories are to be
excluded, the OMITDIR parameter can be used.
The special value *IFSLST may be entered to refer to
a list of IFS objects/directories entered using the
IFSLST tool (see the WRKIFSLST command). If *IFSLST
is entered, the IFSLST parameter must name a file
created by the CRTIFSLST command.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. If the display is ended with F3/F12
or the Enter key, the spooled file is deleted after
it is displayed. To retain the spooled file, you
may use the the System Request 'Cancel' function and
The spooled file (named IFS) will exist in a HLD
status.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
OUTFILE An outfile to be created of the objects listed.
*NONE is the default meaning no outfile will be
created. If *NONE is used, take the defaults for
the OUTMBR and REPLACE parameters.
If an outfile name is described, it will be
formatted like a CVTIFS *TYPE2 outfile (model file
is TAAIFSAT). The format name will be IFSDIR2.
OUTMBR The outfile member to be used. The default is
IFSDIR.
REPLACE A *YES/*NO value for whether the member should be
cleared before writing records into it. The default
is *YES.
*NO may be specified to add records to an existing
member.
PROCSUBDIR If the Object parameter is a directory, specify a
*YES/*NO value to indicate whether all
subdirectories relative to that directory are to be
included. The default is *YES.
*NO may be specified to process only at the
specified directory's level.
OMITDIR If the Object parameter is a directory, specify up
to 10 subdirectory names relative to that directory
to be excluded.
Any of the OMITDIR entries may be a subdirectory of
the directory specified for the OBJ parameter. A
subdirectory can go multiple levels deep, but cannot
skip any directories along the way. For example, if
'Sub2' is a directory in directory 'Sub', you cannot
specify OBJ('*') and OMITDIR('Sub') and keep
directory 'Sub2'.
Generic directories are supported by using an * as
the last character of an OMITDIR path. This causes
any directory starting with the characters before
the * to be omitted.
An omitted directory cannot begin with a / or \. If
a directory specified to be omitted does not exist,
no error occurs.
Examples:
CVTIFS OBJ(*) OMITDIR('dir1')
Omits /home/xxx/dir1 and all its subdirectories
CVTIFS OBJ(*) OMITDIR('dir*')
Omits /home/xxx/yyyy where yyyy is all
subdirectories beginning with 'dir' and
and all their subdirectories
IFSLST If OBJ(*IFSLST) is specified, the IFSLST parameter
must name a file created by CRTIFSLST. The
WRKIFSLST command is used to enter directory records
into the file.
USRPRF The user profile that will be switched to during run
time. QSECOFR is the default. For file systems
(such as QNTC), CVTIFS (used internally) 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 *AUTL to use CHKIFSSAV.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKTAAOWN Check TAA owner
CRTDUPPF Create duplicate physical file
CRTLFSRC Create logical file source
CVTIFS Convert IFS
DSPIFS Display IFS
EDTVAR Edit variable
RSNLSTMSG Resend last message
RTVIFSED Retrieve IFS entry description
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
WRTSRC Write source
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKIFSSAV *CMD TAAIFUL QATTCMD
TAAIFULC *PGM CLP TAAIFULC QATTCL
TAAIFULR *PGM RPGLE TAAIFULR QATTRPG
|
