WebSphere MQ入门教程(27)：MQ死信队列、配置、跟踪

8.2死信队列

　　出于某种原因无法发送的消息都被放置在死信队列。您可以通过 MQSC 命令 DISPLAY QUEUE 来检查队列是否包含消息。如果队列包含消息，则使用所提供的浏览样本应用程序（amqsbcg）来浏览队列上的消息。样本应用程序将显示每个消息的消息描述符和消息上下文字段。您应该通过分析消息的死信头来确定消息被放在死信队列的原因。

　　8.3配置文件和问题确定

　　配置文件错误通常找不到队列管理器，和导致队列管理器不可用。确保配置文件存在，并且 WebSphere MQ 配置文件必须和队列管理器和日志目录对应。 在 Windows 注册表中的错误是在启动队列管理器时，通过消息通知的。

　　8.4跟踪

　　本节描述了如何产生WebSphere MQ跟踪信息。

　　8.4.1WebSphere MQ Windows的跟踪

　　在 WebSphere MQ Windows 版中，您可以使用 strmqtrc 控制命令启用或修改跟踪；使用 endmqtrc 控制命令停止跟踪。您还可以使用 WebSphere MQ 服务管理单元启动和停止跟踪。

　　8.4.1.1跟踪的选项

　　使用 -t 和 -x 选项控制跟踪信息量的详细程度。缺省情况下，启用所有跟踪信息。-x 选项指定不需要跟踪的信息。

　　例如，如果您仅跟踪队列管理器 QM1在通信网络上流动的数据，则使用：

　　strmqtrc -m QM1 -x all -t comms

　　8.4.1.2跟踪文件

　　在安装过程期间，您可以选择跟踪文件的存放路径。跟踪文件一般放置在目录 \<mqmwork>\errors 中，其中 <mqmwork> 是WebSphere MQ 数据文件的安装目录。

　　跟踪文件名的格式如下：

　　 AMQppppp.TRC

　　 其中 ppppp 是产生跟踪的进程的进程标识（PID）。

　　 注:

　　 1.进程标识号的数字位数不是固定的。

　　 2.每个被跟踪的进程都有一个跟踪文件。

　　 8.4.1.3跟踪数据的示例

　　 下图显示了WebSphere MQ Windows版的跟踪数据：

　　 Process : C:\Program Files\IBM\WebSphere MQ\bin\amqxssvn.exe

　　 Version : 530 Level : p000-L020213

　　 Date : 02/25/02 Time : 16:35:47

Counter TimeStamp Process.Thread Data

============================================================

0000062F 16:35:47.348386 6278.1 --{ InitProcessInitialisation

00000630 16:35:47.348455 6278.1 ---{ xcsCreateNTSecurityAtts

00000631 16:35:47.348516 6278.1 ----{ xcsRequestThreadMutexSem

00000632 16:35:47.348583 6278.1 ----} xcsRequestThreadMutexSem (rc=OK)

00000633 16:35:47.348639 6278.1 ----{ xcsInitGlobalSecurityData

00000634 16:35:47.349111 6278.1 ----} xcsInitGlobalSecurityData (rc=OK)

00000635 16:35:47.349239 6278.1 ----{ xcsReleaseThreadMutexSem

00000636 16:35:47.349261 6278.1 ----} xcsReleaseThreadMutexSem (rc=OK)

00000637 16:35:47.349275 6278.1 ---} xcsCreateNTSecurityAtts (rc=OK)

00000638 16:35:47.349303 6278.1 ---{ xcsReleaseThreadMutexSem

00000639 16:35:47.349319 6278.1 ---} xcsReleaseThreadMutexSem (rc=OK)

0000063A 16:35:47.349344 6278.1 --} InitProcessInitialisation (rc=OK)

0000063B 16:35:47.349359 6278.1 --{ xcsCreateThreadMutexSem

0000063C 16:35:47.349395 6278.1 --} xcsCreateThreadMutexSem (rc=OK)

0000063D 16:35:47.349872 6278.1 --{ xcsProgramInit

0000063E 16:35:47.349900 6278.1 --} xcsProgramInit (rc=OK)

0000063F 16:35:47.350027 6278.1 --{ xcsInitialize

00000640 16:35:47.350048 6278.1 ---{ xcsRequestThreadMutexSem

00000641 16:35:47.350065 6278.1 ---} xcsRequestThreadMutexSem (rc=OK)

00000642 16:35:47.350079 6278.1 ---{ xihCheckThreadList

00000643 16:35:47.350101 6278.1 ---} xihCheckThreadList (rc=OK)

00000644 16:35:47.350115 6278.1 ---{ InitPrivateServices

00000645 16:35:47.350165 6278.1 attributes 32768

00000646 16:35:47.350204 6278.1 ----{ xcsCreateThreadMutexSem

00000647 16:35:47.350233 6278.1 ----} xcsCreateThreadMutexSem (rc=OK)

00000648 16:35:47.350255 6278.1 pid MQ(6) system(6278)

00000649 16:35:47.350337 6278.1 ---} InitPrivateServices (rc=OK)

0000064A 16:35:47.350360 6278.1 --{ xxxInitialize

0000064B 16:35:47.350977 6278.1 ---{ xcsGetMem

　　 8.4.2WebSphere MQ AIX的跟踪

　　 WebSphere MQ AIX 使用AIX系统标准跟踪。跟踪分为两步：

　　 1.采集数据 。

　　 2.格式化结果数据。

　　 WebSphere MQ 使用两个跟踪 hook 标识：X'30D' 和X'30E' 。

　　 跟踪提供了执行跟踪的详细信息来帮助您分析问题。跟踪产生的文件可能非常大，所以合理地设置跟踪。例如，您可以通过时间和组件来限定跟踪。

　　 有两种运行跟踪的方法：

　　 1.交互地。

　　 以下命令是对程序 myprog 运行了交互式跟踪并结束跟踪。

trace -j30D,30E -o trace.file

->!myprog

->q

　　 2.异步地。

　　 以下命令对程序 myprog运行了异步跟踪和结束跟踪。

trace -a -j30D,30E -o trace.file

myprog

trcstop

　　 您可以用以下命令格式化跟踪文件：

trcrpt -t /usr/mqm/lib/amqtrc.fmt trace.file > report.file

　　 report.file 是存放格式化的跟踪输出的文件名。

　　 注:

　　 当跟踪是活动的，将跟踪所有的WebSphere MQ 活动。

　　 8.4.2.1跟踪选项

　　 可使用环境变量 MQS_TRACE_OPTIONS来分别激活高级详细信息和参数跟踪的功能。下表定义了MQS_TRACE_OPTIONS的各种配置的跟踪行为。

　　 表，MQS_TRACE_OPTIONS 设置

MQS_TRACE_OPTIONS值	跟踪信息
取消设置（缺省值）	缺省跟踪（除高级详细信息之外的所有跟踪）
0	没有WebSphere MQ跟踪
262148	入口，出口和参数跟踪
786436	入口，出口、参数和高级详细信息跟踪
4980740	入口，出口、参数、高级详细信息和SSL跟踪
3407871	不带参数跟踪的缺省跟踪
3670015	缺省跟踪，包含参数跟踪
7864319	缺省跟踪，包含参数跟踪和SSL跟踪
4194303	所有跟踪，包含高级详细信息跟踪

　　 注:

　　 1. 最好需要在技术支持人员的指导下，设置MQS_TRACE_OPTIONS环境变量。

　　 2. 通常在启动队列管理器之前设置MQS_TRACE_OPTIONS。

　　 3. 在跟踪开始前设置 MQS_TRACE_OPTIONS。

　　 8.4.2.2 SSL 跟踪

　　 如果您请求 SSL 跟踪，请注意以下内容：

　　 • SSL 跟踪是写到目录 /var/mqm/trace 的。

　　 • SSL 跟踪文件是 AMQ.SSL.TRC 和 AMQ.SSL.TRC.1。

　　 • 您无法格式化 SSL 跟踪文件；将它们原封不动地发给IBM 技术支持中心。

　　 8.4.2.3跟踪数据的示例

　　 下图显示了WebSphere MQ AIX跟踪的数据：

ID ELAPSED_SEC DELTA_MSEC APPL SYSCALL KERNEL INTERRUPT

30D 0.000000000 0.000000 MQS FNC Entry. 71540.1 zcpSendOnPipe

30E 0.000000038 0.000038 Msg Unencumbered (T/F)(0)

30D 0.000000176 0.000138 MQS FNC Exit............. 51604.55

aqhCheckMsgUnencumbered rc=00000000

30E 0.000000418 0.000242 aqhCheckMsgChains : internal retcode

208007d3

30D 0.000000516 0.000098 MQS FNC Entry.. 71540.14 xcsWaitEventSem

30E 0.000000590 0.000074 MessageSent (24 bytes)

30E 0.000000847 0.000257 aqhCheckMsgChains : internal retcode

208007d3

30E 0.000000936 0.000089 hev=1::0::0-307724 TimeOut(-1)

30E 0.000001173 0.000237 aqhCheckMsgChains : internal retcode

208007d3

30D 0.000001313 0.000140 MQS FNC Entry............ 51604.55

aqtIdxToSpcFn

30D 0.000001395 0.000082 MQS FNC Exit............. 51604.55

aqtIdxToSpcFn rc=00000000

30D 0.000001439 0.000044 MQS FNC Entry........ 36124.51

xcsCheckProcess

30D 0.000001501 0.000062 MQS FNC Entry............ 51604.55

aqhCheckMsgUnencumbered

30E 0.000001645 0.000144 MQS Data from zcpSendOnPipe Length=0018

5A525354 000007E5 00000000 00000000

ZRST 00000000 00000000

30E 0.000001765 0.000120 pBCrsr (0)

30D 0.000001907 0.000142 MQS FNC Entry............. 51604.55

aqhInTrans

30D 0.000001997 0.000090 MQS FNC Exit.............. 51604.55

aqhInTrans rc=00000000

30D 0.000002025 0.000028 MQS FNC Entry.. 71540.1 xcsResetEventSem

30E 0.000002243 0.000218 Msg Unencumbered (T/F)(0)

30D 0.000002363 0.000120 MQS FNC Exit............. 51604.55

aqhCheckMsgUnencumbered rc=00000000

30E 0.000002392 0.000029 hev=1::0::0-305876

30D 0.000002522 0.000130 MQS FNC Entry... 71540.14 xlsLockEvent

30E 0.000002630 0.000108 aqhCheckMsgChains : internal retcode

208007d3