PM33813: DFHAP0001 AN ABEND (CODE 0C4/AKEA) HAS OCCURRED AT OFFSET X'0000237C' IN MODULE DFHXTP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You received DFHAP0001 An abend (code 0C4/AKEA) has
  occurred at offset X'0000237C' in module DFHXTP
  The failing instruction is 95F06000/doing
     CLI ARGCODE,XTPARGLM
  in DFHXTP UK29877 at offset 237C. R6/0CDA62A6 is bad.
  .
  The stack for the running transaction:
  DFHKETA
  DFHDSKE
  DFHXMTA
  DFHMRXM
  INIT_XM_CLIENT
  DFHZTSP/UK41036
  DFHXTP/UK29877
  DFHSRP
  DFHMEME
  SEND
  CONTINUE_SEND
  TAKE_A_DUMP_FOR_CALLER
  DFHDUDU
  SYSTEM_DUMP
  TAKE_SYSTEM_DUMP
  .
  The trace shows the task is attached to the terminal,
  did a TRANS_ROUTING. Then performed TRANSFORMER_2 via
  Link TCTTE. Prior to the PROGRAM_CHECK, DFHAPCR did
  IMPORT_ALL/OK CHANNEL_TOKEN() DATA_END() SIZE().
  
  The dump shows that the problem in XTP is that
  Register 2 gets corrupted after a CHANNEL has been IMPORTED
  sussesfully. R2 end up containing the TCSE address instead of
  the length of the CHANNEL data. R2 is then use to get the
  displacement to the next argument to unwrap in the TIOA. The
  next argument address calculation results in an invalid address,
  hence the program check.
  Additional Symptom(s) Search Keyword(s): KIXREVJXD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAP0001, abend0C4 in DFHXTP   *
  *                      may occur when a transaction is         *
  *                      routed to an AOR with a CHANNEL.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A transaction is routed from a TOR to an AOR with a CHANNEL.
  In the AOR the request is received and DFHZTSP calls DFHXTP
  transformer 2 to unwrap the data.
  Since a CHANNEL is present, DFHXTP calls DFHAPCR IMPORT_ALL
  to rebuild the CHANNEL.
  On return from DFHAPCR, DFHXTP updates the statistics for
  terminal shared channels, corrupting register 2 with a TCSE
  address before returning to label NEXTARG.
  NEXTARG expects register 2 to contain the length of the actual
  CHANNEL data to move to the next argument in the TIOA.
  The CHANNEL was the last argument. The calculation of the
  next argument results in an address which is before the end of
  the TIOA. The code thinks it has more arguments to process
  and starts addressing random storage which results in
  the abends0C4 in DFHXTP.
  
  Additional Keywords: MSGDFHAP0001 CDEARGCH_EXT 0C4 S0C4
  

Problem conclusion

• Routine CDEARGCH_EXT in DFHXTP has been changed to save and
  restore register 2 when updating the statistics for terminal
  shared channels.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM20802

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

  UK67695

Modules/Macros

•    DFHXTP
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK67695

     UP11/05/19 P F105

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.