mqsichangeresourcestats コマンド

mqsichangeresourcestats コマンドを使用して、ブローカーのリソースに関する統計の収集を制御します。

サポートされるプラットフォーム

  • Windows システム
  • Linux および UNIX システム
  • z/OS®. BIPCHRS をカスタマイズして実行依頼することにより、このコマンドを実行します。ブローカー PDSE の内容を参照してください。

目的

このコマンドを使用して、リソース統計データでリストされているリソース・タイプの統計収集を開始または停止します。

このコマンドを実行できるのは、ブローカーが実行中の場合に限られます。 統計の収集を開始してから、ブローカーをいったん停止して再始動した場合は、このコマンドを再実行する必要はありません。ブローカーの再始動時に、アクティブ状況はそのまま維持されます。

ブローカーのすべての実行グループで統計の収集を開始した場合は、すべての実行グループで収集を停止することも、個々の実行グループで停止することも可能です。 個々の実行グループで統計の収集を開始した場合は、それらの特定の実行グループで収集を停止することも、すべての実行グループで停止することも可能です。

構文

構文図を読む構文図をスキップする
>>-mqsichangeresourcestats--| brokerSpec |-- -c -Control-------->

>--+-------------------------+--+------------------+------------>
   '- -e -executionGroupName-'  '- -w -timeoutSecs-'   

>--+--------------------+--------------------------------------><
   '- -v -traceFileName-'   

brokerSpec

|--+- brokerName ---------------+-------------------------------|
   +- -n -brokerFileName--------+   
   | .------------------------. |   
   | V                        | |   
   '-----+- -i -ipAddress-+---+-'   
         +- -p -port------+         
         '- -q -qMgr------'         

パラメーター

brokerSpec
(必須) このコマンドのターゲット・ブローカーを識別するには、以下のいずれかの形式で、1 つ以上のパラメーターを指定しなければなりません。
brokerName
このパラメーターは、ローカルに定義されているブローカーの名前を識別します。ブローカーがリモート・コンピューター上にある場合は、このオプションは使用できません。
-n brokerFileName
このパラメーターは、ローカル・ブローカーまたはリモート・ブローカーに関する接続の詳細を含むファイルの名前を識別します。

このオプションは、複数のユーザーが同じブローカーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。

このファイルを作成するには、WebSphere® Message Broker Explorer 内でブローカーを右クリックし、「*.broker ファイルのエクスポート」を選択します。プロンプトが出た場合は、ファイルを保存する場所にナビゲートし、ファイル名を入力してください。「保管」をクリックする際に、拡張子 .broker が自動的に付加されます。このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。

SSL を使用して、セキュア・チャネルを介してリモート・ブローカーを管理するコマンドを実行する場合、IBM_JAVA_OPTIONS 環境変数を使用して、接続用の鍵ストアおよびトラストストアのパスワードを指定する必要があります。詳細は、コマンド実行時の問題の解決を参照してください。

-i ipAddress, -p port, -q qMgr
これらのパラメーターは、ブローカーに関する接続の詳細を識別します。

拡張接続パラメーターが必要ないリモート・ブローカーへの接続の場合は、このオプションを使用します。

このオプションを選択する場合は、以下の 3 つのパラメーターのうち 1 つ以上を指定しなければなりません。指定する順序は意味を持ちません。それぞれのパラメーターを複数回指定することはできません。

省略したパラメーターは、デフォルト値が想定されます。

  • -i ipAddress: ブローカーが稼働中のコンピューターのホスト名または IP アドレス。このパラメーターを指定しない場合、ローカル・コンピューターを表す値が使用されます。
  • -p port: ブローカーのキュー・マネージャーが listen する TCP ポート。このパラメーターを指定しない場合、値 1414 が使用されます。
  • -q qMgr: ブローカーのキュー・マネージャーの名前。このパラメーターを指定しない場合、ローカル・コンピューター上のデフォルトのキュー・マネージャーを表す値が使用されます。
z/OS のリモート・キュー・マネージャーには接続できません。使用上の注意を参照してください。
-c Control
(必須) リソース統計収集に適用するアクションを定義する値。
  • リソース統計収集を開始する場合は、active を指定します。
  • リソース統計収集を停止する場合は、inactive を指定します。
-e executionGroupName
(オプション) リソース統計収集を開始/停止する実行グループの名前。

-e を指定しない場合は、ブローカーのすべての実行グループのリソース統計収集が開始/停止します。

-w timeoutSecs
(オプション) このパラメーターは、コマンドが完了したことを確認するためにユーティリティーが待機する時間 (秒数) を指定します。デフォルト値は 60 です。
-v traceFileName
(オプション) このパラメーターは、指定されたファイルに内部デバッグ・トレース情報を送信します。

使用上の注意

i、p、および q パラメーターを指定して、または接続パラメーター・ファイル (.broker) を使用して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java クライアント・コードを使用しようとします。このオプションは z/OS ではサポートされておらず、以下のエラーが戻されます。

BIP1046E: ブローカー (name) と接続できません。

報告される理由コードは MQRC_ENVIRONMENT_ERROR です。 ローカル・キュー・マネージャーを指定する必要があります。

許可

Windows、Linux、および UNIX システムでは、このコマンドの実行に使用するユーザー ID は mqbrkrs グループのメンバーでなければなりません。

応答

このコマンドは、以下の応答を戻します。
0
コマンドが正常に完了しました。
2
(Failure) ブローカーはデプロイメント要求を受け取りましたが、それを正常に処理できませんでした。詳しくは、ユーティリティーから出されるメッセージ (または管理ログ) を参照してください。
9
(Failure) 要求はブローカーに実行依頼されましたが、タイムアウトが満了する前に応答が受信されませんでした。
10
(Failure) ブローカーが要求操作を処理する前に、別のユーザーまたはアプリケーションがその操作を取り消しました。
98
ブローカーが実行されない。
99
指定した 1 つ以上のパラメーターが無効です。

例

BrokerA のすべての実行グループでリソース統計の収集を開始します。

mqsichangeresourcestats BrokerA -c active

ブローカー BrokerA の実行グループ default でリソース統計の収集を停止します。

mqsichangeresourcestats BrokerA -c inactive -e default
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:45:59


参照トピック参照トピック | バージョン 8.0.0.1 | bn43200_