mqsichangeresourcestats コマンドを使用して、ブローカーのリソースに関する統計の収集を制御します。
このコマンドを使用して、リソース統計データでリストされているリソース・タイプの統計収集を開始または停止します。
このコマンドを実行できるのは、ブローカーが実行中の場合に限られます。 統計の収集を開始してから、ブローカーをいったん停止して再始動した場合は、このコマンドを再実行する必要はありません。ブローカーの再始動時に、アクティブ状況はそのまま維持されます。
ブローカーのすべての実行グループで統計の収集を開始した場合は、すべての実行グループで収集を停止することも、個々の実行グループで停止することも可能です。 個々の実行グループで統計の収集を開始した場合は、それらの特定の実行グループで収集を停止することも、すべての実行グループで停止することも可能です。
>>-mqsichangeresourcestats--| brokerSpec |-- -c --Control-------> >--+--------------------------+--+-------------------+----------> '- -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 つ以上を指定しなければなりません。指定する順序は意味を持ちません。 それぞれのパラメーターを複数回指定することはできません。
省略したパラメーターは、デフォルト値が想定されます。
-e を指定しない場合は、ブローカーのすべての実行グループのリソース統計収集が開始/停止します。
i、p、および q パラメーターを指定して、または接続パラメーター・ファイル (.broker) を使用して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java™ クライアント・コードを使用しようとします。 このオプションは z/OS ではサポートされておらず、以下のエラーが返されます。
BIP1046E: ブローカー (name) と接続できません。
報告される理由コードは MQRC_ENVIRONMENT_ERROR です。 ローカル・キュー・マネージャーを指定する必要があります。
BrokerA のすべての実行グループでリソース統計の収集を開始します。
mqsichangeresourcestats BrokerA -c active
ブローカー BrokerA の実行グループ default でリソース統計の収集を停止します。
mqsichangeresourcestats BrokerA -c inactive -e default