mqsireporttrace 命令

支持的平台

  • Windows
  • Linux 和 UNIX 系统
  • z/OS

用途

使用 mqsireporttrace 命令显示当前生效的跟踪选项。该命令适用于:
  • 用户跟踪。指定 -u 选项。

    在 z/OS 上,用户跟踪是针对代理的特定执行组而运行的。您可以减少命令以进一步跟踪特定的消息流。

  • 服务跟踪。指定 -t 选项。仅当 BIPxxxx 消息中描述的操作或 IBM 支持中心指导您这么做时才使用此选项。

    在 z/OS 上可以为特定执行组运行服务跟踪(与用户跟踪相似)。与用户跟踪不同,也可针对活动代理(即,代理或用户名称服务器)运行服务跟踪。

如果指定代理或它的任何资源(执行组或消息流),必须在查询跟踪设置之前已部署了它们。

语法

Windows 平台、Linux 和 UNIX 系统

用户跟踪

服务跟踪

z/OS

用户跟踪

服务跟踪

参数

component
(必需 - Windows 平台、Linux 和 UNIX 系统)报告其选项的代理名或固定值 UserNameServer。 在 Linux 和 UNIX 系统上,这两个值都区分大小写。
-u
(用户跟踪所必需)从用户跟踪中派生出报告信息。
-e egroup
(对用户跟踪是必需的,对其他是可选的)需要其报告的执行组的标签。只有在已指定代理为组件时这才是有效的。

该名称在 z/OS 上区分大小写。如果名称包含大小写混合的字符,则使用单引号括起。

-f mflow
(可选)需要其报告的 消息流 的标签。只有在将代理指定为组件和执行组时它才有效。

该名称在 z/OS 上区分大小写。如果名称包含大小写混合的字符,则使用单引号括起。

专用于服务跟踪的其他参数

只有 IBM 支持中心或 BIPxxxx 消息指导您这样做时才使用这些选项。

-t
(服务跟踪所必需)从服务跟踪中派生出报告信息。
-b
(在所有平台上可用 -e 替代)请求 agent 函数的报告。

权限

用于发出此命令的用户标识必须有 mqbrkrs 权限。

响应

  • BIP8002 所选的标志不兼容(仅 z/OS)
  • BIP8003 检测到重复标志(仅 z/OS)
  • BIP8013 组件不存在
  • BIP8020 无法访问数据库
  • BIP8029 代理未配置
  • BIP8032 无法连接到队列(仅 Windows 平台、Linux 和 UNIX 系统)
  • BIP8033 无法发送 XML 消息
  • BIP8035 在超时时限内未收到响应
  • BIP8036 收到否定响应
  • BIP8037 所选的标志不受支持
  • BIP8038 命令选项不受支持
  • BIP8039 执行组不可用
  • BIP8040 无法连接到数据库
  • BIP8045 消息流不可用
  • BIP8158 命令格式无效(仅 z/OS)
  • BIP8159 未知参数“...”(仅 z/OS)

示例

Windows 平台、Linux 和 UNIX 系统上:
mqsireporttrace BrokerA -t -e "exgrp1"
在 z/OS 平台上:
F MQP1BRK,reporttrace t=yes,e='exgrp1'
相关任务
使用跟踪
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an07310_