mqsicreateexecutiongroup コマンドを使用して、新規の実行グループをブローカーに追加します。
mqsicreateexecutiongroup コマンドを実行する前に、ブローカーを開始しておく必要があります。
>>-mqsicreateexecutiongroup--| brokerSpec |---------------------> >-- -e -executionGroupName--------------------------------------> >--+--------------------------------------+-------------------->< '- -w -timeoutSecs-- -v -traceFileName-' brokerSpec |--+- brokerName ---------------+-------------------------------| +- -n -brokerFileName--------+ | .------------------------. | | V | | '-----+- -i -ipAddress-+---+-' +- -p -port------+ '- -q -qMgr------'
このオプションは、複数のユーザーが同じブローカーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。
このファイルを作成するには、WebSphere® Message Broker Explorer 内でブローカーを右クリックし、「*.broker ファイルのエクスポート」を選択します。プロンプトが出た場合は、ファイルを保存する場所にナビゲートし、ファイル名を入力してください。「保管」をクリックする際に、拡張子 .broker が自動的に付加されます。このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。
SSL を使用して、セキュア・チャネルを介してリモート・ブローカーを管理するコマンドを実行する場合、IBM_JAVA_OPTIONS 環境変数を使用して、接続用の鍵ストアおよびトラストストアのパスワードを指定する必要があります。詳細は、コマンド実行時の問題の解決を参照してください。
拡張接続パラメーターが必要ないリモート・ブローカーへの接続の場合は、このオプションを使用します。
このオプションを選択する場合は、以下の 3 つのパラメーターのうち 1 つ以上を指定しなければなりません。指定する順序は意味を持ちません。それぞれのパラメーターを複数回指定することはできません。
省略したパラメーターは、デフォルト値が想定されます。
i、p、および q パラメーターを指定して、または接続パラメーター・ファイル (.broker) を使用して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java クライアント・コードを使用しようとします。このオプションは z/OS ではサポートされておらず、以下のエラーが戻されます。
BIP1046E: ブローカー (name) と接続できません。
報告される理由コードは MQRC_ENVIRONMENT_ERROR です。 ローカル・キュー・マネージャーを指定する必要があります。
サポートされるすべてのプラットフォームで、管理セキュリティーを有効にしたブローカーについて、セキュリティー・キュー SYSTEM.BROKER.AUTH に対する読み取りおよび書き込み権限を、このコマンドを実行するユーザー ID に認可する必要があります。
Windows、Linux、および UNIX システム上では、このコマンドを実行するユーザー ID は、mqm グループのメンバーでなければなりません。 mqm 権限でブローカーを実行することを望まない場合には、実行グループを作成する際に、WebSphere MQ 管理者と協力して、適切な権限キューを作成する必要があります。
EG1 という実行グループを、fred.abc.com:1414 で聴取しているキュー・マネージャー QMGR によりホストされているブローカー上で作成します。
mqsicreateexecutiongroup -i fred.abc.com -p 1414 -q QMGR -e EG1
EG2 という実行グループを、ファイル BROKER.broker 内の接続パラメーターにより定義されるブローカー上で作成します。
mqsicreateexecutiongroup -n BROKER.broker -e EG2
EG3 という実行グループを、ファイル FRED.broker 内の接続パラメーターにより定義されるブローカー上で作成します。 ブローカーが応答するのを 5 分間待ち、出力を trace.txt に送信します。
mqsicreateexecutiongroup -n FRED.broker -e EG3 -w 300 -v trace.txt