PH44729: DFHAP0002 IN DFHAPCR (CODE X'4E19') WHEN DELETING DFHTRANSACTION CHANNEL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The issue here is that CICS is attempting to delete a channel
  that does not exist. CICS is using the value in variable
  channel_token, which is zeros because the channel created by
  IMPORT_ALL was the DFHTRANSACTION channel. This is a special
  case and the token is held in a variable called
  tran_channel_token, it is this token that should be passed on
  the DELETE_CHANNEL call.
  
  
  CICS trace shows a DETACH_CHANNEL call getting an exception
  due to an INVALID_TOKEN.
  
  Additional Symptom(s) Search Keyword(s): KIXREVPAD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAP0002 reporting a severe    *
  *                      error in DFHAPCR can be seen when       *
  *                      issuing a DPL request with a commarea   *
  *                      that is >24k.                           *
  *                      Abend AXGA and ATNI may also be seen.   *
  ****************************************************************
  At CICS TS 5.6 and above a commarea that is >24k is shipped
  using the DFHTRANSACTION channel for an MRO connection.
  If the connection between the regions is lost while the
  application is running in the remote region, and the commarea to
  be passed back to the originating region is greater than 32k
  (so can not fit into one buffer) then an invalid channel token
  can be passed on the call to delete the channels owned by the
  task during clean up.
  
  This is because after a terminal error, CICS passes the program
  channel token instead of the transaction channel token. No check
  is made to see if a program channel exists before the call is
  made, so in the case where the only channel present is the
  transaction channel, the program channel token is zero/invalid.
  
  This problem does not apply to IPIC connections or LU6.2
  connections.
  

Problem conclusion

• CICS has been changed so that a check is made to see if a
  program channel exists before the call is made to delete a
  channel.
  The same check is also made for a transaction channel.
  

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:

  UI80337

Modules/Macros

• DFHAPCR  DFHXCSCR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI80337

     UP22/05/02 P F204

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.