APAR status
Closed as program error.
Error description
If the local environment is used to override the Web service URL in an Integration Node, for example, DECLARE URL CHARACTER MyURL || 'search?q=' || 'hello'; SET OutputLocalEnvironment.Destination.HTTP.RequestURL = URL; and the query string contains reserved characters, then these characters will be incorrectly percent encoded. This may result in an HTTP Response status error, for example, "404 Not Found".
Local fix
In the following simple example, the URL is concatenated with a query string that includes the '=' reserved character and is then used to dynamically set the RequestURL in the HTTPRequest node using the Local Environment override: SET MyURL = 'https://www.google.co.uk/'; DECLARE URL CHARACTER MyURL || 'search?q=' || 'hello'; SET OutputLocalEnvironment.Destination.HTTP.RequestURL = URL; The defect will result in the '=' character being percent encoded, which in turn may result in an HTTP status error. To avoid the error without having to apply the fix, instead of the example ESQL code as above, set RequestURL to the base URL and override the QueryString in the Local environment: SET MyURL = 'https://www.google.co.uk/'; SET OutputLocalEnvironment.Destination.HTTP.RequestURL = MyURL; SET OutputLocalEnvironment.Destination.HTTP.QueryString.search = 'hello'; For more details about the Local environment overrides that can be used for the HTTPRequest node, please see the following topic in the Knowledge Center: https://www-01.ibm.com/support/knowledgecenter/SSMKHH_9.0.0/com. ibm.etools.mft.doc/ac04595_.hem
Problem summary
**************************************************************** USERS AFFECTED: All users of IBM Integration Bus using Local Environment overrides to set the RequestURL of the HTTPRequest node. Platforms affected: z/OS, MultiPlatform **************************************************************** PROBLEM DESCRIPTION: If the HTTPRequest node Request URL is dynamically set using the Local Environment override and includes a query string that contains reserved characters, then all or most of the reserved characters will be percent encoded, depending on the platform. On z/OS, all of the reserved characters in the following list will be percent encoded, i.e., : / ? # [ ] @ ! $ & ' ( ) * + , ; = On distributed, all of the reserved characters in the following list will be percent encoded, i.e., : / ? # [ ] @ ! $ ' ( ) * + , ; (& and = will not be percent encoded on distributed). This can result in HTTP error status codes, for example, '404 Not Found'. There are a number of resource name changes between WebSphere Message Broker and IBM Integration Bus Version 9.0. For details visit http://www-01.ibm.com/support/knowledgecenter/SSMKHH_9.0.0/com.i bm.etools.mft.doc/bb23814_.htm
Problem conclusion
The product no longer percent encodes the URL reserved characters. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v10.0 10.0.0.3 v8.0 8.0.0.7 v9.0 9.0.0.5 The latest available maintenance can be obtained from: http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041 If the maintenance level is not yet available,information on its planned availability can be found on: http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308 ---------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
PI45626
Reported component name
IB Z/OS
Reported component ID
5655IBB00
Reported release
900
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-07-24
Closed date
2015-11-13
Last modified date
2016-09-15
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Fixed component name
IB Z/OS
Fixed component ID
5655IBB00
Applicable component levels
R900 PSY
UP
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"9.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020