The Check IFS Damage command attempts to save one or more individual
IFS objects to a save file. *DIR, *FLR, and *DOC objects are
bypassed. Messages are sent for those objects which could not be
saved including some objects that are not valid to be saved. While
this is not a perfect solution, the messages can be used to indicate
damage situations.
CHKIFSDMG can be a long running command depending on what you request
for the OBJ parameter. To check an entire system may well take
hours.
You must have *ALLOBJ special authority to use CHKIFSDMG.
A typical command would be:
CHKIFSDMG OBJ('/home')
All objects in the /home directory would be found. If *DIR objects
exist, they are not saved. Objects within the directories are
attempted to be saved including sub trees.
CHKIFSDMG processing
--------------------
CHKIFSDMG uses the CVTIFS TAA tool to get a list of IFS objects. The
list is then read and certain object types are bypassed such as *DIR,
*FLR, and *DOC.
Each object is attempted to be saved to a save file in QTEMP.
SAVACT(*YES) is specified.
If the object can be saved, it is probable that no damage exists.
However, since the save function is not aware of what the bytes mean
within the object, it is still possible for the object to be damaged
and yet be saved correctly.
If an object cannot be saved, the command which failed is sent as a
message. The system also sends messages which indicate the reason
for a failure.
The system prevents certain objects from being saved and these will
be noted.
Maximum size object
-------------------
The tool determines how much storage is available in ASP 1 and allows
for a max of 75% of this space to be used when creating a save file.
If an object exists that is larger, the save command will fail.
CHKIFSDMG escape messages you can monitor for
---------------------------------------------
TAA9897 Some objects could not be saved.
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.
USRPRF The user profile that will be switched to during run
time. QSECOFR is the default. For file systems
(such as QNTC), the sub tool 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.
Restrictions
------------
You must have *ALLOBJ special authority to use CHKIFSDMG.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKSPCAUT Check special authority
CVTIFS Convert IFS
EDTVAR Edit variable
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKIFSDMG *CMD TAAIFTD QATTCMD
TAAIFTDC *PGM CLP TAAIFTDC QATTCL
TAAIFTDR *PGM RPGLE TAAIFTDR QATTRPG
|
