IBM Support

IT31136: OPTION TO AVOID PERCENT ENCODING OF SPECIAL CHARACTERS IN REST QUERY STRING PARAMETERS

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • RESTRequest node percentage encode all special characters in
    query string or request URL and a user may want to disable the
    same.
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    <span style="background-color:rgb(255, 255, 255)">All users of
    IBM Integration Bus v10 and IBM App Connect Enterprise v11 using
    REST Request Node. </span>
    
    
    Platforms affected:
    z/OS, MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    <span style="background-color:rgb(255, 255, 255)">REST Request
    node will percent-encode special characters in </span><span
    style="background-color:rgb(255, 255, 255)">query string
    parameters.  </span>For eg: if you specify a comma(,) in the
    parameter value using LocalEnvironment override as below
    
            SET
    OutputLocalEnvironment.Destination.REST.Request.Parameters.param
    1 = 'a,b'
    
    The resulting URL will have the query string in percent encoded
    form as http://<host>:<port>/path?param1=a%2Cb
    <span style="background-color:rgb(255, 255, 255)">
    </span>
    A user may want the URL to be coming out in the non-encoded form
    as  <span style="background-color:rgb(255, 255,
    255)">http://<host>:<port></span><span
    style="background-color:rgb(255, 255,
    255)">/path?param1=a,b</span>
    

Problem conclusion

  • A new LocalEnvironment override named <span
    style="background-color:rgb(255, 255,
    255)">QueryStringDoNotPercentEncodeCharacters is introduced
    which can be used to specify characters in the query string that
    are not to be percent-encoded.
    
    For eg: To avoid percent-encoding 'comma' and 'greater than'
    symbol, set LocalEnvironment  as below </span>
         SET
    OutputLocalEnvironment.Destination.REST.Request.QueryStringDoNot
    PercentEncodeCharacters = ',> ';
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v10.0      10.0.0.21
    v11.0      11.0.0.9
    
    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

    IT31136

  • Reported component name

    INTEGRATION BUS

  • Reported component ID

    5724J0540

  • Reported release

    A00

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-12-03

  • Closed date

    2020-05-18

  • Last modified date

    2020-05-18

  • 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

    INTEGRATION BUS

  • Fixed component ID

    5724J0540

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
19 May 2020