Before you begin
The DFDL component includes its own copy of the ICU
libraries. This copy might be a different version level to those libraries
used by IBM Integration Bus. In this case,
if the new code page is to be used for DFDL parsing, the new code
page converter must also be copied into a specific location that can
be accessed by DFDL. The DFDL component uses the environment variable ICU_DATA as
a root location to search for convert tables. This environment variable
should already have been set for you by running mqsiprofile.
Procedure
- Copy the new code page convert .cnv file
to a subdirectory beneath the location that is specified in the ICU_DATA environment
variable. This subdirectory might need to be created, and its name
must match the version of the ICU libraries that are supplied with
the DFDL component.
For IBM Integration Bus, the new code page converter
file is copied into the $ICU_DATA/icudt48<platform-suffix> directory,
where the number 48 denotes
the version of ICU (4.8) that IBM Integration Bus uses.
To check if the level of ICU that is used by DFDL is different
to that used by IBM Integration Bus, complete
one of the following tasks for your platform:
On Linux and UNIX systems, look under the following
path to find a library name that starts with libicudata*:
<product installation path>/dfdlc/lib
The numerical suffix to the file name denotes the ICU
version.
On z/OS® systems,
look under the following path to find libraries with names that start
with libicudata*:
<product installation path>/lib
Any libraries that have a numerical suffix that is not 48 are
the DFDL ICU libraries, and the suffix denotes the ICU version.
On Windows systems,
look under the following path to find libraries with names that start
with icudt*:
<product installation path>\bin
Any libraries that have a numerical suffix that is not 48 are
the DFDL ICU libraries, and the suffix denotes the ICU version.
- If the ICU version that is used by the DFDL component within IBM Integration Bus is not 48,
a new subdirectory that is named icudt<DFDL-icu-version><platform-suffix> must
be created under the $ICU_DATAdirectory. For example: If ICU libraries with a suffix of 51 are
found, then the new code page converter file for DFDL must be copied
to $ICU_DATA/icudt51<platform-suffix> directory,
where the <platform-suffix> is one of the following
values:
- l for little-endian ASCII platforms
- b for big-endian ASCII platforms
- e for EBCDIC platforms