A fix is available
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 number
PH14427
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
200
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2019-07-12
Closed date
2019-08-16
Last modified date
2024-04-22
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.
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Document Information
Modified date:
22 April 2024