PM50688: DFHAP0001 ABEND CODE 0C4/AKEA HAS OCCURRED AT OFFSET 486 INTO DFHWBCLI. MVCLE INSTRUCTION WITH NEGATIVE LENGTH CAUSED OVERLAY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS TS 4.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 2
  Internet Guide, SC34-7173-01 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 is sysrouted FROM one or more of the following:

  PM49556

• APAR is sysrouted TO one or more of the following:

  UK74256 UK74258 UK74259 UK74260

Modules/Macros

•    DFHWBCLD DFHWBCLH DFHWBCLI DFHWBCLL DFHWBCLO
  DFHWBTRI
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R700 PSY UK74256

     UP11/12/02 P F112

• R701 PSY UK74258

     UP11/12/02 P F112

• R702 PSY UK74259

     UP11/12/02 P F112

• R703 PSY UK74260

     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.