PK11644: ENHANCEMENT TO ALLOW DEDB PC TO OFFER AN API MACRO WHICH HAS ENABLED HASH CHECKING IN MULTIPLE ADDRESS SPACES

APAR status

• Closed as new function.

Error description

• Enhancement to allow DEDB PC to offer an API macro which has
  enabled hash checking in multiple address spaces.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB PC users of HP Fast Path Utilities  *
  *                 FP Basic Tools Version 2 Release 1 (FMID:    *
  *                 H31A210) who invoke HASH checking via        *
  *                 IMS Database Recovery Facility for z/OS      *
  *                 Version 3 Release 1 (FMID=H27L310).          *
  ****************************************************************
  * PROBLEM DESCRIPTION: By applying this APAR, IMS Database     *
  *                      Recovery Facility can call the single   *
  *                      step DEDB hash pointer checking         *
  *                      function.                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  + NOTE -------------------------------------------------------+
  | This new function is only available for IMS Database        |
  | Recovery Facility (DRF) Version 3 Release 1.                |
  +-------------------------------------------------------------+
  By applying this APAR, the single step DEDB hash pointer
  checking function can be invoked under DRF. Use the DRF ADD
  control statement PC keyword to show that the single step
  DEDB hash pointer checking function is required.
  For more details, see "IMS Database Recovery Facility for z/OS
  User's Guide and Reference (SC18940700)"
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 2: Fast Path Basic Tools Version 2 Release 1
  (SC18-9238-00) should be changed as follows:
  
  Add the following new Appendix
  
  --------------------------------------------------------------
  Appendix x.  Tailoring DEDB Pointer Checker for IMS Database
  Recovering Facility
  
  IMS Database Recovering Facility (DRF) Version 3 Release 1 can
  call the DEDB Pointer Checker Hash checking function.
  It is called the single step Hash checking function,
  because the hash checking is invoked within the DRF job step.
  
  --------------------------------------------------------------
  X.1   Address space JCL
  --------------------------------------------------------------
  For primary address space JCL and subordinate address space
  JCL, see Chapter 3 in "IMS Database Recovery Facility for z/OS
  User's Guide and Reference (SC18940700)"
  
  --------------------------------------------------------------
  X.2   DD Statements of DEDB Hash Checking for DRF
  --------------------------------------------------------------
  Specify the following output data sets in the primary address
  space JCL. These values will be overwritten by the user JCL.
  
  FABARPRT DD
    This statement defines the output data set for the pointer
    chain reconstruction report of the DEDB Pointer Checker.
  FABAMSG DD
    This statement defines the output data set that contains
    messages produced by the DEDB Pointer Checker.
  FABASNAP DD
    This statement defines the output data set for the DEDB CI
    map or the CI dump report.
  
  Appendixes. Messages and codes:
  The following message descriptions should be changed:
  ----------------------------------------------------------------
  FABA4011W
  Before:
  FABA4011W DBDNAME: dbdname AREA: areaname - POINTER ERRORS
  DETECTED DURING ICE HASH
  After:
  FABA4011W DBDNAME: dbdname AREA: areaname - POINTER ERRORS
  DETECTED DURING HASH CHECK
  ----------------------------------------------------------------
  FABA4006I
  Before:
  Explanation: This is an informational message to let you know
  that CI map/CI dump for CI xxxxxxxx is generated in a data set
  specified with the SNAPDPIT DD statement. A dump number nnn is
  assigned.
  After:
  Explanation: This is an informational message to let you know
  that the CI map or the CI dump for CI xxxxxxxx is generated in
  a data set that is specified with the SNAPDPIT DD statement for
  ICE hash check or with the FABASNAP DD statement for DRF hash
  check. A dump number nnn is assigned.
  ----------------------------------------------------------------
  FABA4012W
  Before:
  Explanation: The CI map or CI dump function is ignored, for one
  of the following reasons:
  . Reason code 01
  SNAPDPIT data set was not provided, open failed, or I/O failed.
  After:
  Explanation: The CI map or the CI dump function is ignored,
  for one of the following reasons:
  . Reason code 01
  SNAPDPIT data set for ICE hash check was not provided, the
  FABASNAP data set for DRF hash check was not provided,
  open failed, or I/O failed.
  ----------------------------------------------------------------
  
  The following message descriptions should be added:
  ----------------------------------------------------------------
  FABA4055E DBDNAME: dbdname AREA: areaname -  CURRENT AREA NOT
  FOUND
  Explanation: The area cannot be found in DBD. This message is
  issued only by DEDB hash pointer checking invoked under DRF.
  System action: DEDB Pointer Checker ends with an abend
  code of 4055.
  User Response: Specify the correct areaname in the control
  statement, and resubmit the job.
  ----------------------------------------------------------------
  FABA4056E LOAD FAILED FOR dbdname
            - DBD NOT FOUND
            - DBD SIZE IS ZERO
            - GETMAIN FAILED
            - LOAD MACRO ERROR
  Explanation: DBD can not be loaded. This message is
  issued only by DEDB hash pointer checking invoked under DRF.
  System action: DEDB Pointer Checker ends with an abend
  code of 4056.
  User Response: Correct the error, and rerun the job. If this
  situation persists, contact IBM Software Support.
  ----------------------------------------------------------------
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  PK19891 UK12393

Modules/Macros

•    FABAAPI  FABAAPID FABAAPIP FABABMAP FABADATE
  FABADUMP FABAHAPI FABAHBLD FABAHDAT FABAHDA0 FABAHDA5 FABAHEXT
  FABAHPC0 FABAHRPT FABAHSCA FABAHSP0 FABAHSUB FABAHTBL FABALINK
  FABAMSGS FABAPMAP FABARHT  FABARLTR FABARPTH FABDDATE FABURPTH
  H31A210J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R210 PSY UK12393

     UP06/03/10 P F603