PH64857: CUSTOMISED VERSION OF XDTRD EXIT BEHAVES DIFFERENTLY AT CICS TS 6.1

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The customer upgraded to CICS TS 6.1 (from 5.5) and they
  subsequently found that their customised XDTRD exit behaved
  differently.
  
  They issued a CEMT S FI(<data table>)OP (to load records from
  a VSAM file in to a data table) for the same data table in both
  versions and found that the statistics reported were different.
  
  At CICS TS 5.5 their CPSM WUI entry for the data table showed :
  
  Number of records added to table by READ requests 79889
  Number of records added from WRITE requests 0
  Number of add requests rejected by user exit 75311
  
  Whilst at CICS TS 6.1 :
  .
  Number of records added to table by READ requests 79889
  Number of records added from WRITE requests 0
  Number of add requests rejected by user exit 0
  .
  The statistics produced at CICS TS 5.5 are correct and those
  at CICS TS 6.1 are incorrect.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using User Exit XDTRD, if it       *
  *                      returns with a rejection response, this *
  *                      is not reflected in the corresponding   *
  *                      statistics.                             *
  ****************************************************************
  When loading a Shared Data Table file, user exit XDTRD can be
  enabled. If this exit returns UERCDTRJ, to reject the record,
  the response is overwritten by a subsequent internal
  preallocation check. This results in the corresponding trace,
  statistics, and add processing ignoring the return code
  provided by user exit XDTRD.
  

Problem conclusion

• DFHDTUP has been altered to ensure that any return code
  provided by user exit XDTRD is correctly passed back up
  the code path to ensure the add processing does not occur and
  that both trace exit entries and statistics reflect the correct
  values.
  

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:

  UO03003 UO03004

Modules/Macros

• DFHDTUP
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO03004

     UP25/05/03 I 1000

• R500 PSY UO03003

     UP25/05/01 P F504

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.