mqsiformatlog コマンド

mqsireadlog によって作成された XML ログを処理するには、mqsiformatlog コマンドを使用します。 このコマンドは、XML ログに収容されている任意のメッセージを取り出して、コマンドを実行するユーザーのロケールに適した形式にフォーマットします。

サポートされるプラットフォーム

  • Windows®
  • Linux® および UNIX® システム
  • z/OS®. このコマンドは、BIPFMLG をカスタマイズして実行依頼することにより実行します。ブローカー PDSE の内容を参照してください。

目的

mqsiformatlog コマンドは、プラットフォームに限定されないコード・ページである utf-8 を使って任意のシステム上で作成された入力ログ・ファイルを解釈します。 このコマンドは、他のシステムからこのコマンドが実行されるシステムに転送されてきた入力ログ・ファイルを基に、フォーマット済み出力を作成する場合に使用します。この機能を使用する場合は必ず、データを変換しないファイル転送プログラム (例えば、2 進転送オプションを指定するもの) を使用してください。

出力先には、ファイルとコマンド・シェルのいずれを指定しても構いません。

構文

パラメーター

-i Inputfilename
(必須) フォーマットする XML ログ・ファイルのファイル名。このファイルは、mqsireadlog コマンドによって作成されたものです。これは、utf-8 でエンコードされています。
-o Outputfilename
(オプション) フォーマット済みのログ出力を書き込むファイルの名前。これを指定しない場合、フォーマット済みのログ・データは STDOUT に書き込まれます。

このコマンドによって書き込まれる (ファイルまたは STDOUT に) 出力は、現在のユーザー・ロケールに適したコード・ページで書き込まれます。

許可

すべてのプラットフォームで、このコマンドを実行するために使用するユーザー ID には、入力ファイルに対する読み取りアクセス権限と、出力ファイルに対する書き込みアクセス権限がなければなりません。

Linux および UNIX システムでは、ユーザー ID は mqbrkrs グループのメンバーでなければなりません。

mqsiformatlog -i trace.xml -o formattrace.log

このコマンドによって生成される出力の抜粋を以下に示します。

Timestamps are formatted in local time, local time is GMT.
.
.
.
2003-02-12 12:57:21.895999 388 UserTrace BIP2638E:
MQPUT to queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' on queue manager
'WBRK_QM': MQCC=0, MQRC=0; node ConfigurationMessageFlow.outputNode'.
The node 'ConfigurationMessageFlow.outputNode' attempted
to write a message to the specified queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
connected to queue manager 'WBRK_QM'.
The MQCC was 0 and the MQRC was 0.
No user action required.

2003-02-12 12:57:21.895999 388 UserTrace BIP2622I:
Message successfully output by output node 'ConfigurationMessageFlow.outputNode'
to queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' on queue manager
'WBRK_QM'. The WebSphere® MQ output node ConfigurationMessageFlow.outputNode'
successfully wrote an output message to the specified queue
SYSTEM.BROKER.EXECUTIONGROUP.REPLY connected to queue manager WBRK_QM.
No user action required.
.
.
.
Threads encountered in this trace: 335 388
関連タスク
ログの使用
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:12

an07270_