mqsiformatlog コマンド

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

  • Windows
  • Linux および UNIX システム
  • BIPFMLG ユーティリティーを介した z/OS。ブローカー PDSE の内容を参照してください。

目的

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

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

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

構文

パラメーター

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

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

許可

このコマンドを呼び出すのに使用するユーザー ID には、入力ファイルに対する読み取りアクセス権限と、出力ファイルに対する書き込みアクセス権限がなければなりません。

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

応答

  • BIP8041 ファイルをオープンできません
  • BIP8042 メモリーが不足しています
  • BIP8043 選択されたファイルが有効なトレース・ファイルではありませんでした
  • BIP8046 XML を初期化できません
  • BIP8047 データを構文解析できません
  • BIP8069 メッセージが見つかりません
  • BIP8079 XML 関数を見つけられませんでした
  • BIP8080 リソースをロードできません
  • BIP8081 コマンドの処理中にエラーが発生しました

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, 2006 最終更新: 08/21/2006
an07270_