Before you start:
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.
- 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 from 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