PK17880: IMS DFR ENHANCEMENT IN SUPPORT OF IMS V7 APAR PQ59697, IMS V8 APAR PQ62862 AND IMS V9 APAR PQ86387.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• IMS DEDB Fast Recovery enhancement in support of IMS V7 APAR
  PQ59697 (PTF is UQ86535/UQ86536), IMS V8 APAR PQ62862
  (PTF is UQ86537/UQ86538) and IMS V9 APAR PQ86387
  (PTF is UQ88516/UQ88517).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS DEDB Fast Recovery          *
  *                 Version 2 Release 2 (FMID=H1J2220)           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR is DFR version for IMS V7     *
  *                      APAR PQ59697 (PTF is UQ86535/UQ86536),  *
  *                      IMS V8 APAR PQ62862 (PTF is UQ86537/    *
  *                      UQ86538) and IMS V9 APAR PQ86387        *
  *                      (PTF is UQ88516/UQ88517).               *
  *                      - PQ59697, PQ62862 and PQ86387          *
  *                      ABENDU1026 DBFDLSR0 during /ERE when    *
  *                      using a checkpoint prior to a DEDB      *
  *                      online change that changed a DEDB with  *
  *                      11 areas defined to a DEDB of 4 areas.  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  - PK17880 for IMS DEDB Fast Recovery
  In the case of area mismatch (the status that there are X'5950'
  updated log records for the area after recovery start checkpoint
  but the area DMAC is not found in the active ACBLIB), skipping
  processing the X'5950' log records may cause a data integrity
  problem.
  PK17880 uses two new log records: X'5926'(All DEDBs removed
  by OLC) and X'5927' (Area deleted by OLC) which were
  introduced by  APARs PQ59697, PQ62862 and PQ86387, and
  determines whether the mismatch is caused by OLC or by
  making change to the active ACBLIB between the IMS failure
  and running of DFR. It will issue message DFR3737W for the
  affected area if the area DMAC is not loaded from ACBLIB and
  it has database updates after the recovery start checkpoint,
  and it is not deleted by OLC.
  

Problem conclusion

Temporary fix

Comments

• The following macro/modules have been modified.
  -DFRRSC7/DFRRSC8/DFRRSC9
  Add new fields, RSCDOLCA to save the beginning of the list of
  areas not being loaded from ACBLIB and having database updates,
  and RSCDOLCP to save the beginning of the list of blocks
  obtained to store entries to the list of areas not loaded.
  -DFRLFCK7/DFRLFCK8/DFRLFCK9
  Modify code to remove the logic to skip processing X'4084' log
  record if the number of areas in the database does not match
  with the checkpointed number of areas, and to remove RCIT
  initialization process.
  -DFRL5927/DFRL5928/DFRL5929
  Add code to process X'5927' log record to remove its entry
  from the list of areas not found, and to process X'5926' log
  record to free the list of areas not found.
  Also, modify code to remove RCIT initialization process.
  -DFRL5957/DFRL5958/DFRL5959
  Add code to build a list of areas not loaded at control block
  initialization, and having database updates after the recovery
  start checkpoint. Also, modify code to skip processing database
  updates in the case the area is not open.
  -DFRNFCT7/DFRNFCT8/DFRNFCT9
  Add code to search entry in the list of areas not found and
  issue message DFR3737W RECOVERY SKIPPED FOR DB=db-name
  AREA=area-name. AREA NOT FOUND IN ACBLIB, and to set the job
  return code 4 if the entry existed.
  -DFRLFCT7/DFRLFCT8/DFRLFCT9
  Add code to process X'5926' and X'5927' log records.
  -DFRLFRC7/DFRLFRC8/DFRLFRC9
  Add code to initialize RCIT if RCIT is not obtained yet.
  -DFRLFTL8/DFRLFTL9
  Modify code to remove RCIT initialization process.
  -DFRLFTL7
  Add code to handle RCIEFFCI/FPCI. Also, modify code to remove
  RCIT initialization process.
  -DFRL5937
  Add code to handle RCIEFFCI/FPCI.
  -DFRNLG07
  Add code to handle RCIEFFCI/FPCI.
  *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS DEDB Fast Recovery for z/OS Version 2 Release 2 User's Guide
  and Reference (Document Number: SC27-0928-02) should be changed
  as follows.
  ================================================================
  Appendix B. Messages and Codes
   B.3 Messages
  .
  A new message MSGDFR3737W is added.
  .
  DFR3737W RECOVERY SKIPPED FOR DB=db-name AREA=area-name.
  AREA NOT FOUND IN ACBLIB
  Explanation: DEDB Fast Recover finds database updates to this
  area, but it cannot validate if these updates need recovery
  (REDO). There is no subsequent X'5926' log record nor X'5927'
  log record to indicate that the area has been deleted by online
  change. This condition occurs if the user has changed the IMS
  block structure since the specified checkpoint was taken.
  System Action: The job continues, and terminates with return
  code 4 or higher.
  System Programmer Response: Ensure that there is no data
  integrity problem, caused by the user changing the IMS block
  structure since the specified checkpoint was taken. If the area
  has been closed before the IMS failure, there will be no date
  integrity problem.
  

APAR Information

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

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

  UK10980

Modules/Macros

• DFRLFCK7 DFRLFCK8 DFRLFCK9 DFRLFCT7 DFRLFCT8
  DFRLFCT9 DFRLFRC7 DFRLFRC8 DFRLFRC9 DFRLFTL7 DFRLFTL8 DFRLFTL9
  DFRL5927 DFRL5928 DFRL5929 DFRL5937 DFRL5957 DFRL5958 DFRL5959
  DFRNFCT7 DFRNFCT8 DFRNFCT9 DFRNLG07 DFRRSC7  DFRRSC8  DFRRSC9
  

Fix information

• Fixed component name

  DEDB FAST RECOV

• Fixed component ID

  5655E3200

Applicable component levels

• R220 PSY UK10980

     UP06/01/21 P F601

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.