IBM Support

PK83596: HTTP OPTIONS REQUEST IS REJECTED WITH 405 METHOD NOT ALLOWED IF A NON-DEFAULT PORT AND A PROXY SERVER IS BEING USED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • HTTP OPTIONS request is rejected with 405 Method not allowed
    on the cics command WEB OPEN if a non-default port and a Proxy
    server is being used.
    The problem here is that the response to the OPTIONS request
    contains a Proxy-Connection header which DFHWBCL doesn't handle.
    DFHWBCL is expecting a Connection header.  Consequently DFHWBCL
    doesn't detect  that the connection is about to be closed by
    the proxy server.
    

Local fix

  • na
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS fails to close the connection to a *
    *                      remote server on receipt of a           *
    *                      "Proxy-Connection: close" header.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    A CICS application is making an outbound HTTP request via a
    proxy. A WEB OPEN command is issued which causes an OPTIONS
    request to be built and sent via the proxy to the remote server.
    The OPTIONS request gets rejected with an "HTTP/1.1 405 Method
    Not Allowed" response, and the remote server returns a
    "Connection: close" header.
    The proxy modifies the close header to be "Proxy-Connection:
    close" to indicate that the connection to the proxy server will
    be closing.
    CICS doesn't recognize the "Proxy-Connection: close" header , it
    was expecting to see "Connection: close", and consequently the
    connection is left open.
    The application then issues a WEB CONVERSE command. The SEND
    works but the proxy then closes the connection causing the
    RECEIVE to fail with CONNECTION_CLOSED.
    
    Additional keywords: AEIQ ABENDAEIQ AEIP ABENDAEIP
    

Problem conclusion

  • CICS has been changed so that it recognizes the
    "Proxy-Connection: close" header and will now close and re-open
    the connection.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK83596

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-03-30

  • Closed date

    2009-07-17

  • Last modified date

    2009-08-03

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

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

    PK91191 UK48613 UK48614

Modules/Macros

  •    DESWBCL  DFHWBCL
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK48613

       UP09/07/28 P F907

  • R500 PSY UK48614

       UP09/07/28 P F907

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 August 2009