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

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

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

メッセージ・フローのモニターを使用可能にするには、WindowsLinux および UNIX システムで mqsichangeflowmonitoring コマンドを使用します。

構文

構文図を読む構文図をスキップする
>>-mqsichangeflowmonitoring---- BrokerName --------------------->

>--+-+---------------+--+-----------------------------+-+------->
   | '- -c --Control-'  '- -m --MonitoringProfileName-' |   
   |                         .-,------------------.     |   
   |                         V                    |     |   
   '- -i --EventState-- -s ----EventSourceAddress-+-----'   

                                                       (1)   
>--+- -e --ExecutionGroupName--+- -f --MessageFlow-+-+---------->
   |                           '- -j --------------' |       
   '- -g -- -j --------------------------------------'       

>--+-----------------------+--+-------------------+------------><
   '- -k --applicationName-'  '- -y --libraryName-'   

注:
  1. efg、および j パラメーターの有効な組み合わせについては、パラメーターの説明を参照してください。

パラメーター

BrokerName
(必須) モニター対象とするメッセージ・フローのデプロイ先ブローカーのラベルを指定します。
-c Control
(オプション) 指定されたメッセージ・フローのモニターを制御するストリング値を指定します。 指定できる値は以下のとおりです。
  • active - モニターを活動化します。
  • inactive - モニターを非活動化します。
-f MessageFlow
(必須) モニター・オプションが活動化されるかまたは更新されるメッセージ・フローのラベルを指定します。

-f または -j のいずれかを指定する必要があります。 これらの引数のどちらも指定しない場合、エラー・メッセージを受け取ります。

-g
(必須) ブローカーに属するすべての 実行グループに対してコマンドを適用することを指定します。

-e または -g のいずれかを指定する必要があります。 これらの引数のどちらも指定しない場合、エラー・メッセージを受け取ります。

-i EventState
(オプション) 指定されたイベント・ソースのモニターを制御するストリング値を指定します。 -e および -f パラメーターと併用された場合にのみ有効です。 指定できる値は以下のとおりです。
  • enable - 指定されたイベント・ソースのモニターを使用可能にします。
  • disable - 指定されたイベント・ソースのモニターを使用不可にします。
-j
(必須) 実行グループに属するすべての メッセージ・フローに対してコマンドを適用することを指定します。

-f または -j のいずれかを指定する必要があります。 これらの引数のどちらも指定しない場合、エラー・メッセージを受け取ります。

注: すべての実行グループに対して -g オプションを設定する場合、-f ではなく -j を使用しなければなりません。
-k applicationName
(オプション) このパラメーターは、モニター対象のメッセージ・フローが含まれるアプリケーションの名前を指定します。

このパラメーターを設定する場合、-f (メッセージ・フロー) パラメーター、または -j (すべてのメッセージ・フロー) パラメーターのいずれかも設定しなければなりません。 特定のアプリケーションにあるメッセージ・フローを指定してモニタリングを有効にするには、-k-f パラメーターを設定します。 アプリケーションにあるすべてのメッセージ・フローのモニタリングを有効にする場合、-k-j パラメーターを設定してください。

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

-m MonitoringProfileName
(オプション) 指定されたメッセージ・フローが使用する必要のあるモニター・プロファイルの名前を指定します。

指定されたブローカー上に指定された名前のモニター・プロファイルがない場合、 コマンドは正常に完了して、メッセージ・フローは指定されたモニター・プロファイルの使用を試行します。 各メッセージ・フローは警告をユーザー・トレース内のログに記録して、 それが存在しないモニター・プロファイルを使用するように指示されたことを示します。 イベント・メッセージは作成されません。 指定された名前のモニター・プロファイルが後からブローカーにデプロイされる場合、 メッセージ・フローはその使用を即時に開始しません。 モニター状態の最新表示は、モニターを活動化または再活動化するために、コマンドに -c オプションを指定して再発行することによってトリガーできます。

-s EventSourceAddress
(オプション) 使用可能または使用不可にするイベント・ソースのコンマ区切りリスト。 -e および -f パラメーターと併用された場合にのみ有効です。 この値は <node name>.<event source> の形式を取り、<event source> は以下の値のいずれかです。
  • 'terminal.<terminal name>'
  • 'transaction.Start'
  • 'transaction.End'
  • 'transaction.Rollback'

メッセージ・フローには同じ名前の 2 つ以上のノードがある場合、それらのノードのイベント・ソースは正確にアドレス指定できません。 これを試行した場合の動作は未定義です。

<node name> は、ブローカー・ランタイム・コンポーネントに既知のノードのラベルです。 ノードがサブフロー内にある場合、ラベルはそれを反映します。 例えば、フロー A に、「myB」というラベルの付いたサブフローとしてフロー B のインスタンスが含まれているとします。 フロー B には、「myCompute」というラベルの付いた Compute ノードのインスタンスが含まれているとします。 Compute ノードの <node name> は、'myB.myCompute' となります。

個々のイベント・ソースを使用可能または使用不可にするためにコンマ区切りのリストを指定してこのコマンドを実行しても、-c パラメーターを使ってコマンドをまだ発行していない場合、それらのイベント・ソースに関するモニターは活動化されません。 モニターを有効にするには、-c パラメーターを active に設定して、コマンドを再発行します。

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

このパラメーターを設定する場合、-f (メッセージ・フロー) パラメーター、または -j (すべてのメッセージ・フロー) パラメーターのいずれかも設定しなければなりません。 特定のライブラリーにあるメッセージ・フローを指定してモニタリングを有効にするには、-k-f パラメーターを設定します。 ライブラリーにあるすべてのメッセージ・フローのモニタリングを有効にする場合、-k-j パラメーターを設定してください。

monitoringProfile1 を、実行グループ default 内の messageFlow1 に割り当てます。
mqsichangeflowmonitoring WBRK_BROKER -e default 
     -f messageFlow1 -m monitoringProfile1
すべての実行グループ内のすべてのメッセージ・フローでのモニターをアクティブにします。
mqsichangeflowmonitoring WBRK_BROKER -c active -g -j
実行グループ default のアプリケーション application1 にあるすべてのメッセージ・フローのモニターをアクティブにするには、以下のようにします。
mqsichangeflowmonitoring MB8BROKER -c active -e default -k application1 -j 
実行グループ default のアプリケーション application1 によって参照されるライブラリー library1 のメッセージ・フロー myflow1 のモニターをアクティブにするには、以下のようにします。
mqsichangeflowmonitoring MB8BROKER -c active -e default -y library1 -k application1 -f myflow1
個々のイベント・ソースを使用可能にします。
mqsichangeflowmonitoring WBRK_BROKER 
     -e default 
     -f myMessageFlow 
     -s "SOAP Input1.terminal.out,MQOutput1.terminal.in" 
     -i enable
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:45:57


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