WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

mqsichangetrace コマンド

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

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

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

目的

このコマンドは以下に対して有効です。
  • ユーザー・トレース。 -u オプションを指定します。
  • サービス・トレース。 -t オプションを指定します。 このオプションは、BIPxxxx メッセージにあるアクションによって指示された場合、または IBM® サポートから指示された場合にのみ使用してください。
  • Trace ノード。 Trace ノードのオンまたはオフを切り替えるには、-n オプションを指定します。 Trace ノードをオフに切り替えると、フローのパフォーマンスを大幅に向上させることができます。

行えるのは、ブローカーのエンド・ユーザー・トレース (またはサービス・トレース) の開始、変更、または終了です。

ブローカーの Trace ノードはオンとオフで切り替えることができますが、このコマンドを使用してWebSphere® Message Broker Toolkit のサービス・トレースを開始することはできません。

ブローカーを指定する場合や、そのリソース (実行グループまたはメッセージ・フロー) を指定する場合、トレースを開始する前にそれらをデプロイしておかなければなりません。 mqsichangetrace コマンドを使用してユーザー・トレースを開始または停止する場合は、ブローカーが実行中であることを確認する必要があります。 しかし、サービス・トレースの場合、ブローカーがシャットダウン状態でも、mqsichangetrace コマンドを使用して、トレースを使用可能または使用不可に設定できます。 これにより、ブローカー・コンポーネントの開始をトレースすることができます。

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

トレースをオンに設定すると、トレースするブローカーの全アクティビティーに対して、追加の実行処理が行われることになります。 トレースがアクティブであるときは、パフォーマンスが影響を受けることを想定しておく必要があります。

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

標準トレースが必要かデバッグ・トレースが必要かに応じて、MQSI_UTILITY_TRACEnormal または debug に設定できます。MQSI_UTILITY_TRACESIZE を、必要なトレース・ファイルの最大サイズにキロバイト (KB) 単位で設定する必要があります。デフォルトは 102400 (100MB) です。

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

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

現在有効なトレース・オプションを表示する場合は、mqsireporttrace コマンドを使用します。

CMP アプリケーションのサービス・トレースを使用可能にするには、以下のステップのいずれかを実行します。
  • メソッド BrokerProxy.enableAdministrationAPITracing(String filename) を呼び出します。
  • CMP アプリケーションを実行する前に、環境変数 MQSI_CMP_TRACE を、トレースの送信先となるファイル名に設定します。
このコマンドの詳細については、社内のプラットフォームに適したリンクを選択してください。

許可

プラットフォーム固有の許可について詳しくは、以下のトピックを参照してください。 ブローカー管理セキュリティーを有効に設定した場合は、管理セキュリティーのタスクと権限で説明されている権限もセットアップする必要があります。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:47:39


参照トピック参照トピック | バージョン 8.0.0.5 | an07260_