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

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

mqsichangetrace コマンド - WindowsLinux、および UNIX システム

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

構文

ユーザー・トレース

構文図を読む構文図をスキップする
>>-mqsichangetrace--brokerName-- -e --egName-- -u -------------->

>--+------------+--+-------------------+------------------------>
   '- -c --size-'  '- -f --messageFlow-'   

>--+----------------------+--+-------------+--+------------+---->
   '- -k -applicationName-'  '- -l --level-'  '- -m --mode-'   

>--+------+--+------------------+------------------------------><
   '- -r -'  '- -y -libraryName-'   

サービス・トレース

構文図を読む構文図をスキップする
>>-mqsichangetrace--brokerName-- -t ---------------------------->

>--+- -b --------------------------------------------+---------->
   '- -e -- egName--+--------------------+--+------+-'   
                    '- -f -- messageFlow-'  '- -r -'     

>--+------------+--+----------------------+--+-------------+---->
   '- -c --size-'  '- -k -applicationName-'  '- -l --level-'   

>--+------------+--+------------------+------------------------><
   '- -m --mode-'  '- -y -libraryName-'   

Trace ノード

構文図を読む構文図をスキップする
>>-mqsichangetrace--brokerName-- -n -switch-- -e --egName------->

>--+-------------------+--+----------------------+-------------->
   '- -f --messageFlow-'  '- -k -applicationName-'   

>--+------------------+----------------------------------------><
   '- -y -libraryName-'   

パラメーター

brokerName
(必須) トレースするブローカーの名前を指定します。 Linux および UNIX システム 上では、すべての名前は大/小文字の区別があります。
-c size

(オプション) トレース・ファイルのサイズ (KB)。 このパラメーターを指定しない場合、現行値は変更されません。

どのブローカーでも、最初はデフォルト値の 102400 KB です。 このオプションを指定すると、デフォルト値はリセットされます。 指定できる最大値は、その後 mqsireadlog コマンドを使用してどのようにログを読み取るかによって異なります。
  • -f オプションを設定してこのコマンドを使用すると、ログ・ファイルはファイル・システムから直接読み取られます。 この場合、指定できる最大値は 2097151 です。これは、最大で 2 GB (ギガバイト) のトレース・ファイルを作成できます。
  • -f オプションを設定しないでこのコマンドを使用すると、ログを取得するために WebSphere® MQ メッセージがブローカーに送信されます。 この場合、トレース・ファイルは 70 MB (メガバイト) を超えることはできません。 設定できる最大値は 70000 です。

HP-UX では、size の値を 500 MB より小さい値に設定してください。

トレース・ファイルを取得したいが、サイズを小さく抑えたい場合は、このパラメーターに低い値を使用するか、またはこのコマンドにリセット (-r) オプションを指定して、トレース・ログをクリアします。 この方法を採用すると、フォーマット・プロセス (mqsiformatlog) が高速になり、タスクを実行するのに必要なリソースが少なくなるという利点があります。

この値を変更すると、実行グループ (指定した場合) またはエージェント・コンポーネント (実行グループを指定しない場合) のトレースに影響があります。

-e egName
(ユーザー・トレースで必須。-b フラグを指定しない場合はサービス・トレースで必須)

トレース・オプション (例えば、開始や停止など) が変更される実行グループを識別します。

-f messageFlow

(オプション) トレース・オプションが変更されるメッセージ・フローを識別します。このオプションは、実行グループ (フラグ -e) を指定した場合にのみ有効です。

-k applicationName
(オプション) このパラメーターは、トレース・オプションを変更するメッセージ・フローが含まれるアプリケーションの名前を指定します。

このパラメーターを設定する場合、-f (メッセージ・フロー) パラメーターも設定しなければなりません。 特定のアプリケーションにある指定のメッセージ・フローのトレース・オプションを変更するには、-k パラメーターと -f パラメーターを設定します。

アプリケーションが参照するライブラリー内に含まれているメッセージ・フローを指定する場合には、このパラメーターと一緒に -y (ライブラリー名) パラメーターを使用できます。

-l level
(オプション) トレースのレベルを設定します。 以下のオプションがサポートされています。
  • normal。 このオプションは基本レベルのトレース情報を提供します。
  • none。 このオプションはトレースをオフに切り替えます。
  • debug。 このオプションは基本レベルより広範囲のトレースを提供します。

各ブローカーは、デフォルト値 none を使用して作成されます。 このパラメーターを指定しない場合、現行値は変更されません。この値を正常に変更した後は、その値が持続します。

-m mode
(オプション) トレース情報がバッファーに入れられる方法を指示します。
  • safe。 このモードでは、トレース・エントリーが生成時にファイルに書き込まれます。
  • fast。 このモードでは、トレース・エントリーはバッファーに入れられ、バッチ中のファイルに書き込まれます。
各ブローカーの初期デフォルト値は safe です。 このパラメーターを指定しない場合、現行値は変更されません。

この値を変更すると、実行グループ (指定した場合) またはエージェント・コンポーネント (実行グループを指定しない場合) のトレースに影響があります。

-r

(オプション) このオプションは、トレース・ログのリセットを要求します。つまり、現行レコードはすべて廃棄されます。新規トレースを開始し、ログ中のすべてのレコードが新規トレースで固有になるようにする場合にこのオプションを使用します。

このオプションは、実行グループ (フラグ -e) を指定した場合にのみ有効です。

-u
(ユーザー・トレースに必須)

ユーザー・トレース・オプションが変更されることを指定します。

-y libraryName
(オプション) このパラメーターは、トレース・オプションを変更するメッセージ・フローが含まれるライブラリーの名前を指定します。

このパラメーターを設定する場合、-f (メッセージ・フロー) パラメーターも設定しなければなりません。 特定のライブラリーにある指定のメッセージ・フローのトレース・オプションを変更するには、-y パラメーターと -f パラメーターを設定します。

サービス・トレース限定の追加パラメーター

以下のオプションは、IBM® サポートまたは BIPxxxx メッセージによって指示された場合にのみ使用してください。

-b

(必須) 指定したブローカーの agent サブコンポーネントのサービス・トレース・オプションが変更される (例えば、開始または停止される) ことを指定します。 このフラグは、-t も指定されている場合にのみ指定できます。

-b フラグまたは -e フラグを指定する必要がありますが、両方を指定することはできません。

-m mode
(オプション) ユーザー・トレースで使用可能な safe および fast モードに加えて、実行グループのサービス・トレースでのみ使用可能な 3 番目のモードとして、temp モードがあります。
  • temp。 このモードは、コンポーネントが再始動するときにトレースが自動的にオフになる点を除いて、safe モードと同じです。 -f が指定されている場合、temp モードを同時に指定することはできません。
-t

(必須) サービス・トレース・オプションが変更されることを指定します。

Trace ノード限定の追加パラメーター

-n switch
(必須) トレース・フローのモードを指定します。 有効な値は、on および off です。

デフォルトの実行グループのユーザー・トレースを収集して処理するには、以下のコマンドを使用します。
mqsichangetrace MB8BROKER -u -e default -l normal -c 5000
デフォルトの実行グループ中のフロー f1 のサービス・トレースを収集して処理するには、以下のコマンドを使用します。
mqsichangetrace MB8BROKER -t -e default -m fast
エージェントのサービス・トレースを収集して処理するには、以下のコマンドを使用します。
mqsichangetrace MB8BROKER -t -b -m -l normal
デフォルトの実行グループ内で Trace ノードをオフに切り替えるには、次のコマンドを使用します。
mqsichangetrace MB8BROKER -n off -e default
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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