Using converters from a previous level of the product

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

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

To use one of these converters follow these steps:

  1. Extract the list of WebSphere Business Integration Message 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 Message Broker installation.
  2. Copy the .cnv file for the desired codepage to a directory accessible to the broker. For example, on UNIX platforms: /var/mqsi/converters and on Windows:c:documents and setting\all users\application data\IBM\MQSI\converters If you want to make sure that there is no conflict with an existing converter, the file can be renamed to something unique. To check the file will not cause a conflict of filenames, make sure the number is not already used in one of the Supported code pages. Remember that if the converter is to be usable by ESQL it must be of the form ibm-<ccsid>. This is 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 associated with the converter, enter the following in a command prompt: mqsicreatebroker -c directory
    • To alter an existing broker to recognize the converter, enter the following at a command prompt: mqsichangebroker -c directory
    • To affect all the products and the broker command-line tools using ICU, add the directory to the ICU_DATA environment variable.
    If you have already used either the mqsicreatebroker command or the mqsichangebroker to specify the code page converter to be used, the broker ignores the ICU_DATA value.

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

Related concepts
Code page converters
Related reference
Supported code pages