The Display  Data Base  Damage command  checks for damage  in the  data
base  file descriptive  information.   Each file  processed is  used by
CHKOBJ,  RTVOBJD, various  forms of DSPFD,  and DSPFFD.   An outfile of
the damaged  files  is  optional.   The  data  itself is  not  checked.
DSPDBFDMG   is  intended  for   the  case   when  an   abnormal  system
termination has occurred and you suspect data base damage.

If  an outfile is  requested, the DBFDMGP  file is written.   It uses a
model file of TAADBNBP and a  record format name of DBFDMGR.  The  file
will only contain records for damage conditions found.

You must  have *ALLOBJ  special authority  to use  a qualified  library
name of *ALL.

See also the CHKOBJDMG command.

A  typical  command to  check  all files  in  a library  and  create an
outfile of records describing damaged data base files would be:

             DSPDBFDMG   FILE(xxx/*ALL) OUTLIB(QTEMP)

A listing would be displayed  of all files in  the named library.   Any
file where damage was  detected would be flagged and a  record would be
written to the DBFDMGP file in QTEMP.

Checking technique
------------------

A list  of the requested files is  output to a file in  QTEMP using the
TAA  CVTOBJD2 command.   This  contains only  the basic  information of
object, library, and object type.   It would be rare to find  damage at
this level.

Each file is then processed by the following commands:

  **   CHKOBJ

  **   RTVOBJD

  **   DSPFD TYPE(*ATR) - outfile created

  **   DSPFD TYPE(*RCDFMT) - outfile created

  **   DSPFD TYPE(*ACCPTH) - outfile created

  **   DSPFD TYPE(*MBR) - outfile created

  **   DSPFFD - outfile created

All  files are  listed.   If  any of  the  commands fail,  the  file is
flagged and a record is written to the output file if requested.

Note  that some non-data  base files such  as a *DSPF  type, may appear
on the listing if damage is detected by CHKOBJ or RTVOBJD.

DSPDBFDMG escape messages you can monitor for
---------------------------------------------

      TAA9891    No matching objects found
      TAA9893    Some damage found

Escape messages from based on functions will be re-sent.

DSPDBFDMG Command parameters                          *CMD
----------------------------

   FILE          The qualified  name  of  the  data  base  file  to  be
                 checked.   A  specific name,  a generic  name, or  the
                 special value *ALL may be entered.

                 The  library  value defaults  to  *LIBL.   A  specific
                 library,  *CURLIB,   or  *ALL   may  also   be   used.
                 Specifying all  libraries  will cause  a long  running
                 job and a large spooled file.

   OUTLIB        The library  for the DBFDMGP  file if any.   A library
                 name  must  be  entered  or  the  special  value *NONE
                 meaning no outfile is requested.

                 If a  library is  named,  the DBFDMGP  file will  only
                 contain records for damage conditions.

   OUTPUT        How  to output  the  results.   *  is  the default  to
                 display  the spooled  file if  the command  is entered
                 interactively.  The spooled  file is deleted after  it
                 is displayed.

                 If  the  command is  entered  in  batch or  *PRINT  is
                 specified,  the spooled  file is output  and retained.

   OUTMBR        The member of  the DBFDMGP file  to be used.   If  the
                 member does not  exist, it is  added.  The  default is
                 DBFDMGP.

   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  existing
                 data.


Restrictions
------------

You  must have  *ALLOBJ special  authority to  use a  qualified library
name of *ALL.

Not  all damage will be checked  by DSPDBFDMG.  The  data itself is not
checked and  there are  always exceptional  conditions  that cannot  be
found by the technique used.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CVTOBJD2        Convert object description 2
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVSYSVAL3      Retrieve system value 3
     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
   ------        ----    ---------      ----------    ----------

   DSPDBFDMG     *CMD                   TAADBNB       QATTCMD
   TAADBNBC      *PGM       CLP         TAADBNBC      QATTCL
   TAADBNBR      *PGM       RPG         TAADBNBR      QATTRPG
   TAADBNBP      *FILE      PF          TAADBNBP      QATTDDS