PH27267: DFHAP0002 SEVERE ERROR (CODE X'3196') IN MODULE DFHD2EX1 DUPLICATE ENTRY ADDING TO DIRECTORY D2CS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS TS 5.3 and receive the following
  error message:
  
  DFHAP0002 A SEVERE ERROR (CODE X'3196') HAS OCCURRED
            IN MODULE DFHD2EX1.
  
  
  Reviewing the dump at the time of this error shows the
  following exception trace:
  
  AP 3196 D2EX1 *EXC* - ADD_TO_DIRECTORY_FAILED
                        FUNCTION(ADD_ENTRY)
                        RESPONSE(EXCEPTION) REASON(DUPLICATE)
  
  Trace shows 2 different tasks, running on open TCBs, were
  issuing DB2 calls at the same time. They each had their own
  CSUB control block.   Our code updates offset x'10' into this
  control block- field csb_clock with results of a
  Store Clock Fast or STCKF instruction.
  
  This field- csb_clock is used as the name to be added to
  directory D2CS and needs to be unique.
  In this dump 2 different tasks have the same exact value
  for field csb_clock causing the duplicate exeption.
  The STCKF does not guarantee a unique value being
  passed back.
  
  
  
  Additional symptoms: KIXREVDAM
  3196
  duplicate directory domain DB2 SQL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend in CICS DB2 processing due to two *
  *                      transactions running with the same      *
  *                      csb_clock token.                        *
  ****************************************************************
  CICS uses a STCKF to create a token for every CSUB control
  block. This value is required to be unique, as it is
  used as the unique name that is added to the D2CS directory for
  use in later offline system dump processing.
  
  In a multiprocessor or high concurrency system the function that
  gets system time can, rarely, return a non-unique value which
  causes the abend, resulting in the following error message as a
  duplicate name is encountered:
  
  DFHAP0002 A SEVERE ERROR (CODE X'3196') HAS OCCURRED
            IN MODULE DFHD2EX1.
  
  
  Keywords: store clock, stck, stckf, csb_clock.
  

Problem conclusion

• DFHD2EX1 has been modified to ensure that it always creates a
  unique token by using SCTK.
  

Temporary fix

Comments

APAR Information

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

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

  UI71636 UI71637 UI71638 UI71639

Modules/Macros

• DFHD2EX1
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI71639

     UP20/09/24 P F009

• R100 PSY UI71638

     UP20/10/02 P F009

• R200 PSY UI71637

     UP20/10/02 P F009

• R300 PSY UI71636

     UP20/10/02 P F009

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.