The supplied profile is in the directory sample/profiles and shows how to set the locale environment variables LANG, LC_ALL, and NLSPATH. If you prefer, you can refer to the contents of this file for guidance.
If you use common desktop environment (CDE), use this to set the locale, in preference to setting LANG and LC_ALL directly. The NLSPATH variable respects either method.
You can use the executable localeto show your current locale. The command locale -adisplays all the locales currently installed on the machine.
When you start a broker component, the locale of that component is inherited from the shell in which it is started. The broker component uses the LC_MESSAGES environment variable as the search path in the NLSPATH environment variable (LC_MESSAGES is set when variable LC_ALL is exported).
Messages are sent to the syslog in the code page set by this locale. If you have multiple brokers that write to this syslog, their messages are in the code page of the locale in which they were started, for example:
locale | syslog code page | ccsid |
---|---|---|
pt_BR | iso8859-1 | 819 |
Pt_BR | ibm-850 | 850 |
PT_BR | utf-8 | 1208 |
Set the locale of the user ID that runs the syslog daemon to one that is compatible with the locales of all brokers that write to the syslog on that system, for example, utf-8. You can do this by setting the default locale. On Solaris, set the LANG and LC_ALL variables in /etc/default/init. On AIX and Linux, these variables are in /etc/environment. This task is not required on HP-UX.
If you want to add a new locale, refer to the operating system documentation for information on how to complete that task. If you add a new locale after you have installed WebSphere Business Integration Message Broker, you must complete the following instructions to ensure that product message catalogs are available:
Create symbolic links between the system locale directories and the product directories. For example, for Japanese:
/usr/share/locale/ja/LC_MESSAGES/BIPv500.cat -> /opt/mqsi/messages/Ja_JP/BIPv500.cat
or for Simplified Chinese:
/usr/share/locale/zh_CN/LC_MESSAGES/BIPv500.cat -> /opt/mqsi/messages/Zh_CN/BIPv500.cat
If there are no directories for your chosen language in /usr/share/locale/, there is an operating system locale problem, and you must reinstall the locale.
Create symbolic links between the system locale directories and the product directories. For example, for Japanese:
/usr/lib/nls/msg/ja_JP/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/Ja_JP/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/JA_JP/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/Ja_JP.IBM-932/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/Ja_JP.IBM-943/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/ja_JP.IBM-eucJP/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/JA_JP.UTF-8/BIPv500.cat -> /usr/opt/mqsi/messages/Ja_JP/BIPv500.cat
You might find that not all the directories indicated above exist in /usr/lib/nls/msg/; create links in those directories that exist. Do not create directories just to add the link shown.
If there are no directories for your chosen language in /usr/lib/nls/msg/, there is an operating system locale problem, and you must reinstall the locale.
Create symbolic links between the system locale directories and the product directories. For example, for Japanese:
/usr/lib/nls/msg/ja_JP.SJIS/BIPv500.cat -> /opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/nls/msg/ja_JP.eucJP/BIPv500.cat -> /opt/mqsi/messages/Ja_JP/BIPv500.cat
You might find that not all the directories indicated above exist in /usr/lib/nls/msg/; create links in those directories that do exist. Do not create directories just to add the link shown.
If there are no directories for your chosen language in /usr/lib/nls/msg/, there is an operating system locale problem, and you must reinstall the locale.
Create symbolic links between the system locale directories and the product directories. For example, for Japanese:
/usr/lib/locale/ja/LC_MESSAGES/BIPv500.cat -> /opt/mqsi/messages/Ja_JP/BIPv500.cat /usr/lib/locale/ja_JP.PCK/LC_MESSAGES/BIPv500.cat -> /opt/mqsi/messages/Ja_JP/BIPv500.cat
If there are no directories for your chosen language in /usr/lib/locale/, there is an operating system locale problem, and you must reinstall the locale.
Related reference
Supported operating environments
Supported code sets
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
ae19494_ |