WebSphere MQ v6 Windows平台故障跟踪

跟踪
如何为 WebSphere MQ 产生跟踪。

跟踪 WebSphere MQ Windows 版
在 WebSphere MQ Windows 版中，您使用strmqtrc 控制命令启用或修改跟踪。要停止跟踪，使用endmqtrc 控制命令。
对于 WebSphere MQ Windows 版，您也可以使用 WebSphere MQ 服务管理单元跟踪图标启动和停止跟踪。
在 WebSphere MQ Windows 版上可选择的组件跟踪
使用 -t 和 -x 选项控制要记录的跟踪数量的详细信息。缺省情况下，启用所有跟踪点。-x 选项使您能指定不要跟踪的点。因此，例如，如果您要跟踪仅是在通信网络上流动的数据，则使用：
strmqtrc -x all -t comms

跟踪文件
在安装过程期间，您可以选择要跟踪文件所在的驱动器。跟踪文件总是放置在目录 /<mqmwork>/errors 中，其中 <mqmwork> 是在安装 WebSphere MQ 时所选的用来保存 WebSphere MQ 数据文件的目录。
跟踪文件名称有以下格式：
AMQppppp.TRC

其中 ppppp 是产生跟踪的进程的进程标识（PID）。
注:
1.进程标识可以比示例包含较少或更多的数字。
2.对每个作为被跟踪的实体的部件运行的进程都有一个跟踪文件。
显示了从 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

在 WebSphere MQ Windows 版中，FFST 信息是记录在 c:/Program Files/IBM/WebSphere MQ/errors 目录下的文件中的。
这些错误通常都是严重的、不可恢复的错误，并且表明系统的配置问题或 WebSphere MQ 内部错误。
FFST 文件命名为 AMQnnnnn.mm.FDC，其中：
nnnnn
是报告错误进程的标识
mm
是顺序号，通常为 0
当进程创建了 FFST 记录时，它还将记录发送到事件日志中。记录包含 FFST 文件的名称来辅助进行自动问题跟踪。事件日志条目是在应用程序级别产生的。
典型的 FFST 日志如下

+-----------------------------------------------------------------------------+
| |
| WebSphere MQ First Failure Symptom Report |
| ========================================= |
| |
| Date/Time :- Tue February 19 12:58:42 GMT Standard Time 2006 |
| Host Name :- NETTLE (NT Version 4.0 Build 1381: Service Pack 6) |
| PIDS :- 5724B4101 |
| LVLS :- 530 |
| Product Long Name :- WebSphere MQ for Windows |
| Vendor :- IBM |
| Probe Id :- XC371019 |
| Application Name :- MQM |
| Component :- xstServerRequest |
| Build Date :- Feb 13 2002 |
| CMVC level :- p000-L020213 |
| Build Type :- IKAP - (Production) |
| UserID :- nigel |
| Process Name :- C:/Program Files/IBM/WebSphere MQ/bin/amqzdmaa.exe |
| Process :- 00001678 |
| Thread :- 00000001 |
| QueueManager :- REGR |
| Major Errorcode :- xecF_E_UNEXPECTED_SYSTEM_RC |
| Minor Errorcode :- OK |
| Probe Type :- MSGAMQ6119 |
| Probe Severity :- 2 |
| Probe Description :- AMQ6119: An internal WebSphere MQ error has occurred |
| (WinNT error 5 from WaitForSingleObject.) |
| FDCSequenceNumber :- 0 |
| Comment1 :- WinNT error 5 from WaitForSingleObject. |
| |
| Comment2 :- Access is denied. |
| |
| |
+-----------------------------------------------------------------------------+

MQM Function Stack
amqzdmaa.main
xcsTerminate
xcsDisconnectSharedSubpool
xcsDettachSharedSubpool
xcsGetSetConnectCount
xstGetExtentConnectCount
xstStorageRequest
xstServerRequest
xcsFFST

MQM Trace History
------} zcpSendOnPipe rc=OK
------{ zcpReceiveOnPipe
-------{ xcsWaitEventSem

...

函数堆栈和跟踪历史是由 IBM 用来辅助进行问题确定的。当生成 FFST 记录时，除通过 IBM 支持中心提出问题之外，在大多数情况下，系统管理员只很少的工作可以做。