A fix is available
APAR status
Closed as program error.
Error description
Customer's application issues a HTTP POST request and supplies the request data within the querystring of the URI instead of supplying the data within a message body. Thus, the request body length is zero. Also, no additional HTTP headers are supplied causing header length to be zero as well. . The application links to DFHWBCLI to handle the request. Routine SEND_HTTP_REQUEST issues a getmain for 'WBCLWORK' storage. The getmain length is the sum of WBCLI_HEADER_LEN and WBCLI_REQUEST_BODY_LEN which equates to zero. There is no check for zero length and DFHSMGF is called to handle the getmain. DFHSMGF returns INVALID_GET_LENGTH. . DFHWBCLI should be checking for zero length and not calling DFHSMGF in this instance. Additional keyword(s): KIXREVDAM Invalid Get Length Additional Symptom(s) Search Keyword(s): KIXREVxxx
Local fix
Application can be changed to pass the data via the request body ...... OR ...... make use of the WEB API commands instead of linking directly to DFHWBCLI.
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: INVALID_GET_LENGTH when linking * * to DFHWBCLI with zero header length * * and zero body length. * **************************************************************** * RECOMMENDATION: * **************************************************************** A program links to DFHWBCLI with zero WBCLI-HEADER-LEN and zero WBCLI-REQUEST-BODY-LEN. DFHWBCLI issues a GETMAIN to obtain a buffer with the total length of the body and the header. The length is zero, so GETMAIN returns with an exception and reason INVALID_GET_LENGTH. DFHWBCLI returns to the application with WBCLI-RESPONSE = WBCLI-RESPONSE-EXCEPTION (4) and WBCLI-REASON = WBCLI-REASON-GETMAIN-ERROR (4)
Problem conclusion
DFHWBCLI has been changed to verify the total length of HTTP body and header before GETMAIN a buffer.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM98126
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-09-30
Closed date
2014-01-02
Last modified date
2015-03-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI13987
Modules/Macros
DFHWBCLI DFHWBCL
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R800 PSY UI13987
UP14/01/10 P F401
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":"5.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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
05 March 2015