PM29953: ABEND CODE ---/AKEC OFFSET X'0560' MODULE DFHSMPQ GET_LENGTH(0) STORAGE MANAGER LOOP IF NO FREE AREAS IN THE WBGENRAL SUBPOOL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS TS v4.1 and experience the following
  error messages:
  DFHSM0001 An Abend (code ---/AKEC) has occurred at offset
  X'0560' in module DFHSMPQ.
  DFHWB0002 A severe error (code X'070C' has occurred in module
  DFHWBCL.
  .
  When you lookat the Kernal Error table you see the following
  abend also occurred at the same time as the dumps:
  Abend (code ---/0999) has occurred at offset 'X0856' in module
  DFHKETIX.
  This problem is exposed by the user application making an
  old-style LINK to DFHWBCLI for an outbound HTTP POST request
  with no body. The WBCLI_METHOD is set to WBCLI_METHOD_POST.
  WBCLI_REQUEST_BODY_LEN is 0  which means that there is no HTTP
  body. This is an illogical combination.
  The POST method is specifically designed for requests that need
  to provide an HTTP body. If the same thing is done using the WEB
  API - a WEB SEND POST without a body an INVREQ with RESP2 of 34
  will result.
  DFHWBCLI has never imposed any restriction of providing a body
  with an HTTP POST. Issuing such a request doesn't automatically
  lead to the problem either.
  The code which loops in storage manager is only reached if there
  are no free areas allocated to the WBGENRAL subpool.
  If WBGENRAL has a few bytes of storage of available, a
  zero-length getmain for WBOCONVB conversion storage would not
  loop.
  
  Additional Symptom(s) Search Keyword(s):
  DFHSM0001 DFHWB0002  code X'070C' DFHWBCL CODE=WB0002
  KIXREVEPH
  

Local fix

• Alter the application to set WBCLI_METHOD to WBCLI_METHOD_GET
  when no HTTP body is provided.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: MSGDFHSM0001 code AKEC followed by      *
  *                      MSGDFHWB0002 code 070C.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An application links to DFHWBCLI to send an HTTP POST request
  to a remote server. WBCLI-METHOD is set to WBCLI-METHOD-POST
  and WBCLI-REQUEST-BODY-LEN is set to 0 indicating there is no
  message body.
  DFHWBCL function WRITE_REQUEST is called to send the request
  to the remote HTTP server. An HTTP POST should logically
  include a body. WBCLI-NATIVE-REQUEST-BODY is off so DFHWBCL
  performs logic to translate the request body from EBCDIC to
  ASCII. As the request body is length 0, DFHWBCL issues a
  zero length getmain from the WBGENRAL subpool to hold the
  translated message body.
  This can under certain environmental situations cause a loop
  which will result in message DFHSM0001 error code AKEC followed
  by DFHWB0002 error code 070C.
  

Problem conclusion

• DFHWBCL WRITE_REQUEST has been changed to bypass HTTP body
  translation when the request body is length 0.
  

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:

  UK64573

Modules/Macros

•    DESWBCL  DFHWBCL
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK64573

     UP11/02/09 P F102

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.