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 支持中心提出问题之外，在大多数情况下，系统管理员只很少的工作可以做。