PK55693: ABEND U3957, WHEN DBRC DBDS RECORD EXISTS WITHOUT CORRESPONDING DB RECORD DUE TO A TIMING ISSUE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HPIC for IMS V8 and V9 reads the RECON directly because we can
  not get enough DBRC information by using the IMS RECON API in
  these releases.
  We're issuing an ENQ to read the DBDS record, then a DEQ.  We
  then ENQ a second time to read the DB record if the DBDS record
  is found.  This exposes a timing issue - by the time we try and
  read the DB record, it's gone (but we've read the DBDS record).
  This 2-phase approach was to avoid reserving RECON data sets
  for any length of time.
  Based on this problem, we're going to change HPIC to
  read the DBDS and DB records in the same ENQ/DEQ.
  

Local fix

• No work around.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR includes following APAR of    *
  *                      HPIC V3R2:                              *
  *                       PK53844                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes following APAR fix from IMS High
  Performance Image Copy for z/OS version 3 release 2:
  
  -PK53844 fixes following problem:
    HPIC terminates with ABEND U3957 ( ABENDU3957 ) when a DBDS
    record exists in DBRC without a corresponding DB record due to
    a timing issue.
    HPIC issues an ENQ to read the DBDS record, then issues a
    DEQ. HPIC then issues an ENQ a second time to read the DB
    record if DBDS record is found.
    This exposes a timing issue - by the time HPIC tries to read
    the DB record, the DB record is not found in spite of reading
    the DBDS record successfully.
    This APAR changes HPIC to read both of the DB record and the
    DBDS record with reserving RECONs in the same ENQ.
  

Problem conclusion

• FABJMAIN has been modified following things:
  - To call FABJRCHK with ENQ request.
  - To call FABJRCHK for reading the DB record.
  - To call FABJRCHK for reading the DBDS record.
  - To call FABJRCHK with DEQ request.
  
  FABJRCHK has been modified following things:
  - To call FABJARC0 for issuing ENQ RECONs and ENQ flag is on
       when ENQ request received from caller.
  - To call FABJARC0 for reading the DB record without ENQ request
       when ENQ flag is on.
  - To call FABJARC0 for reading the DBDS record without ENQ
       request when ENQ flag is on.
  - To call FABJARC0 for issuing DEQ RECONs and DEQ flag is on
       when DEQ request received from caller.
  
  FABJDBRC has been modified following things:
  - To call FABJRCHK with ENQ request.
  - To call FABJRCHK for reading the DB record.
  - To call FABJRCHK for reading the DBDS record.
  - To call FABJRCHK with DEQ request.
  
  The following modules have been reassembled.
    FABJDBR7 FABJDBR8 FABJDBR9 FABJDBRA FABJRCH7 FABJRCH8 FABJRCH9
    FABJRCHA FABJARC0
  

Temporary fix

Comments

• ×**** PE10/06/29 FIX IN ERROR. SEE APAR PM17402  FOR DESCRIPTION
  

APAR Information

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

  PK53844

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

  UK31062

Modules/Macros

• FABJARC0 FABJDBRA FABJDBRC FABJDBR7 FABJDBR8
  FABJDBR9 FABJMAIN FABJRCHA FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9
  FABUARCN
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK31062

     UP07/11/10 P F711

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.