可以启动、修改或终止代理的用户跟踪,或启动、修改或终止代理、配置管理器或用户名称服务器(由组件名标识)的服务跟踪。不能使用该命令启动工作台的服务跟踪。
在 Windows、Linux 和 UNIX 系统上,您还可以使用 工作台 的设施,启动和停止执行组和 消息流 的跟踪活动。 请参阅用户跟踪以获取更多信息。
在 z/OS 上, 也可以使用控制台命令或使用工作台工具启动、修改和停止跟踪。
如果指定代理或它的任何资源(执行组或消息流),必须在启动跟踪前部署它们。
由这些命令生成的跟踪输出写入 log 子目录中的跟踪文件里。完成了要跟踪的工作后,使用 mqsireadlog来检索作为 XML 格式文件的日志。使用 mqsiformatlog (产生格式化的文件)或使用 XML 浏览器来查看 XML 记录。
将跟踪设置为打开后,对于您所跟踪的组件中的每个活动都会进行额外的处理。您一定会看到跟踪活动时会对性能产生一些影响。
如果您要跟踪命令处理的本身,则在启动跟踪前必须设置环境变量 MQSI_UTILITY_TRACE 和 MQSI_UTILITY_TRACESIZE。
确保在完成跟踪所选的命令后您复位了这些变量。如果没有这样做,则还会跟踪所有的后继命令,并且会降低其性能。
关键字 工作台 和 utility 均保留,不得用作组件名称。
在 z/OS 上,该名称区分大小写;如果名称中包含大小写混合的字符,应当用单引号括起。
在 z/OS 上,该名称区分大小写;如果名称中包含大小写混合的字符,应当用单引号括起。
此选项只有在指定了执行组(标志 -e)后才有效。
每个组件都是使用缺省值 none 创建的。如果不指定该参数,当前值保持不变。一旦成功更改了该值,它就是持久的。
它适用于所有组件。
每个组件都是用缺省值 safe 启动的。如果不指定该参数,当前值保持不变。
在 HP-UX 上,建议您将该值设置成小于 500 MB。
但您要检索跟踪文件的话,建议您使它的大小尽可能小,可以通过为此参数使用较低的值,或在此命令中使用复位(-r)选项来清除跟踪日志。采用这种方法的好处是,格式化进程(mqsiformatlog)会更快,且执行任务所需的资源也更少。
如果更改跟踪大小,新值在重新启动代理或用户名称服务器时持久保持。
只有 IBM 支持中心或 BIPxxxx 消息指导您这样做时才使用这些选项。
在 Windows 平台、Linux 和 UNIX 系统上:
mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
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
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