PI93253: DFHTR0112 0C4 IN MODULE DFHTRPT AFTER TRACE CALL FROM DFHFCCA

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS puts out a message and dump for:
  .
  DFHTR0112 Bad data passed for tracing to module DFHTRPT.
  .
  Kernel error also shows an 0C4 occurred in DFHTRPT. Module
  DFHFCCA is processing a RELEASE_LOCKS request. CICS trace shows
  the problem occurs trying to trace the return from VSAM, trace
  ID, AP 0B89 FCCA event:
  .
  AP 0B89 FCCA EVENT RPL_REQUEST_AFTER_VSAM - RESP()
  .
  TR 0102 TRPT *EXC* - INVALID-DATA-PASSED: CALLING DOMAIN AP:
             PARAMETER LIST WAS FUNCTION(TRACE_PUT) POINT_ID(B89)
  .
  All of the parameters are actually incorrect. The FCAA
  RPL_REQUEST_BEFORE_VSAM request traced shortly before this,
  traced all the parms correctly.
  .
  The problem occurs when the call to VSAM has to suspend to wait
  for the I/O to complete. The DFHFCCA routine to suspend the task
  alters the stack field that points to the RPL. So when the VSAM
  request completes, DFHFCAA tries to trace the RPL but has lost
  addressability to it.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVxxx
  dfhfcca_trace_rpl_after_vsam  dfhfcca_enter_rlswait
  R13_SAVEAREA.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS issues msgDFHTR0112 while          *
  *                      attempting to write trace entry         *
  *                      AP 0B89                                 *
  *                      FCCA EVENT RPL_REQUEST_AFTER_VSAM       *
  ****************************************************************
  A CICS task is performing a syncpoint, committing updates
  to RLS. DFHFCRC PERFORM_COMMIT is called, and invokes VSAM
  to perform IDALKREL. VSAM needs to suspend the task and
  calls back to CICS using the RLSWAIT exit.
  The exit runs, and needs to save some values into the
  current CICS stack entry. The location used to save the R13
  value intersects with the location being used to hold the
  RPL address.
  When the exit completes, CICS attempt to write trace entry
  AP 0B89 FCCA EVENT RPL_REQUEST_AFTER_VSAM.
  This is a File Control level 2 trace entry. DFHFCCA attempts
  to reload the RPL address from the saved location, but this
  has been overwritten by the RLSWAIT exit.
  Incorrect data is passed to trace domain. This may result in
  message
  DFHTR0112 Bad data passed for tracing to module DFHTRPT.
  

Problem conclusion

• DFHFCCA has been updated to ensure that the offsets of the save
  area locations used by the RLSWAIT exit do not intersect with
  other items.
  

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:

  UI53951

Modules/Macros

• DFHFCCA
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI53951

     UP18/02/21 P F802

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.