TAA Tools
CHKIFSDMG       CHECK IFS DAMAGE                       TAAIFTD

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
					

Added to TAA Productivity tools June 15, 2004


Home Page Up to Top