PK57594: RECOVERY NEEDED FLAG NOTIFICATION SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides the following new functions to the HD Pointer
  Checker (HDPC) component.
    1. Recovery Needed Flag Notification Support
    HDPC can notify that checked databases are marked as recovery
    needed in RECON via WTO message and non-zero return code.
    The return code is customizable via the RECOVNEEDED keyword
    of the HPSRETCD statement.
    2. Completion message for BLKMAP
    New completion message is provided for the PROC=BLKMAP
    process.  Since pointer checking is not performed for
    BLKMAP, it's useful that this process can be recognized by
    just looking at the completion message.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 2 Release 2 (FMID=HPC2220)      *
  *                 users.                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: By this APAR, IMS High Performance      *
  *                      Pointer Checker for z/OS Version 2      *
  *                      Release 2 (FMID=HPC2220) supports the   *
  *                      following functions:                    *
  *                                                              *
  *                      - Recovery Needed Flag Notification     *
  *                      - TYPE=BLKMAP Completion Message        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  By this APAR, HD Pointer Checker(HDPC) supports the following
  functions:
  
  1. Recovery Needed Flag Notification
   - HDPC issues a new message MSGFABP2122I when a database or a
     partition to be checked is marked as recovery needed (the
     recovery needed flag in the RECON data set is on).
   - This function is available when the following conditions are
     met:
       HDPC stand Alone JOB with DBRC=YES
       The value specified by the new parameter RECOVNEEDED
       keyword of the HPSRETCD statement is greater than zero.
  
  2. RECOVNEEDED keyword of the HPSRETCD statement
   - The RECOVNEEDED keyword is added to the HPSRETCD statement.
   - When a database or a partition is marked as recovery
     needed, the return code of HDPC will be the one specified by
     the RECOVNEEDED keyword.
   - This function is available when the following condition is
     met:
       HDPC stand Alone JOB with DBRC=YES
  
  3. TYPE=BLKMAP Completion Message
   - HDPC issues a new message MSGFABP0005I instead of
     MSGFABP0001I when a job with TYPE=BLKMAP option ends
     normally.
   - This function is available when the following condition is
     met:
       HDPC stand Alone JOB
  

Problem conclusion

Temporary fix

Comments

• Documentation Changes:
  
  Note: The section numbers are those of the BookManager (BKMGR)
  book.
  
  The documentation is modified as follows:
  ==============================================================
    IMS High Performance Pointer Checker for z/OS, V2R2,
    User's Guide (SC18997400)
  ==============================================================
  
  --------------------------------------------------------------
  2.2.2     Input
  2.2.2.3   FABPMAIN HPSRETCD data set
  2.2.2.3.4 (HDPC) Statement
  --------------------------------------------------------------
  Figure 18 is modified as follows:
      _                   _
     |  T2ERROR=nnn|2      |
     |  ,DBERROR=nnn|4     |
     |  ,PROCERROR=nnn|8   |
     |  ,SPMNWARN=nnn|4    |
     |  ,SPMNERROR=nnn|8   |
     |  ,EMPTYKEYSIN=nnn|0 |
  |  |  ,RECOVNEEDED=nnn|0 |
     |_                   _|
  
  The following description is added:
  
  |  RECOVNEEDED=
  |    Specify the return code when a database or a partition to
  |    be checked is registered in the RECON data set and is
  |    marked as recovery needed. When the value is not 0 and a
  |    database or a partition  is marked as recovery needed,
  |    the message FABP2122I is issued. This keyword is available
  |    when HDPC runs with DBRC=YES. nnn is from 0 to 999.
  |    The default value is 0.
  
  --------------------------------------------------------------
  APPENDIX1.1     Appendix A. Messages and codes
  APPENDIX1.1.1   HD Pointer Checker
  APPENDIX1.1.1.3 Messages
  --------------------------------------------------------------
  Messages FABP0005I and FABP2122I are added:
  
  |  FABP0005I BLOCK MAP PROCESS ENDED NORMALLY
  |
  |  Explanation: Block Map Process ended normally.
  |
  |  System Action: This is the normal end of the HD Pointer
  |  Checker job with RC=0.
  |
  |  Programmer Response: None
  |
  |  Problem Determination: None
  |
  |  FABP2122I MARKED AS RECOVERY NEEDED FOR DB: dbdname PART:
  |  partname
  |
  |  Explanation: the database dbdname or the partition partname
  |  of the database dbdname is marked as recovery needed in the
  |  RECON data set.
  |
  |  System Action: Processing continues.
  |
  |  Programmer Response: None
  |
  |  Problem Determination: None
  

APAR Information

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

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

  UK32122

Modules/Macros

•    FABPACTL FABPAWDS FABPDRT  FABPHPT  FABPJCTL
  FABPJDEF FABPLINK FABPMAIN FABPMSGT FABPPDT  FABPRCHK FABPRTCD
  HPC2220J
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R220 PSY UK32122

     UP07/12/13 P F712

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.