PH61909: SPE ADAPTER WITH GETCODELISTITEMBYSENDERCODE CALL IS NOT RETURNING THE EXPECTED UTF-8 CHARACTERS

APAR status

• Closed as program error.

Error description

• This issue occurs when using the IBM Sterling Transformation
  Extender (ITX) SPE adapter to integrate with IBM Transformation
  Extender Advanced (ITX-A).
  
  After importing a code list into ITX-A that contains
  UTF-8/Hebrew characters, an ITX map that then makes a SPE
  adapter call, the following map rule example can result in
  corrupted output:
  
  = CPACKAGE(GET("SPE", "-TV+ -C getCodeListItemBySenderCode -D '"
  
  + Code:sequence:In1 + "' -B CHARGECODES -K 2"), "UTF-8")
  
  Example corrupted output:
  
  <Description>Company ABC ???? OCEAN FREIGHT</Description>
  

Local fix

• ITXCQ - ITX00062443
  AD / PB
  Circumvention: None
  

Problem summary

• Users Affected:
  IBM Transformation Extender users using Standards Processing
  Engine (SPE)/ ITX Advanced Adapter.
  
  Problem Description:
  The "getCodeListItemBySenderCode" and
  "getCodeListItemByReceiverCode" function calls do not return the
  expected UTF-8 characters to the map resulting in an invalid
  output during transformation.
  
  Platforms Affected:
  All
  

Problem conclusion

• Fixed a problem with SPE adapter where it now converts the
  string to bytes using UTF-8 encoding before returning the bytes
  to the map from "getCodeListItemBySenderCode" and
  "getCodeListItemByReceiverCode" DataHarness function calls.
  
  Applies to:
  10.1.0.2, 10.1.1.1, 10.1.2.1, 11.0.0.0
  
  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 Passport
  Advantage:
  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