PM91661: DFHEX0001 ABEND 0C4 IN DFHXCTRP WITH GTF TRACE ACTIVE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In an EXCI environment, a DFHXCOPT table is coded to turn on
  GTF tracing.
  DFHXCPRH has called the trace domain to write trace entry
  XCPRH_NO_CICS_ON_DPL_2. The trace entry length is x'0126'. The
  GTRACE call only accepst a maximum length of x'100'. So, 2
  GTRACE calls are needed. The first one worked fine. The
  remainder x'26' is to be put into the GTF buffer pointed to by
  field TRA_GTF_BUF_PTR in the trace anchor block. The
  instruction that gets the buffer pointer is,
  LGF   R2,TRA_GTF_BUF_PTR
  .
  TRA_GTF_BUF_PTR is a 64 bits field. The LGF instruction is
  loading from a 32 bit field into a 64 bit register.
  The value in TRA_GTF_BUF_PTR is x'00000000 xxxxxxxx'. So what's
  get loaded into register 2 is the first 4 bytes of zeros. Then
  the next instruction tries to move a character to where R2
  points and results in the program check.
  
  
  
  
  
  
  
  
  Additional Symptom(s) Search Keyword(s): KIXREVSCB   DFHEX0115
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHEX0001 Abend 0C4 in DFHXCTRP with    *
  *                      GTF trace active.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When GTF=YES and TRACE=1 or 2 is specified in the
  EXCI options table (DFHXCOPT) DFHXCTRP is driven to write
  out the trace data. If the data is longer than 256 bytes
  DFHXCTRP writes out the first 256 bytes, and then loops
  around writing out the rest. The address of the data is
  held in a 64 bit field but the code in the loop uses an LGF
  instruction to load it into a register. This means that only
  bits 0 to 31 of the address are loaded. In this case the
  address pointed to data below the bar, and so bits 0 to 31
  contained zeros. This resulted in an abend 0C4 when DFHXCTRP
  attempted to use this address.
  Additional keywords: msgDFHEX0001 abend0C4 S0C4 abendS0C4
  

Problem conclusion

• DFHXCTRP has been modified to correctly load the address of
  the data to be traced.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM91204

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

  UK96163

Modules/Macros

• DFHXCTRP
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UK96163

     UP13/08/02 P F308

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.