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

メッセージ・フローのモニターを使用可能にするには、Windows、Linux および 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. e、f、g、および 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' となります。
-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 -e default -k application1 -j 
実行グループ default のアプリケーション application1 によって参照されるライブラリー library1 のメッセージ・フロー myflow1 のモニターをアクティブにするには、以下のようにします。
mqsichangeflowmonitoring MB8BROKER -e default -y library1 -k application1 -f myflow1
個々のイベント・ソースを使用可能にします。
mqsichangeflowmonitoring WBRK_BROKER 
     -e default 
     -f myMessageFlow 
     -s "SOAP Input1.terminal.out,MQOutput1.terminal.in" 
     -i enabled
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        最終更新
        
        最終更新 : 2013-02-27 19:18:28


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