Using converters from a previous level of the product

Before you start:
  • Read Code page converters, which provides information about what a code page converter is, and about the code pages that WebSphere Event Broker supports.

If you have applications that need a code page that is not in the default set of code pages that WebSphere Event Broker Version 6.0 supports, you can use a code page from an earlier version of WebSphere Event Broker. The changes in converters between the previous level of the broker and WebSphere Event Broker Version 6.0 are significant, so the set of converters from the previous level has been included with WebSphere Event Broker Version 6.0.

To use one of these converters, perform the following steps:

  1. Extract the list of WebSphere Business Integration Event Broker Version 5.0 code page converters from your installation directory to a temporary directory:
    • On Windows: extract "install_dir\sample\converters\mqsiconverters-v5.zip".
    • On Linux: extract install_dir/sample/converters/mqsiconverters-v5.tar.bz2.
    • On UNIX: extract install_dir/sample/converters/mqsiconverters-v5.tar.gz.
    Where install_dir is the home directory of your WebSphere Event Broker installation.
  2. Copy the .cnv file for the required code page to a directory that is accessible by the broker; for example, on UNIX systems: /var/mqsi/converters, and on Windows: C:\Documents and Settings\All Users\Application Data\ibm\mqsi\converters. To make sure that there is no conflict with an existing converter, give the file a unique name. To ensure that the file does not cause a conflict of filenames, do not use a number that is already used in one of the supported code pages. If the converter is to be used by ESQL, the converter must be of the form ibm-<ccsid> because converters are referenced through their numeric CCSID, not their name.
  3. Associate the broker with the code page converter by entering the name of the directory where the converter is stored:
    • To create a new broker that is associated with a converter, enter the following command at a command prompt:
      mqsicreatebroker -c directory 
    • To alter an existing broker to recognize the converter, enter the following command at a command prompt:
      mqsichangebroker -c directory
    • To affect all the products and the broker command-line tools using international components for Unicode (ICU), add the directory to the ICU_DATA environment variable.
    If you have already used either the mqsicreatebroker command or the mqsichangebroker command to specify the code page converter to be used, the broker ignores the ICU_DATA value.

    You can copy the entire set of converters (*.cnv) and aliases (*.icu) to reproduce the behavior of the previous level of the product.

    Start of changeDo not use mqsicreatebroker -c to set the converter path if you are using a converter that matches one of the built-in converters that are provided with Version 6.0, and that converter is the local code page for the broker. Use the ICU_DATA environment variable instead.End of change

Related concepts
Code page converters
Related reference
Supported code pages