A fix is available
APAR status
Closed as program error.
Error description
You are running CICS TS 3.2 and receive the following error message: DFHAP0001 An abend (code 0C4/AKEA) has occurred at offset X'00000486' in module DFHWBCLI. Failing instruction is: MVCLE R0,R14,X'0' The length registers R1 and R15 both contain a negative value- x'FF6FFFE7'. There has been a massive overlay of storage, including CICS control blocks. This error was followed by other errors such as: DFHLD0001 An abend (code 0C4/AKEA) has occurred at offset X'1A70' in module DFHLDLD. DFHSM0002 A severe error (code X'030E') has occurred in module DFHSMGF. DFHFC0002 A severe error (code X'232C') has occurred in module DFHFCQU. DFHRM0002 A severe error (code X'020C') has occurred in module DFHRMUW. These subsequent errors were due to CICS control blocks being overlaid. A look into CICS trace show the first abend0c4 and shows the commarea passed to DFHWBCLI. *EXC* - Program-Check FUNCTION(START_PROGRAM) PROGRAM(DFHWBCLI) CEDF_STATUS(NOCEDF) EXECUTION_SET(FULLAPI) ENVIRONMENT_TYPE(EXEC) SYNCONRETURN(NO) COMMAREA(31DF6F90 , 000000A0) LINK_LEVEL(2) In this commarea we can see the application program passed a bad length to DFHWBCLI- wbcli_request_body_len ---> FFFFFFFF DFHWBCLI did not check for this negative length and caused a massive overlay. Additional symptoms: KIXREVSLD
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: Abend 0C4/AKEA happens when DFHWBCLI * * is linked with WBCLI_REQUEST_BODY_LEN * * set to -1. * **************************************************************** * RECOMMENDATION: * **************************************************************** An application links to DFHWBCLI to send an HTTP request. The commarea passed to DFHWBCLI has field WBCLI_REQUEST_BODY_LEN set to -1, x'FFFFFFFF'. DFHWBCLI first allocates a buffer, then reads the supplied request body into it with the length specified by WBCLI_REQUEST_BODY_LEN (X'FFFFFFFF'). DFHWBCLI is running with CICS Key, so CICS storage is overlaid. This results in an abend0C4 and then CICS terminates. Keywords: abendS0C4 S0C4 abendAKEA msgDFHAP0001
Problem conclusion
DFHWBCLI has been altered to verify whether the length of user-provided request header or body is negative before sending HTTP request. And two new reason codes have been defined. The CICS Transaction Server for z/OS Version 4 Release 1 Internet Guide, SC34-7021-02 has been altered in Appendix I ('The DFHWBCLI Web Client Interface') under the heading of 'WBCLI_REASON' to add two new reason codes The location is right after the explanation of WBCLI_REASON_TRUNCATED. The new reason codes has been added to say: " 10 (WBCLI_REASON_INVALID_HEADER_LENGTH) The length of the user-provided request header specified in WBCLI_HEADER_LEN was invalid. 11 (WBCLI_REASON_INVALID_BODY_LENGTH) The length of the user-provided request body specified in WBCLI_REQUEST_BODY_LEN was invalid. "
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM50687
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2011-10-25
Closed date
2011-11-29
Last modified date
2012-01-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK74266 UK74267 UK74268 UK74269
Modules/Macros
DESWBCL DFHWBCL DFHWBCLA DFHWBCLB DFHWBCLC DFHWBCLD DFHWBCLH DFHWBCLI DFHWBCLJ DFHWBCLL DFHWBCLM DFHWBCLO DFHWBCLT DFHWBCLV
SC34702102 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R600 PSY UK74266
UP11/12/02 P F112
R601 PSY UK74267
UP11/12/02 P F112
R602 PSY UK74268
UP11/12/02 P F112
R603 PSY UK74269
UP11/12/02 P F112
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 January 2012