mqsimode コマンドは、動作モード情報を構成および取得するために使用します。
mqsimode コマンドは、ブローカーの動作モードを変更するか、またはブローカーが現在動作しているモードに関する情報を取得するために使用します。
>>-mqsimode--| brokerSpec |--+---------------------+------------> '- -o --operationMode-' >--+-------------------+--+---------------------+---------------> '- -w --timeoutSecs-' '- -v --traceFileName-' >--+----------------------+------------------------------------>< '- -x --modeExtensions-' brokerSpec |--+- brokerName ----------------+------------------------------| +- -n --brokerFileName--------+ | .-------------------------. | | V | | '-----+- -i --ipAddress-+---+-' +- -p --port------+ '- -q --qMgr------'
このオプションは、複数のユーザーが同じブローカーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。
このファイルを作成するには、WebSphere® Message Broker Explorer 内でブローカーを右クリックし、「*.broker のエクスポート」を選択します。 プロンプトが出た場合は、ファイルを保存する場所にナビゲートし、ファイル名を入力してください。「保管」をクリックする際に、拡張子 .broker が自動的に付加されます。 このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。 このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。
SSL を使用して、セキュア・チャネルを介してリモート・ブローカーを管理するコマンドを実行する場合、IBM_JAVA_OPTIONS 環境変数を使用して、接続用の鍵ストアおよびトラストストアのパスワードを指定する必要があります。 詳細は、コマンド実行時の問題の解決を参照してください。
拡張接続パラメーターが必要ないリモート・ブローカーへの接続の場合は、このオプションを使用します。
このオプションを選択する場合は、以下の 3 つのパラメーターのうち 1 つ以上を指定しなければなりません。指定する順序は意味を持ちません。 それぞれのパラメーターを複数回指定することはできません。
省略したパラメーターは、デフォルト値が想定されます。
Standard Edition のライセンスを購入した場合は、Standard モードまたは scale モードでブローカーを実行する権利が与えられています。
i、p、および q パラメーターを指定して、または接続パラメーター・ファイル (.broker) を使用して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java™ クライアント・コードを使用しようとします。 このオプションは z/OS ではサポートされておらず、以下のエラーが返されます。
BIP1046E: ブローカー (name) と接続できません。
報告される理由コードは MQRC_ENVIRONMENT_ERROR です。 ローカル・キュー・マネージャーを指定する必要があります。
-o パラメーターを指定した mqsimode コマンドの実行
ブローカー BROKER1 に関して mqsimode コマンドを実行し、-o パラメーターを指定すると、モードが更新され、すべてのエラーに関するレポートを受け取ります。 例えば、以下の mqsimode コマンドを実行して、ブローカーを Remote Adapter Deployment モードに変更し、ブローカーが以下の状態にある場合:mqsimode BROKER1 –o アダプター
以下のメッセージを受け取ります。BIP1044: ブローカーのキュー・マネージャーに接続中です...
BIP1045: ブローカーに接続中です...
BIP1805: ブローカー 'Broker_Name1' のモードは 'アダプター' に変更されました。
BIP1823: 警告: ブローカー 'Broker_Name1' には 'Message_Flow' というメッセージ・フローが実行グループ 'Execution_Group' にあり、これにはこのモードで無効な 1 つ以上のノードが含まれています: Node_Type。
BIP8229: : コマンドは完了し、次の数の警告が出されました: 1。
-o パラメーターを指定しない mqsimode コマンドの実行
mqsimode コマンドを、-o パラメーターを指定しないで実行すると、ブローカーによって使用される モード に関するレポート、すべての モード 違反に関するレポート、および要求されているものの設定されていないモード拡張に関するレポートを受け取ります。 例えば、以下の mqsimode コマンドを実行し、ブローカーが以下の状態にある場合:mqsimode Broker_Name
以下のメッセージを受け取ります。BIP1044: ブローカーのキュー・マネージャーに接続中です...
BIP1807: ブローカー 'Broker_Name' からのモード情報を検出中です...
BIP1802: ブローカー 'Broker_Name' は 'Standard' モードです。
BIP8071: コマンドが正常に完了しました。
すべてのモード拡張をオフにする
すべてのモード拡張をオフにするには、mqsimode コマンドを -x パラメーターを指定して実行します。mqsimode Broker_Name –x
ここで、Broker_Name は、ブローカーの名前です。