mqsichangetrace コマンド

mqsichangetrace コマンドを使用すれば、コンポーネントのトレース特性を設定することができます。

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

  • Windows®
  • Linux® および UNIX® システム
  • z/OS® (コンソール・コマンドとして)

目的

このコマンドは以下に対して有効です。
  • ユーザー・トレース。-u オプションを指定します。
  • サービス・トレース。-t オプションを指定します。このオプションは、BIPxxxx メッセージにあるアクションによって指示された場合、または IBM サポート・センターから指示された場合にのみ使用してください。

行えるのは、ブローカーのエンド・ユーザー・トレースの開始、変更、または終了と、ブローカー、構成マネージャー、またはユーザー・ネーム・サーバー (コンポーネント名によって識別される) のサービス・トレースの開始、変更、または終了です。 このコマンドを使用してワークベンチのサービス・トレースを開始することはできません。

ブローカーを指定する場合や、そのリソース (実行グループまたはメッセージ・フロー) を指定する場合、トレースを開始する前にそれらをデプロイしておかなければなりません。

このコマンドによって生成されるサービスおよびユーザー・トレースの出力は、log サブディレクトリーのトレース・ファイルに書き込まれます。トレースする作業が完了したら、mqsireadlog を使用して、ログを XML 形式のファイルとして取り出します。mqsiformatlog(定様式ファイルを生成する) か XML ブラウザーを使用して、XML レコードを表示します。

トレースをオンに設定すると、トレースするコンポーネントの全アクティビティーに対して、追加の実行処理が行われることになります。そのため、トレースをアクティブにすると、パフォーマンスは影響を受けると見なさなければなりません。

コマンド処理そのものをトレースしたい場合、トレースを開始する前に、 環境変数 MQSI_UTILITY_TRACE および MQSI_UTILITY_TRACESIZE を設定します。

選択したコマンドのトレースが完了したら、必ずこれらの変数をリセットしてください。リセットしない場合、後続のコマンドもすべてトレースされるので、パフォーマンスが低下します。

また、実行グループおよび メッセージ・フロー のトレース・アクティビティーは、ワークベンチ の機能を使用して開始または停止することもできます。 詳しくは、ユーザー・トレースを参照してください。

このコマンドの詳細については、社内のプラットフォームに適したリンクを選択してください。

許可

WindowsLinux、および UNIX システムでは、このコマンドを実行するのに使用するユーザー ID は、mqbrkrs グループのメンバーでなければなりません。

関連タスク
トレースの使用
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. All Rights Reserved.
最終更新 : 2009-02-13 10:23:29

an07260_