PM49556: 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 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 3 Release 2
  Internet Guide, SC34-6831-04 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:

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

  PM50687 PM50688 UK74285 UK74286 UK74287 UK74288

Modules/Macros

•    DESWBCL  DFHWBCL  DFHWBCLA DFHWBCLB DFHWBCLC
  DFHWBCLD DFHWBCLH DFHWBCLI DFHWBCLJ DFHWBCLL DFHWBCLM DFHWBCLO
  DFHWBCLT DFHWBCLV
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK74285

     UP11/12/02 P F112

• R501 PSY UK74286

     UP11/12/02 P F112

• R502 PSY UK74287

     UP11/12/02 P F112

• R503 PSY UK74288

     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.