您可以指定将输出内容写至文件或标准输出。该命令返回的跟踪记录采用 XML 格式,可以使用 XML 浏览器进行浏览。如果将输出内容写至文件,则以代码页 utf-8 格式写数据。因此,文件独立于平台, 并且可以传送到其他系统,以供浏览或使用 mqsiformatlog 命令格式化。
在 HP-UX 上,建议您将 mqsichangetrace 命令的参数 size 设置为小于 500 MB。请注意,XML 生成的文件通常比原始跟踪文件大一半,将 size 参数值设成大于 500 MB 会引起问题。
如果将该文件传送到另一个系统,请确保使用不转换数据的文件传送程序(例如,指定二进制传送选项)。
如果指定代理或它的任何资源(执行组或消息流),则必须先部署它们才能启动跟踪和读取日志文件。
如果要使用 mqsiformatlog 命令格式化日志,则必须指定文件名。如果不指定文件名,则将日志内容写入标准输出。建议使用文件扩展名 .xml。
如果指定了此选项,请在使用 mqsireadlog 命令前使用 mqsichangetrace 停止跟踪。如果发出指定该标志的 mqsireadlog 命令时日志文件正在使用中, 可能会返回不完整的 XML 记录。可以通过在 mqsichangetrace命令中指定 -m safe 来减少发生这种情况的风险。如果被跟踪的组件本身已停止,则无需发出 mqsichangetrace 命令。
如果发出该命令之前没有停止跟踪,请在使用 mqsiformatlog 之前检查创建的日志文件的内容,并使用文本编辑器从结尾开始除去所有不完整的记录,因为不完整记录不能被格式化命令读取。
只有 IBM 支持中心或 BIPxxxx 消息指导您这样做时才使用这些选项。
下表显示用于服务跟踪的有效 qualifier 和 component 组合。
该选项一般用于跟踪命令本身。如果要跟踪特定命令, 请在发出该命令以读取生成的跟踪输出之前,将环境变量 MQSI_UTILITY_TRACE 设置为 debug 或 normal 来运行该命令。
完全按文中所示输入这些值。
agent 跟踪是在 mqsichangetrace 命令中指定 -b 标志时启动的。 仅在 WebSphere Message Broker 错误消息或 IBM 支持中心的指导下执行该操作。
mqsireadlog <brokername> -t -b service -f -o service.xml仅在 WebSphere Message Broker 错误消息或 IBM 支持中心的指导下执行该操作。
Qualifier | Component= <broker_name> | Component= ConfigMgr_name | Component= UserNameServer | Component= 工作台 | Component= utility |
---|---|---|---|---|---|
mqsichangebroker | x | ||||
mqsichangeconfigmgr | x | ||||
mqsichangetrace | x | x | x | ||
mqsichangeusernameserver | x | ||||
mqsiclearmqpubsub | x | ||||
mqsicreateaclentry | x | ||||
mqsicreatebroker | x | ||||
mqsicreateconfigmgr | x | ||||
mqsicreateusernameserver | x | ||||
mqsideleteaclentry | x | ||||
mqsideletebroker | x | ||||
mqsideleteconfigmgr | x | ||||
mqsideleteusernameserver | x | ||||
mqsiformatlog1 | x | ||||
mqsijoinmqpubsub | x | ||||
mqsilist2 | x | x | |||
mqsilist | x | ||||
mqsilistaclentry | x | ||||
mqsireadlog | x | x | x | x | |
mqsireporttrace | x | x | |||
mqsistart | x | x | x | ||
mqsistop | x | x | x | ||
agent | x | x | x | ||
service | x | x | x | ||
工作台 | x | ||||
httplistener | x |
在 UNIX 平台上,用户标识必须是 mqbrkrs 组的成员。如果指定了 -f 标志, 用于调用该命令的用户标识还必须有权访问跟踪文件。
在 Windows 平台上,如果指定了 -f 标志,用于调用该命令的用户标识必须有权访问跟踪文件。如果未指定 -f 标志, 用于发出该命令的用户标识必须具有 mqbrkrs 权限。