mqsireadlog コマンドを使用して、指定したコンポーネントのトレース・レコードを取り出します。
出力の送信先には、ファイルまたは STDOUT のどちらを指定しても構いません。このコマンドによって戻されるトレース・レコードは XML 形式であり、XML ブラウザーを使用してブラウズできます。出力をファイルに送った場合、データはコード・ページ utf-8 で書き込まれます。したがって、このファイルはプラットフォーム独立型で、mqsiformatlog コマンドを使用して他のシステムに転送し、ブラウズしたりフォーマット設定したりすることができます。
HP-UX では、mqsichangetrace コマンドの size パラメーターを 500 MB より小さく設定してください。XML 生成ファイルのサイズは元のトレース・ファイルの 1.5 倍になる場合があるため、size パラメーターの値を 500 MB より大きくすると問題が発生する可能性があるからです。
このファイルを別のシステムに転送する場合は、必ずデータを変換しないファイル転送プログラムを使用してください (たとえば、バイナリー転送オプションを指定するなど)。
ブローカーを指定する場合や、そのリソース (実行グループまたはメッセージ・フロー) を指定する場合、トレースを開始してログ・ファイルを読み取る前に、それらをデプロイしておかなければなりません。
mqsiformatlog コマンドを使用してログをフォーマットする場合、ファイル名を指定する必要があります。 ファイル名を指定しない場合、ログの内容は STDOUT に書き込まれます。 .xml のファイル拡張子を使用することをお勧めします。
このオプションを指定する場合、mqsireadlog コマンドを使用する前にトレースを停止してください (mqsichangetrace コマンドを使用)。 このフラグを指定してコマンドを発行するときにログ・ファイルが使用中の場合、部分的な XML レコードが戻される可能性があります。 mqsichangetrace コマンドで -m safe を指定することによって、このようなことが発生するリスクを低減できます。トレースされているコンポーネントそのものが停止した場合は、mqsichangetrace コマンドを発行する必要はありません。
フォーマット・コマンドは部分レコードを読み取ることができないため、このコマンドを発行する前にトレースを停止しない場合は、作成されたログ・ファイルの内容を確認し、テキスト・エディターを使用して末尾から部分レコードを削除してから、mqsiformatlog コマンドを使用してください。
以下のオプションは、IBM サポート・センターまたは BIPxxxx メッセージによって指示された場合にのみ使用してください。
次の表に、サービス・トレースの qualifier と component の有効な組み合わせを示します。
一般的に、このオプションはコマンド自体をトレースするために使用されます。 特定のコマンドをトレースする場合は、環境変数 MQSI_UTILITY_TRACE を debug または normal に設定してそのコマンドを実行してから、このコマンドを発行して、生成されたトレース出力を読み込みます。
これらの値を示されたとおりに入力します。
agent トレースは、mqsichangetrace コマンドに -b フラグを指定することで開始されます。 これは、WebSphere® Event Broker エラー・メッセージで指示された場合、または IBM サポート・センターから指示された場合にのみ実行してください。
mqsireadlog <brokername> -t -b service -f -o service.xmlこれは、WebSphere Event Broker エラー・メッセージで指示された場合、または IBM サポート・センターから指示された場合にのみ実行してください。
Qualifier | コンポーネント= broker_name | コンポーネント= ConfigMgr_name | コンポーネント= UserNameServer | コンポーネント= ワークベンチ | コンポーネント= utility |
---|---|---|---|---|---|
mqsichangebroker | ○ | ||||
mqsichangeconfigmgr | ○ | ||||
mqsichangetrace | ○ | ○ | ○ | ||
mqsichangeusernameserver | ○ | ||||
mqsiclearmqpubsub | ○ | ||||
mqsicreateaclentry | ○ | ||||
mqsicreatebroker | ○ | ||||
mqsicreateconfigmgr | ○ | ||||
mqsicreateusernameserver | ○ | ||||
mqsideleteaclentry | ○ | ||||
mqsideletebroker | ○ | ||||
mqsideleteconfigmgr | ○ | ||||
mqsideleteusernameserver | ○ | ||||
mqsiformatlog1 | ○ | ||||
mqsijoinmqpubsub | ○ | ||||
mqsilist2 | ○ | ○ | |||
mqsilist | ○ | ||||
mqsilistaclentry | ○ | ||||
mqsireadlog | ○ | ○ | ○ | ○ | |
mqsireporttrace | ○ | ○ | |||
mqsistart | ○ | ○ | ○ | ||
mqsistop | ○ | ○ | ○ | ||
agent | ○ | ○ | ○ | ||
service | ○ | ○ | ○ | ||
ワークベンチ | ○ | ||||
httplistener | ○ |
すべての Windows プラットフォームで、-f フラグを指定する場合、このコマンドを呼び出すために使用されるユーザー ID には、トレース・ファイルへのアクセス権限がなければなりません。 -f フラグが指定されない場合、このコマンドを実行するために使用するユーザー ID は、mqbrkrs グループのメンバーでなければなりません。
Linux および UNIX プラットフォームでは、ユーザー ID は mqbrkrs グループのメンバーでなければなりません。 -f フラグが指定される場合、このコマンドを実行するために使用する ユーザー ID には、トレース・ファイルに対するアクセス権限もなければなりません。
ブローカー 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
ログ・ファイル (上の例では trace.xml) は、コマンド mqsiformatlog を使用してフォーマット設定したり、XML エディターや XML ビューアーを使用して表示することができます。