PM98126: INVALID GETMAIN ISSUED FROM DFHWBCLI

Obtain the fix for this APAR.

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 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.