Readme for WBI Adapter for HTTP, version 1.2.1.IF3

The patch note contains the following sections:
 

 

CONNECTOR REVISIONS

UPGRADE INSTRUCTIONS

CONNECTOR REVISIONS   

This patch contains the following revisions since the last maintenance release:

 

Available as of Version

CR Number/APAR#

Feature

Description
1.2.1IF3 CR67602 During synchronous request processing, request is not failed when the adapter is unable to populate TLO response bo attribute. Fixed.
1.2.1IF3 CR67583 During synchronous request processing, HTTP error responses with empty payloads are ignored by the adapter. Fixed. All error responses with empty payloads will result in failure of the originating request.
1.2.1.IF2 CR72329/JR22039 HTTP(S) listeners fail redirected requests.

Problem background:

According to HTTP 1.1 specifications (http://www.w3.org/Protocols/rfc2068/rfc2068), section 5.2, an HTTP(S) listener checks the correctness of host and port information specified in the request with host and port information of the listener itself. If there is a mismatch, the listener will stop processing the request and respond with a 400 (Bad Request) status code.

Issue:

When incoming requests are being routed by an enterprise gateway system in order to hide the end point, the host and port information of the request has to be changed before being sent to the HTTP(S) listener (original request has host and port of the gateway). In some cases, such change is not supported by the gateway or is troublesome to implement in the gateway system.

Solution:

A new HTTP(S) listener property has been introduced to solve the above issue. Please note that using this property to disable the validation of host and port information of the request, puts the HTTP(S) listener out of compliance with HTTP 1.1 specification, section 5.2. Use of the new property should be restricted to the cases when an enterprise gateway system change is undesirable.

To use this feature, add the following property as an HTTP Connector Listener Property:

Property Name Possible Values
HostInfoValidation FailRequest - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request will be failed with 400 (Bad Request) status.

LogError - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request execution will continue.

Ignore - there will be no validation performed on the host/port info of the request.

Note: If the property does not have a valid value, the HTTP(S) listener will DEFAULT property value to FailRequest

1.2.1.IF1

CR70586/JR21370

In the case of asynchronous requests and inactive state, HTTP Adapter does not return error status to the client.

Fixed.


UPGRADE INSTRUCTIONS

Add, replace, or remove the following files and directories as indicated below:

 

For Connector Version

Platform 

Add / Replace / Remove

File (Starting from %CROSSWORLDS%/$CROSSWORLDS)
1.2.1.IF3 WIN & UNIX Replace the file %CROSSWORLDS%\connectors\HTTP\BIA_HTTP.jar

1.2.1.IF3

WIN & UNIX

Replace the file

%CROSSWORLDS%\connectors\HTTP\BIA_HTTP.jar

 

Oct 14th, 2005 2:28 PM

© 2005 IBM Corporation. Proprietary and Confidential. All Rights Reserved.