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

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 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