IBM Support

PI45626: HTTP URL QUERY STRINGS INCORRECTLY PERCENT ENCODED

Subscribe

You can track all active APARs for this component.

 

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

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