使用跟踪工具分析 MQSeries 适配器错误

在运行应用程序时,使用跟踪工具可以分析消息传送故障。 对于 MQSeries 适配器,您必须使用两个工具:一个用于该适配器和 BizTalk 应用程序 (trace.cmd),另一个用于 MQSAgent (MQSTrace.cmd)。 这两种工具都使用 tracelog.exe。 如果尚未安装 tracelog.exe,则必须安装它。

使用 trace.cmd 和 MQSTrace.cmd 时,必须设置一个选项 (-tools) ,以便这些工具可以找到 tracelog.exe 文件。

安装跟踪实用工具

若要安装 BizTalk 适配器跟踪实用工具,请按照以下步骤操作:

  1. 若要下载 Tracelog.exe 文件,请访问 Microsoft 平台 SDK 下载网站

  2. 通过单击网页底部 PSDK-x86.exe文件的链接 启动平台 SDK Web 安装程序。

  3. 出现提示时,选择自定义安装选项。

  4. 在“自定义安装” 对话框中,单击以清除所有可用的功能。

  5. 展开“Microsoft Windows Core SDK” 功能,然后展开“工具” 功能。

  6. 选择“工具 (Intel 64 位)” 功能,然后单击“将安装到本地硬盘”

  7. 先后单击“下一步” 两次 以启动安装。

  8. 找到 drive:\MicrosoftPlatformSDKInstallationFolder\bin 文件夹,然后将 Tracelog.exe 文件复制到 Microsoft BizTalk Server 安装文件夹。 BizTalk Server 安装文件夹还包含 Trace.cmd 文件。

启用跟踪实用工具

若要在 BizTalk Server 中启用 BizTalk 适配器跟踪实用工具,请按照以下步骤操作:

  1. 移动到包含 trace.cmd 的目录。 默认位置为 Microsoft BizTalk Server 目录。

  2. 键入以下命令(该命令将使用引号中的目录来替换您的计算机上包含 tracelog.exe 文件的目录),然后按 Enter:

    trace -tools "c:\Program Files\Microsoft SDK\Bin"

  3. 转至包含 MQSTrace.cmd 的目录。

  4. 键入以下命令(该命令将使用引号中的目录来替换您的计算机上包含 tracelog.exe 文件的目录),然后按 Enter:

    MQSTrace -tools "c:\Program Files\Microsoft SDK\Bin"

运行跟踪实用工具

若要运行 BizTalk 适配器跟踪实用工具,请按照以下步骤操作:

  1. 在命令提示符下,键入 trace.cmd -start -high,然后按 Enter。

  2. 运行您的故障方案。

  3. 在命令提示符下,键入 trace.cmd -stop,然后按 Enter。

  4. bts2006.bin 文件包含了跟踪工具的输出。 请与 Microsoft 产品支持服务联系以进行分析。 有关详细信息,请参阅 https://go.microsoft.com/fwlink/?LinkId=41645

    若要运行 MQSAgent 跟踪实用工具,请按照以下步骤操作:

  5. 在命令提示符下,键入 MQSTrace.cmd -start -high,然后按 Enter。

  6. 运行您的故障方案。

  7. 在命令提示符下,键入 MQSTrace.cmd -stop

  8. MQSAdapterTrace.bin 文件包含了跟踪工具的输出。 请与 Microsoft 产品支持服务联系以进行分析。 有关更多信息,请参见https://go.microsoft.com/fwlink/?LinkId=41645