mqsistopmsgflow コマンドを使用して実行グループ、アプリケーション、およびメッセージ・フローを停止します。
このコマンドを使用するには、指定するメッセージ・フローは、ブローカー・アーカイブ (BAR) ファイルのブローカーにあらかじめデプロイしておく必要があります。
ブローカーは、各メッセージ・フローを停止する前に、それらのすべての未完了メッセージおよび関連するトランザクションを処理します。このような状況で、未解決の作業単位がどのように処理されるかについて詳しくは、 メッセージ・フローのトランザクションを参照してください。
>>-mqsistopmsgflow--| brokerSpec |------------------------------> >--+- -e -executionGroupName-+--+-------------+-----------------> '- -g --------------------' +- -mflowName-+ '- -j --------' >--+--------------------+--+--------------------+---------------> +- -kapplicationName-+ '- -v -traceFileName-' '- -z ---------------' >--+------------------+--+------------------+------------------>< '- -w -timeoutSecs-' '- -y -libraryName-' brokerSpec |--+- brokerName ---------------+-------------------------------| +- -n -brokerFileName--------+ | .------------------------. | | V | | '-----+- -i -ipAddress-+---+-' +- -p -port------+ '- -q -qMgr------'
このオプションは、複数のユーザーが同じブローカーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。
このファイルを作成するには、WebSphere® Message Broker Explorer 内でブローカーを右クリックし、「*.broker ファイルのエクスポート」を選択します。プロンプトが出た場合は、ファイルを保存する場所にナビゲートし、ファイル名を入力してください。「保管」をクリックする際に、拡張子 .broker が自動的に付加されます。このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。
SSL を使用して、セキュア・チャネルを介してリモート・ブローカーを管理するコマンドを実行する場合、IBM_JAVA_OPTIONS 環境変数を使用して、接続用の鍵ストアおよびトラストストアのパスワードを指定する必要があります。詳細は、コマンド実行時の問題の解決を参照してください。
拡張接続パラメーターが必要ないリモート・ブローカーへの接続の場合は、このオプションを使用します。
このオプションを選択する場合は、以下の 3 つのパラメーターのうち 1 つ以上を指定しなければなりません。指定する順序は意味を持ちません。それぞれのパラメーターを複数回指定することはできません。
省略したパラメーターは、デフォルト値が想定されます。
-e を指定し、-m と -j は指定しない場合は、その実行グループが停止します。 各メッセージ・フローの状態 (停止済みまたは開始済み) が保持され、開始済みであったメッセージ・フローは、実行グループが再度開始した時点で開始します。
-e を指定し、-m または -j も指定する場合は、その実行グループが実行中になっている必要があります。 実行グループが停止すると、要求はリジェクトされます。
-g を指定し、-m と -j は指定しない場合は、すべての実行グループが停止します。 実行グループごとに各メッセージ・フローの状態 (停止済みまたは開始済み) が保持され、開始済みの状態であったメッセージ・フローは、実行グループが再度開始した時点で開始します。
-g を指定し、-m または -j も指定する場合は、実行グループが実行中である場合にのみ指定のメッセージ・フロー (複数可) が停止します。 この要求では、すべての実行グループが検査され、現在実行中になっている実行グループでメッセージ・フローが停止します。 実行中でない実行グループについては、それぞれの実行グループでエラー BIP2851 が報告されます。
(オプション) 指定の実行グループのすべてのメッセージ・フローが停止します。実行グループは停止しません。
このパラメーターを設定すると、実行グループ内にあるメッセージ・フローは、実行グループ・レベル、アプリケーション、またはライブラリーのいずれにあるかには関係なく、そのすべてが停止されます。 アプリケーションは停止されません。 -j パラメーターを -z パラメーターと一緒に設定すると、実行グループ内のすべてのアプリケーションが停止され、実行グループ・レベルにあるメッセージ・フローや、実行グループ・レベルでライブラリー内にあるメッセージ・フローが停止されます。 -j パラメーターと -z パラメーターを組み合わせた場合、アプリケーション内にあるメッセージ・フローや、アプリケーション内のライブラリー内にあるメッセージ・フローは停止されません。
-j または -m を指定しない場合は、-e で指定する実行グループ、またはこのブローカーのすべての実行グループが停止します。
–k パラメーターを設定する場合、–e パラメーターも設定しなければなりません。–k パラメーターを設定し –m パラメーターを指定しない場合、アプリケーションが停止されます。アプリケーションが停止すると、その中に含まれているメッセージ・フローは実行されません。 –m パラメーターを設定すると、アプリケーションの指定のメッセージ・フローが停止されます。
–j パラメーターと -k パラメーターを併用すると、指定されたアプリケーション内のすべてのメッセージ・フロー (参照ライブラリー内のメッセージ・フローも含む) が停止されます。他のアプリケーション、または実行グループ・レベルにあるメッセージ・フローは停止されません。アプリケーションは停止されません。
–k パラメーターと –z パラメーターを両方設定することはできません。
単一のコマンドで指定できるのは、1 つのメッセージ・フローだけです。 ブローカー、または -e で指定する実行グループにデプロイされているすべてのメッセージ・フローを停止する場合は、-j を指定します。
–y パラメーターを設定する場合、–e パラメーターも設定しなければなりません。–m パラメーターを設定すると、ライブラリーの指定のメッセージ・フローが停止されます。
–j パラメーターと -y パラメーターを併用すると、指定されたライブラリー内のすべてのメッセージ・フローが停止されます。他のライブラリー、または実行グループ・レベルにあるメッセージ・フローは停止されません。
アプリケーションにある特定のライブラリーのフローすべてを停止するには、–y パラメーターと –k パラメーターを一緒に使用します。–y パラメーターと –k パラメーターを組み合わせて使用すると、指定のアプリケーションの指定のライブラリー内のフローだけが停止されます。 アプリケーション・レベルのフローや、対象のアプリケーション内にある他のライブラリーのフローは停止されません。他のアプリケーションや実行グループ・レベルにあるフローは停止されません。アプリケーションは停止されません。
-j パラメーターを -z パラメーターと一緒に設定すると、実行グループ内のすべてのアプリケーションが停止され、実行グループ・レベルにあるメッセージ・フローや、実行グループ・レベルでライブラリー内にあるメッセージ・フローが停止されます。 -j パラメーターと -z パラメーターを組み合わせた場合、アプリケーション内にあるメッセージ・フローや、アプリケーション内のライブラリー内にあるメッセージ・フローは停止されません。
i、p、および q パラメーターを指定して、または接続パラメーター・ファイル (.broker) を使用して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java クライアント・コードを使用しようとします。このオプションは z/OS ではサポートされておらず、以下のエラーが戻されます。
BIP1046E: ブローカー (name) と接続できません。
報告される理由コードは MQRC_ENVIRONMENT_ERROR です。 ローカル・キュー・マネージャーを指定する必要があります。
| タスク | コマンド形式の例 | 必要な権限 |
|---|---|---|
| ブローカーのすべての実行グループの停止 | mqsistopmsgflow MB8BROKER -g |
|
| ブローカーのすべてのメッセージ・フローの停止 | mqsistopmsgflow MB8BROKER -g -j |
|
| 特定の実行グループの停止 | mqsistopmsgflow MB8BROKER -e EG1 |
|
| 特定の実行グループにデプロイされているすべてのメッセージ・フローの停止 | mqsistopmsgflow MB8BROKER -e EG1 -j |
|
| 特定のメッセージ・フローの停止 | mqsistopmsgflow MB8BROKER -e EG1 -m Flow1 |
|
mqsistopmsgflow MB8BROKER -e eg2
mqsistopmsgflow MB8BROKER -g
デフォルトの実行グループ内にあるアプリケーション myApplication のメッセージ・フロー myFlow1 を停止します。
mqsistopmsgflow MB8BROKER -e default -k myApplication -m myFlow1
デフォルトの実行グループ内にあり、アプリケーション myApplication によって参照されているライブラリー myLibrary のメッセージ・フロー myFlow1 を停止します。
mqsistopmsgflow MB8BROKER -e default -k myApplication -y myLibrary -m myFlow1
すべてのメッセージ・フローを停止し、デフォルトの実行グループ内のすべてのアプリケーションを停止します。
mqsistopmsgflow MB8BROKER -e default -z -j