mqsichangeflowmonitoring コマンド - z/OS

メッセージ・フローのモニターを使用可能にするには、z/OS® で mqsichangeflowmonitoring コマンドを使用します。

構文

z/OS コンソール・コマンド

同義語: cm

構文図を読む構文図をスキップする
>>-+-changeflowmonitoring-+---- BrokerName --------------------->
   '-cm-------------------'                    

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

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

>--+-------------------+--+---------------+--------------------><
   '-k=ApplicationName-'  '-y=LibraryName-'   

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

パラメーター

BrokerName
(必須) モニター対象とするメッセージ・フローのデプロイ先ブローカーのラベルを指定します。

このパラメーターは、コマンドのコンソール・フォームでは暗黙指定されます。

c=Control
(オプション) 指定されたメッセージ・フローのモニターを制御するストリング値を指定します。 指定できる値は以下のとおりです。
  • active - モニターを活動化します。
  • inactive - モニターを非活動化します。
e=ExecutionGroupName
(必須) モニター対象とするメッセージ・フローのデプロイ先の実行グループの名前を指定します。

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

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 パラメーターを設定してください。

例

すべての実行グループ内のすべてのメッセージ・フローのモニターをアクティブにするには、以下のようにします。
F MI10BRK,cm c=active,g=yes,j=yes 
実行グループ default のアプリケーション application1 にあるすべてのメッセージ・フローのモニターをアクティブにするには、以下のようにします。
F MB8BROKER,cm e=default,k=application1,j=yes 
実行グループ default のアプリケーション application1 によって参照されるライブラリー library1 のメッセージ・フロー myflow1 のモニターをアクティブにするには、以下のようにします。
F MB8BROKER,cm e=default,y=library1,k=application1,f=myflow1
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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