mqsimode コマンドは、動作モード情報を構成および取得するために使用します。
z/OS®.
BIPMODE をカスタマイズして実行依頼することにより、このコマンドを実行します。ブローカー PDSE の内容を参照してください。
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 つ以上を指定しなければなりません。指定する順序は意味を持ちません。それぞれのパラメーターを複数回指定することはできません。
省略したパラメーターは、デフォルト値が想定されます。
サポートされるすべてのプラットフォームで、管理セキュリティーが使用可能に設定されたブローカーのセキュリティー・キュー SYSTEM.BROKER.AUTH に対する読み取り権限を、このコマンドを実行してモードを照会するユーザー ID に認可する必要があります。
サポートされるすべてのプラットフォームで、セキュリティー・キュー SYSTEM.BROKER.AUTH に対する読み取り権限と書き込み権限の両方を、このコマンドを実行してモードを変更するユーザー ID に認可する必要があります。
-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 パラメーターを指定して実行します。 この機能は、WebSphere Message Broker バージョン 7.0.0.2 では使用できません。mqsimode Broker_Name –x
ここで、Broker_Name は、ブローカーの名前です。V6.1 より前のバージョンを実行するブローカーに対する、-o パラメーターを指定した mqsimode コマンドの実行
V6.1 より前のバージョンを実行するブローカーに対して -o パラメーターを実行すると、適切なメッセージがあるレポートを受け取ります。 例えば、Broker_Name がご使用のブローカーの名前である場合、以下のようになります。BIP1044: ブローカーのキュー・マネージャーに接続中です...
BIP1045: ブローカーに接続中です...
BIP1808: ブローカー 'Broker_Name' は、動作モードの変更に必要なソフトウェア・レベルにありません。
BIP8229: : コマンドは完了し、次の数の警告が出されました: 1。