IT45351: CANNOT CREATE OR USE CUSTOM ICU CONVERTERS WITH ALIASES FOR ACE OR DFDL

APAR status

• Closed as program error.

Error description

• It is not possible to create or use a custom ICU converter with
  a custom alias that can be used by the core ACE runtime or the
  DFDL parser in the ACE runtime.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM App Connect Enterprise wishing to use custom
  codepage converters.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  IBM App Connect Enterprise does not include the necessary
  utilities and data files as part of its base installation to
  allow custom ICU codepage converters to be created that are
  compatible with the core ACE runtime or the DFDL parser.
  

Problem conclusion

• The product installation now includes the following additional
  executables:
  
  * server/bin/makeconv - ICU utility to compile a .ucm converter
  definition file into a .cnv file
  * server/bin/gencnval - ICU utility to compile the convrtrs.txt
  converter alias definition file into the cnvalias.icu converter
  alias data file used at runtime.
  * server/bin/dfdl_makeconv - Same as makeconv but for the
  version of ICU used by DFDL
  * server/bin/dfdl_gencnval - Same as gencnval but for the
  version of ICU used by DFDL
  
  The converter alias definition data files are alos provided on
  Linux and AIX
  
  * server/xml4c/data/icudt<ICU_VERSION><ENDIANNESS>/convrtrs.txt
  * server/xml4c/data/icudt<ICU_VERSION><ENDIANNESS>/cnvalias.icu
  
  On Windows these files are located in the
  server/icudata/icudt<ICU_VERSION><ENDIANNESS> directory.
  
  where <ICU_VERSION> is the version of ICU used by the core ACE
  product and DFDL, and <ENDIANNESS> is either b or l depending on
  whether the host system has a big endian or little endian
  processor.
  
  To obtain the versions of ICU used by the core ACE runtime and
  DFDL, and to obtain the list of all known converters use the
  command "mqsiservice -c"
  
  To create a custom converter:
  
  1. Use the appropriate makeconv or dfdl_makeconv command to
  compile to a .ucm definition file to the .cnv.
  2. Place the .cnv file in the
  server/xml4c/data/icudt<ICU_VERSION><ENDIANNESS> folder on Linux
  and AIX or the server/icudata/icudt<ICU_VERSION><ENDIANNESS>
  folder on Windows
  3. If the converter name is not of the form ibm-XXXX.cnv where
  XXXX is the CCSID you wish to use to refer to the converter at
  runtime then edit the convrtrs.txt file to add an alias from
  your custom converter name to the desired ibm-XXXX name.
  4. Run the gencnval or dfdl_gencnval to recompile the
  cnvalias.icu file from your modified convrtrs.txt file
  5. Run the mqsiservice -c command to confirm that your new
  converter has been detected correctly by ICU.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.25
  v12.0      12.0.12.0
  
  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

  APP CONNECT ENT

• Fixed component ID

  5724J0550

Applicable component levels