PH63739: ITX V1 REST API WILL NOT ALLOW A PERIOD (.) IN THE APPLICATION PATH

APAR status

• Closed as program error.

Error description

• When using the IBM Sterling Transformation Extender (ITX) v1
  REST API to call maps that are in sub-directories that include a
  
  dot/period in the name, the maps fail to the found.
  
  For example, a map deployed in the standard map root (C:\Data)
  called OneInOneOut.mmc can be successfully called with the
  following curl command:
  
  curl -k -X PUT -d "test data" "https://127.0.0.1:8443/tx-rest/v
  1/itx/maps/direct/OneInOneOut?input=1&output=1"
  
  The same map deployed in C:\Data\Application can be called
  successfully with:
  
  curl -k -X PUT -d "test data" "https://127.0.0.1:8443/tx-rest/v
  1/itx/maps/direct/Application/OneInOneOut?input=1&output=1"
  
  However, the same map deployed in C:\Data\Application.test can
  NOT be called successfully with:
  
  curl -k -X PUT -d "test data" "https://127.0.0.1:8443/tx-rest/v
  1/itx/maps/direct/Application.test/OneInOneOut?input=1&output=1"
  
  
  
  Error message is:
  
  {"code":404,"message":"The map Application/test/OneInOneOut
  cannot be found. "}
  
  The dot/period is interpreted by the ITX REST API as another
  forward slash, and the map cannot be found.
  

Local fix

• ITXCQ - ITX00062692
  PB / PB
  Circumvention: Use directories that do not contain the period /
  dot character.
  

Problem summary

• Users Affected:
  IBM Transformation Extender users who want to use period (.) in
  the path for direct map run api
  
  Problem Description:
  ITX V1 REST API will not allow a period (.) in the application
  path
  
  Platforms Affected:
  All
  

Problem conclusion

• Fixed the issue, Curl command is working working fine if period
  (.) is used in path, in swagger Use '/' separator between path
  elements, but if trying out the
  map from the Swagger UI, use '%2F' as a separator instead.
  
  Applies to:
  10.1.2.1
  
  Fixed in the next service packs and releases.
  
  To obtain the fix for this APAR:
  
  To see if the next fix pack or product release is available,
  check the IBM Transformation Extender product Release Notes
  page:
  https://www.ibm.com/support/pages/node/318755
  
  If a fix pack release is available, download it from Fix
  Central:
  http://www.ibm.com/support/fixcentral/
  
  If a new product release is available, download it from
  PassportAdvantage:
  https://www.ibm.com/software/passportadvantage/pao_customer.html
  
  
  If the fix pack or product release is not available and you
  require the APAR fix immediately, request a Limited Availability
  Interim Fix (LAIF) by opening a support Case:
  https://www.ibm.com/mysupport
  

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

  ITX

• Fixed component ID

  5724Q2300

Applicable component levels