PH14427: DFHAP0001 REGNNAME AN ABEND (CODE 0C4/AKEX) HAS OCCURRED AT OFFSET X'05FE' IN MODULE DFHCV64.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Migrated to CICS TS 5.5 and now getting the following abend.
  .
  DFHAP0001  An abend (code 0C4/AKEX) has occurred
             at offset X'05FE' in module DFHCV64.
  .
  We see the following Internal Trace Exception.
  .
  AP 4827 CV64  *EXC* RECOVERY_ENTERED FUNCTION(CONVERT_DATA)
                 CONVERSION_TOKEN(3899B0AC , 00000000)
                 SEGMENTED(NO)
                 SOURCE_BUFFER64(00000050_42100000 ,
                 00000000_00000000 , 00000000_0000001E)
                 TARGET_BUFFER64(00000000_00000000 ,
                 00000000_00000000 , 40404040_40404040)
  .
  This problem is caused by changes to processing in DFHWBCL.
  That module was restructured in 5.5 to support 64 bit buffers.
  Part of that restructure separated out and moved the routines
  used to receive data into a supplied or a SET buffer.  This was
  controlled by checking WBCL_BODY.  That all works fine when
  using the WEB API because you can either have SET or INTO, but
  not both.  The problem comes when using DFHWBCLI which ends up
  passing in both WBCL_BODY and WBCL_SET_BUFFER.  The body address
  is 0 so that causes the 0C4 when DFHWBCL tries to use it.
  .
  This problem may also result in DFHSO0001 An abend (code
  0C4/AKEX) has occurred at offset X'0E34' in module DFHSOS07.
  .
  In both cases the kernel stack shows that DFHWBCL has called
  RECEIVE_BODY_INTO_BUFFER instead of RECEIVE_BODY_INTO_SET_BUFFER
  .
  Additional Symptom(s) Search Keyword(s): KIXREVSCB
                                       Upgrade2CICS55
  

Local fix

• Please note, the DFHWBCLI interface is only retained in the
  current releases for compatibility and it is strongly
  recommended that applications are changed to use the WEB API
  commands instead.  If the application was using the API commands
  then it would not have experienced this problem.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHAP0001 or DFHSO0001 happens when     *
  *                      handling an HTTP request using DFHWBCLI *
  *                      with response receiving into a SET      *
  *                      buffer.                                 *
  ****************************************************************
  An application is using DFHWBCLI to send an outbound HTTP
  request. Parameter WBCLI_SET_RESP_BUFFER is turned on which
  means the response data will be received into a SET buffer. In
  this case the application will not supply a buffer and CICS
  should GETMAIN a SET buffer to contain the response data.
  DFHWBCL READ_RESPONSE is called to receive the response but
  parameter DFHWBCL_BODY is always passed. As the buffer is not
  supplied by application, the variable passed by parameter
  DFHWBCL_BODY is 0. This causes ABEND 0C4 when trying to access
  it.
  
  Additional keywords : msgDFHAP0001 msgDFHSO0001 AP0001 SO0001
  

Problem conclusion

• DFHWBCL has been changed to make sure a SET buffer is GETMAINed
  and used to receive the response data if parameter
  WBCLI_SET_RESP_BUFFER is turned on.
  FIXCAT: SWPSP/K
  

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:

Modules/Macros

• DFHWBCL  DFHWBCLI
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI64784

     UP19/08/17 P F908 ¢

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.