mqsichangetrace 命令

支持的平台

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

用途

使用 mqsichangetrace 命令来设置组件的跟踪特征。该命令适用于:
  • 用户跟踪。指定 -u 选项。
  • 服务跟踪。指定 -t 选项。建议您仅在 BIPxxxx 消息中描述的操作或 IBM 支持中心指导您这样做时才使用此选项。

可以启动、修改或终止代理的用户跟踪,或启动、修改或终止代理、配置管理器用户名称服务器(由组件名标识)的服务跟踪。不能使用该命令启动工作台的服务跟踪。

Windows、Linux 和 UNIX 系统上,您还可以使用 工作台 的设施,启动和停止执行组和 消息流 的跟踪活动。 请参阅用户跟踪以获取更多信息。

在 z/OS 上, 也可以使用控制台命令或使用工作台工具启动、修改和停止跟踪。

如果指定代理或它的任何资源(执行组或消息流),必须在启动跟踪前部署它们。

由这些命令生成的跟踪输出写入 log 子目录中的跟踪文件里。完成了要跟踪的工作后,使用 mqsireadlog来检索作为 XML 格式文件的日志。使用 mqsiformatlog (产生格式化的文件)或使用 XML 浏览器来查看 XML 记录。

将跟踪设置为打开后,对于您所跟踪的组件中的每个活动都会进行额外的处理。您一定会看到跟踪活动时会对性能产生一些影响。

如果您要跟踪命令处理的本身,则在启动跟踪前必须设置环境变量 MQSI_UTILITY_TRACEMQSI_UTILITY_TRACESIZE

确保在完成跟踪所选的命令后您复位了这些变量。如果没有这样做,则还会跟踪所有的后继命令,并且会降低其性能。

语法

Windows 平台、Linux 和 UNIX 系统

用户跟踪

服务跟踪

z/OS

用户跟踪

服务跟踪

参数

component
(必需的 - Windows、Linux 和 UNIX 系统)要跟踪其参数的组件的名称。它既可以是代理的名称,也可以是配置管理器的名称,或是固定值 UserNameServer(在 UNIX 系统和 Linux 上均区分大小写)。

更新开始关键字 工作台utility 均保留,不得用作组件名称。更新结束

-u
更新开始(仅当组件为代理时对用户跟踪必需)指定将要修改用户跟踪选项。该选项只在您有以下行为时有效:
  • Windows、Linux 和 UNIX 系统上指定代理名为组件名。
  • 在 z/OS 上针对代理发出该命令(即,不是针对配置管理器用户名称服务器)。
.更新结束
-e egName
更新开始(对用户跟踪必需;对服务跟踪可选)标识将要修改跟踪选项的执行组(例如,已启动或已停止)。此选项只对代理有效。

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

更新结束
-f messageflow
(可选)标识要修改的跟踪选项消息流。此选项只有在指定了执行组(标志 -e)后才有效。

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

-r
(可选)此选项请求复位跟踪日志:即,废弃所有当前记录。可以在启动新的跟踪时使用该选项,以 确保日志中的所有记录对于新的跟踪来说都是唯一的。

此选项只有在指定了执行组(标志 -e)后才有效。

-l level
(可选)设置跟踪的级别。它必须是以下某个选项:
  • normal。提供了基本级别的跟踪信息。
  • none。关闭跟踪。
  • debug。提供更复杂的跟踪。

每个组件都是使用缺省值 none 创建的。如果不指定该参数,当前值保持不变。一旦成功更改了该值,它就是持久的。

它适用于所有组件。

-m mode
(可选)表明跟踪信息的缓冲方式:
  • safe。这种方式使跟踪条目在生成时写入文件。
  • fast。这种方式使跟踪条目被缓冲,并且只以批处理形式写入文件。

每个组件都是用缺省值 safe 启动的。如果不指定该参数,当前值保持不变。

该选项只在您已指定以下组件时有效:
  • 代理。如果更改该值,它将影响执行组(如已指定)的跟踪,或影响代理组件(如果未指定执行组)的跟踪。
  • 用户名称服务器。如果更改该值,它将影响整个组件的跟踪。(这只适用于服务跟踪)。一旦成功更改了该值,它就是持久的。
-c size
(可选)以 KB(千字节)为单位的跟踪文件的大小。如果不指定该个参数,当前值保持不变。每个组件都是用缺省值 4096 KB 启动的。指定此选项以复位该值。 可以指定的最大值取决于随后要如何使用 mqsireadlog 命令读取日志。

HP-UX 上,建议您将该值设置成小于 500 MB。

  • 如果您使用 mqsireadlog ,并且设置了 -f 选项,则直接从文件系统读取该日志文件。这种情况下, 可以在此指定的最大值是 2097151,这样就允许创建达 2 GB(吉字节)的跟踪文件。
  • 如果您使用 mqsireadlog,并且未设置 -f 选项,则 WebSphere MQ 消息就被发送到代理来检索日志。在这种情况下,跟踪文件的大小不应该超出约 70 MB(兆字节)。在此可设置的最大值不应略微超过 70000。

但您要检索跟踪文件的话,建议您使它的大小尽可能小,可以通过为此参数使用较低的值,或在此命令中使用复位(-r)选项来清除跟踪日志。采用这种方法的好处是,格式化进程(mqsiformatlog)会更快,且执行任务所需的资源也更少。

该选项只在您已指定以下组件时有效:
  • 代理。如果更改该值,它将影响执行组(如已指定)的跟踪,或影响代理组件(如果未指定执行组)的跟踪。
  • 用户名称服务器。如果更改该值,它将影响整个组件的跟踪。(这只适用于服务跟踪)。

如果更改跟踪大小,新值在重新启动代理或用户名称服务器时持久保持。

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

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

-t
更新开始(必需)指定将要修改服务跟踪选项。更新结束
-b
更新开始(必需)指定将要修改指定组件的 agent 子组件的服务跟踪选项(例如,已启动或已停止)。 只有在指定了 -t 的情况下才能指定此标志。更新结束

权限

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

响应

该命令返回下列响应:
  • BIP2595 强制转换字符串‘...’到整数错误(仅 z/OS)
  • BIP8002 所选的标志不兼容(仅 z/OS)
  • BIP8003 检测到重复标志(仅 z/OS)
  • BIP8013 组件不存在
  • BIP8020 无法访问数据库
  • BIP8029 代理未配置
  • BIP8031 提供的标志无效
  • BIP8032 无法连接到队列
  • BIP8033 消息发送失败
  • BIP8035 超时之前没有接收到响应
  • BIP8036 收到否定响应
  • BIP8037 标志不受支持
  • BIP8039 执行组不可用
  • BIP8040 无法连接到数据库
  • BIP8045 找不到消息流
  • BIP8068 缺少整数参数
  • BIP8158 命令格式无效(仅 z/OS)
  • BIP8159 未知参数“...”(仅 z/OS)

示例

Windows 平台、Linux 和 UNIX 系统上:

要收集和处理缺省执行组的用户跟踪,请使用以下命令:
mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
要收集和处理缺省执行组中流 f1 的服务跟踪,请使用以下命令:
mqsichangetrace WBRK_BROKER -u -e default -m fast
要收集和处理用于代理的服务跟踪,请使用以下命令:
mqsichangetrace WBRK_BROKER -t -b -m -l normal

在 z/OS 平台上:

要收集和处理缺省执行组的用户跟踪,请使用以下命令:
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000
并且在 PDSE 成员 BIPJLOG 中,将 mqsireadlog 的选项设置为
-u -e default
要收集和处理缺省执行组中流 f1 的服务跟踪,请使用以下命令:
F MQP1BRK,ct u=yes,e='default',f='f1',m=fast
并且在 PDSE 成员 BIPJLOG 中,将 mqsireadlog 的选项设置为
-t -e default -f f1-
要收集和处理用于代理的服务跟踪,请使用以下命令:
F MQP1BRK,ct t=yes,b=yes,m=fast,l=debug
并且在 PDSE 成员 BIPJLOG 中,将 mqsireadlog 的选项设置为
-t -b agent
相关任务
使用跟踪
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an07260_