PM09380: AFTER MIGRATION TO 3.2, HTTP FILE UPLOAD FUNCTION FAILS TRACE SHOWS MIME_PARSE_ERROR, REASON(FORMS_DECODE_ERROR)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You migrated from CICS TS 2.3 to 3.2, and find that the HTTP
  file upload function no longer works. A dump taken with active
  tracing shows the following exception trace entry:
            WB 0E07 WBFM  *EXC* - MIME_PARSE_ERROR
  
            *Headers do not end with CR LF   *
            *Error at +0000053 in headers for*
            * field 0000001                  *
            *Content-Disposition: form-data; *
            *name="form_name"....            *
  The trace shows that CICS was executing:
            FUNCTION(PARSE_MULTIPART_FORM)
  CICS reports an EXCEPTION response with reason:
            REASON(FORMS_DECODE_ERROR)
  Additional Keywords:
  KIXREVSWM
  FORMFIELD_STRUCT_FORM_ERR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: After migration to CICS/TS 3.2 an HTTP  *
  *                      file upload fails. Trace shows *EXC*    *
  *                      MIME_PARSE_ERROR                        *
  *                      REASON(FORMS_DECODE_ERROR).             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The Web forms processor DFHWBFM is parsing the first field of a
  multi-part form as part of an HTTP file upload request. DFHWBFM
  processes the headers by scanning for CRLFs. DFHWBFM contains
  code to support folded lines which are indicated by a CRLF
  followed by whitespace. In this case the null header indicating
  the end of the headers is followed by a single space (the one
  byte of user data for this field). This causes the CRLF to be
  handled as if it was signaling the continuation of a folded line
  and be ignored. The parsing loop then reaches the end of the
  data it had to process, without apparently having found the
  final CRLF, resulting in the reported MIME_PARSE_ERROR
  exception. The HTTP file upload fails.
  

Problem conclusion

• The Web forms processor DFHWBFM has been changed to identify and
  action a null header, signalling the end of the headers, before
  checking for header continuation.
  

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:

  PM10495 UK55734

Modules/Macros

•    DFHWBFM
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK55734

     UP10/04/02 P F004

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.