mqsireadlog 命令

支持的平台

  • Windows
  • Linux 和 UNIX 系统
  • 有关 z/OS 到 BIPRELG 实用程序的信息,请参阅 代理 PDSE 的内容

用途

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

您可以指定将输出内容写至文件或标准输出。该命令返回的跟踪记录采用 XML 格式,可以使用 XML 浏览器进行浏览。如果将输出内容写至文件,则以代码页 utf-8 格式写数据。因此,文件独立于平台, 并且可以传送到其他系统,以供浏览或使用 mqsiformatlog 命令格式化。

HP-UX 上,建议您将 mqsichangetrace 命令的参数 size 设置为小于 500 MB。请注意,XML 生成的文件通常比原始跟踪文件大一半,将 size 参数值设成大于 500 MB 会引起问题。

如果将该文件传送到另一个系统,请确保使用不转换数据的文件传送程序(例如,指定二进制传送选项)。

如果指定代理或它的任何资源(执行组或消息流),则必须先部署它们才能启动跟踪和读取日志文件。

语法

用户跟踪

服务跟踪

参数

component
(必需)要读取其日志的组件名。它也可以是一个代理名配置管理器名称或固定值 、UserNameServer工作台utility(它们在 Linux、UNIX 和 z/OS 系统上都区分大小写)。
-u
(可选)读取用户跟踪日志中的内容。仅当选择代理组件时它才有效。
-e egroup
(可选)要读取其日志信息的执行组的标签。
-o outputfilename
(可选)要写入日志数据的文件的名称。如果指定完整路径名,就在指定的目录中创建此文件。 如果只指定文件名,就在当前工作目录中创建此文件。文件的内容以代码页 utf-8 格式编写,这种格式独立于平台并保护 DBCS 之类的数据。

如果要使用 mqsiformatlog 命令格式化日志,则必须指定文件名。如果不指定文件名,则将日志内容写入标准输出。建议使用文件扩展名 .xml

-f
(对于用户跟踪是可选的,对于服务跟踪是必需的)。直接从文件系统读取日志文件。如果未指定该选项,命令就将 XML 消息发送给组件以请求日志内容。如果指定了 -t(服务跟踪),还必须指定该标志。专用于服务跟踪的其他参数中提供了进一步的详细信息。

如果指定了此选项,请在使用 mqsireadlog 命令前使用 mqsichangetrace 停止跟踪。如果发出指定该标志的 mqsireadlog 命令时日志文件正在使用中, 可能会返回不完整的 XML 记录。可以通过在 mqsichangetrace命令中指定 -m safe 来减少发生这种情况的风险。如果被跟踪的组件本身已停止,则无需发出 mqsichangetrace 命令。

如果发出该命令之前没有停止跟踪,请在使用 mqsiformatlog 之前检查创建的日志文件的内容,并使用文本编辑器从结尾开始除去所有不完整的记录,因为不完整记录不能被格式化命令读取。

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

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

-t
(必需)读取服务跟踪日志中的内容。
-b qualifier
(必需)读取代理 agent配置管理器 agent用户名称服务器 agent 或指定的命令实用程序的日志内容。只有指定了 -t(服务跟踪)此选项才有效。

下表显示用于服务跟踪的有效 qualifiercomponent 组合。

该选项一般用于跟踪命令本身。如果要跟踪特定命令, 请在发出该命令以读取生成的跟踪输出之前,将环境变量 MQSI_UTILITY_TRACE 设置为 debugnormal 来运行该命令。

完全按文中所示输入这些值。

agent 跟踪是在 mqsichangetrace 命令中指定 -b 标志时启动的。 仅在 WebSphere Message Broker 错误消息或 IBM 支持中心的指导下执行该操作。

service 跟踪是在 mqsichangetrace 命令中指定 -b 标志时启动的。 命令格式为:
mqsireadlog <brokername> -t -b service -f -o service.xml
仅在 WebSphere Message Broker 错误消息或 IBM 支持中心的指导下执行该操作。
-f
(必需)直接从文件系统读取日志文件。用于服务跟踪时,该标志的特征与用于用户跟踪时相同。如果指定了 -e 标志,它仍然是可选的。 如果指定了 -b 标志,则必须指定该选项。
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        
注:
  1. 由于该命令没有 component 参数,因此跟踪信息就记录在 utility 组件跟踪文件中并可以从该文件中检索这些信息。有关更多详细信息,请参阅 mqsichangetrace 命令。
  2. 如果在不使用 component 参数的情况下调用该命令,跟踪信息除记录在特定于组件的文件中,还记录在 utility 跟踪文件中并且可以同时从这两种文件中检索。有关更多详细信息,请参阅 mqsichangetrace 命令。

权限

UNIX 平台上,用户标识必须是 mqbrkrs 组的成员。如果指定了 -f 标志, 用于调用该命令的用户标识还必须有权访问跟踪文件。

Windows 平台上,如果指定了 -f 标志,用于调用该命令的用户标识必须有权访问跟踪文件。如果未指定 -f 标志, 用于发出该命令的用户标识必须具有 mqbrkrs 权限。

响应

  • BIP8020 无法访问数据库
  • BIP8029 代理未配置
  • BIP8032 无法连接到队列
  • BIP8033 无法发送 XML 消息
  • BIP8035 在超时时限内未收到响应
  • BIP8036 收到否定响应
  • BIP8037 所选的标志不受支持
  • BIP8038 命令选项不受支持
  • BIP8039 执行组不可用
  • BIP8040 无法连接到数据库
  • BIP8132 限定符无效

示例

代理 WBRK_BROKER 的用户跟踪:

mqsireadlog WBRK_BROKER -u -e default -o trace.xml

组件 ConfigMgr 的服务跟踪:

mqsireadlog ConfigMgr -t -b agent -f -o trace.xml

实用程序程序 mqsiformatlog 的服务跟踪:

mqsireadlog utility -t -b agent -f -o trace.xml

可以使用命令 mqsiformatlog 格式化日志文件(在上述示例中为 trace.xml),或使用 XML 编辑或查看器来查看它。

相关任务
使用日志
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an07300_