IBM Support

File name and location of the WebSphere MQ message catalog

Troubleshooting


Problem

WebSphere MQ uses the message catalog to prepare informational, warning or error messages. The default is English language, however you can install other locales so the file will contain the message text in the corresponding language. This document details the file name and the location for the WebSphere MQ message catalog.

Resolving The Problem

On UNIX systems the message catalog is a file named amq.cat.
Note: Starting with MQ 7.1, the message catalogs in Unix are now located in /opt/mqm/msg
For example, if MQ 7.5 is installed in /opt/mqm75, on Linux, the English message catalog is located in:
/opt/mqm75/msg/en_US/amq.cat


On Windows the message catalog is in library amqxms0n.dll.


Note: The location for the message catalogs for MQ 7.0 and prior versions depends on the operating system and installation directory.

AIX
Solaris
HPUX-11
Linux
Windows

AIX

For MQ 7.0 and prior versions:

/usr/lib/nls/msg/prime/amq.cat
/usr/lib/nls/msg/en_US/amq.cat


Solaris

For MQ 7.0 and prior versions:

/usr/lib/locale/C/LC_MESSAGES/amq.cat

Japanese language example:

/usr/lib/locale/ja/LC_MESSAGES/amq.cat
/usr/lib/locale/ja_JP.PCK/LC_MESSAGES/amq.cat
/usr/lib/locale/ja_JP/LC_MESSAGES/amq.cat


HPUX-11

For MQ 7.0 and prior versions:
/usr/lib/nls/msg/C/amq.cat

Japanese language example:

/usr/lib/nls/msg/ja_JP.eucJP/amq.cat
/usr/lib/nls/msg/ja_JP.SJIS/amq.cat


Linux

For MQ 7.0 and prior versions:
/usr/share/locale/C/LC_MESSAGES/amq.cat
/usr/share/locale/en/LC_MESSAGES/amq.cat
/usr/share/locale/en_US/LC_MESSAGES/amq.cat

Note: Do not modify the amq.cat file, because you might experience unpredictable results. MQ could fail to start or not function as expected if the message catalog is modified,.



Windows

On Windows the technique is different than in UNIX and there is not a single message catalog file per translated language. Instead all the messages for the different languages are compiled into a message dll.

This library or dll is used to output messages to both the MQ error logs as well as the Windows event logs.

The full path and file name of the dll is:
C:\Program Files\IBM\WebSphere MQ\bin\amqxms0n.dll

[{"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Data Conversion","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"8.0;7.5;7.1;7.0;6.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WebSphere MQ WMQ

Document Information

Modified date:
15 June 2018

UID

swg21303303