PK33381: MEDIATYPE MULTIPART / RELATED NEEDED FOR EXEC CICS WEB SEND

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• EXEC CICS Web Send command needs to support mediatype of multipa
  rt / related. DFHWBCL WRITE_REQUEST rejects MEDIATYPEs with
  embedded blanks. It relies on the absence of embedded blanks
  later when it plugs the MEDIATYPE into the Content-Type header
  which it builds.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: EXEC CICS WEB SEND returns INVREQ with  *
  *                      RESP2 of 32 when MEDIATYPE contains     *
  *                      embedded blanks.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When issuing an EXEC CICS WEB SEND (client) the MEDIATYPE
  parameter cannot contain spaces and can only be a maximum of 56
  characters.  The mediatype is a positional parameter of the
  Content-Type header and its IANA syntax allows it to be
  extended by optional keyword subparameters, delimited by
  semicolons and spaces. However CICS has provided no way to
  specify these additional keyword subparameters either
  on the MEDIATYPE parameter or on the HTTP Content-Type header,
  but they are required with the multipart/related mediatype.
  EXEC CICS WEB WRITE HTTPHEADER will allow more than 56 bytes
  and embedded blanks in CONTENT-TYPE but currently returns
  INVREQ if CONTENT-TYPE is included as a header in an outbound
  HTTP request.
  

Problem conclusion

• DFHEIWB and DFHWBCL have been changed to allow WEB WRITE
  HTTPHEADER to specify a CONTENT-TYPE header on outbound HTTP
  requests.
  DFHWBCL has been changed so MEDIATYPE is no longer required if
  a CONTENT-TYPE has already been provided by the application.
  The CICS Transaction Server for z/OS Application Programming
  Reference v3r1 manual SC34643404 will be changed in section
  describing WEB SEND (Client) as follows:
  1.The second paragraph of the MEDIATYPE description which
  begins "For requests which require a body,......" will be
  replaced with:
  For requests which require a body, you must specify the
  MEDIATYPE option,unless one has been provided by the
  CONTENT-TYPE parameter of WEB WRITE HTTPHEADER.'
  2.The following will replace the description for INVREQ RESP2
  value 133:
  133 MEDIATYPE option not allowed for second or subsequent chunks
      or when CONTENT-TYPE already provided.
  
  The CICS Transaction Server for z/OS Internet guide v3r1
  Reference v3r1 manual  SC34645004 will be changed in appendix
  1.2.
  section: HTTP headers on messages sent out from CICS
  in the second sub-bullet of the first bullet
  The sentence starting  'The exception is the TE header' will
  be replaced with:
  The exceptions are the TE Header and Content-type; application
  programs can add further instances of these headers.
  

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:

  UK21030

Modules/Macros

•    DESEIWB  DESWBCL  DFHEIWB  DFHWBCL  DFHWBCLB
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK21030

     UP07/01/09 P F701

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.