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 number
IT45351
Reported component name
APP CONNECT ENT
Reported component ID
5724J0550
Reported release
B00
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2024-01-26
Closed date
2024-02-16
Last modified date
2024-02-16
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
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDR5J","label":"IBM App Connect Enterprise"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"B00","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"}}]
Document Information
Modified date:
16 February 2024