[AIX、Linux 和 Windows]

AIX, Linux, and Windows 上的错误日志

AIX®, Linux®, and Windows上安装 IBM® MQ 时创建的 errors 子目录最多可以包含三个错误日志文件。

在安装时,将在 AIX and Linux 系统下的 /var/mqm 文件路径和安装目录 (例如 Windows 系统下的 C:\Program Files\IBM\MQ\ 文件路径) 中创建 errors 子目录。 errors 子目录最多可以包含三个错误日志文件,其名称为:
  • AMQERR01.LOG
  • AMQERR02.LOG
  • AMQERR03.LOG

有关存储日志文件的目录的更多信息,请参阅 AIX, Linux和 Windows 上的错误日志目录

创建队列管理器之后,它会在需要时创建三个错误日志文件。 这些文件具有与系统错误日志目录中的错误日志文件相同的名称。 即 AMQERR01、AMQERR02 和 AMQERR03,并且它们的缺省容量都为 32 MB(33554432 字节)。 可以在 IBM MQ Explorer的 " Extended 队列管理器属性" 页面中或在 qm.ini 文件的 QMErrorLog 节中更改容量。 这些文件放置在您安装 IBM MQ 或创建队列管理器时选择的队列管理器数据目录中的 errors 子目录中。 errors 子目录的缺省位置是 AIX and Linux 系统下的 /var/mqm/qmgrs/ qmname 文件路径和 Windows 系统下的 C:\Program Files\IBM\MQ\qmgrs\ qmname \errors 文件路径。

系统会生成错误消息,这些消息放在 AMQERR01 中。 在 AMQERR01 超过 32 MB 时,其会重命名为 AMQERR02。

因此,最新错误消息始终放在 AMQERR01 中,而其他文件用于维护错误消息的历史记录。

除非队列管理器不可用或者其名称未知,否则与通道相关的所有消息也放在属于队列管理器的相应错误文件中。 在任一情况下,与通道相关的消息放在系统错误日志目录中。

要检查任何错误日志文件的内容,请使用常用的系统编辑器。

错误日志示例

图 1 显示了从 IBM MQ 错误日志中抽取的内容:
图 1。 样本 IBM MQ 错误日志
17/11/2014 10:32:29 - Process(2132.1) User(USER_1) Program(runmqchi.exe)
Host(HOST_1) Installation(Installation1)
VRMF(8.0.0.0) QMgr (A.B.C)
AMQ9542: Queue manager is ending.

EXPLANATION:
The program will end because the queue manager is quiescing.
ACTION:
None.
----- amqrimna.c : 931 -------------------------------------------------------

操作员消息

操作员消息识别一般错误,通常由用户在命令上使用无效的参数等类似操作时直接引起。 操作员消息支持本地语言,其中消息目录安装在标准位置。

这些消息写入到关联窗口(如果有)。 此外,某些操作员消息写入到队列管理器目录中的 AMQERR01.LOG 文件,而其他操作员消息写入到系统错误日志目录中的等效文件。

错误日志访问限制

某些错误日志目录和错误日志具有访问限制。
要获取以下访问许可权,用户或应用程序必须是 mqm 组的成员:
  • 对所有队列管理器错误日志目录的读写访问权。
  • 对所有队列管理器错误日志的读写访问权。
  • 对系统错误日志的写访问权。

如果未经授权的用户或应用程序尝试向队列管理器错误日志目录中写入消息,那么该消息重定向到该系统错误日志目录。

[AIX][Linux]

忽略 AIX and Linux 系统下的错误代码

AIX and Linux 系统上,如果您不希望将某些错误消息写入队列管理器错误日志,那么可以使用 QMErrorLog 节指定要忽略的错误代码。

有关更多信息,请参阅 队列管理器错误日志

[Windows]

忽略 Windows 系统下的错误代码

Windows 系统上,会将错误消息写入 IBM MQ 错误日志和 Windows 应用程序事件日志。 写入到应用程序事件日志的错误消息包括错误严重性、警告严重性和信息严重性的消息。 如果您不希望将某些错误消息写入 Windows 应用程序事件日志,那么可以指定要在 Windows 注册表中忽略的错误代码。
使用以下注册表键:
HKLM\Software\IBM\WebSphere MQ\Installation\MQ_INSTALLATION_NAME\IgnoredErrorCodes
其中, MQ_INSTALLATION_NAME 是与 IBM MQ的特定安装相关联的安装名称。

该键设置为的值是以空字符分隔的字符串数组,其中每个字符串值与要从错误日志中忽略的错误代码相关。 完整列表以空字符结尾,其类型为 REG_MULTI_SZ。

例如,如果希望 IBM MQWindows 应用程序事件日志中排除错误代码 AMQ3045, AMQ6055和 AMQ8079 ,请将值设置为:
AMQ3045\0AMQ6055\0AMQ8079\0\0
对于机器上的所有队列消息都将定义要排除的消息的列表。 在重新启动每个队列管理器之前,对配置进行的任何更改都不会生效。