WebSphere Message Brokers
File: ac30160_
Writer: Catherine Tucker

Task topic

This build: July 31, 2007 21:20:01

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 Message Broker supports.

If you have applications that need 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. The changes in converters between the previous level of the broker and WebSphere Message Broker Version 6.0 are significant, so the set of converters from the previous level has been included with WebSphere Message Broker Version 6.0.

To use one of these converters, take the following 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 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 the copied file does not 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 you have stored the converter:
    • To create a new broker that is associated with a converter, include the -c parameter on the mqsicreatebroker command.
    • To alter an existing broker to recognize the converter, include the -c parameter on the mqsichangebroker command.
      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.

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

    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, do not use the mqsicreatebroker command with the -c parameter to set the converter path Use the ICU_DATA environment variable instead.

Related concepts
Code page converters
Related tasks
Changing locales
Related reference
Supported code pages
mqsicreatebroker command
mqsichangebroker command
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:20:01

ac30160_ This topic's URL is: