WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

mqsicacheadmin コマンド

mqsicacheadmin コマンドを使用して、グローバル・キャッシュおよび完全基本管理に関する情報を提供します。

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

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

目的

mqsicacheadmin コマンドは、ブローカーに組み込まれているグローバル・キャッシュに関する情報を提供します。 例えば、マップのサイズを調べたり、キャッシュに関係しているホストをリストしたり、データをマップから消去したりすることができます。

このコマンドは、WebSphere® eXtreme Scale に付属する xscmd ユーティリティーで使用できるコマンドのサブセットを提供します。 これらのコマンド、および返される情報について詳しくは、WebSphere eXtreme Scale インフォメーション・センターを参照してください。

使用上の注意

  • mqsicacheadmin コマンドを実行する前に、ブローカーが実行されていること、およびグローバル・キャッシュが使用可能であることを確認します。 要求情報を提供するために、コマンドはキャッシュ・コンポーネントに接続します。
  • このコマンドを実行する前に、キャッシュ・コンポーネントをホストするすべての実行グループで enableJMX パラメーターが true に設定されていることを確認してください。 実行グループがグローバル・キャッシュに関する管理情報を提供できるようにするために、このパラメーターを有効にする必要があります。 (詳しくは、cachemanager コンポーネントのパラメーター値を参照してください。) デフォルト・キャッシュ・トポロジーまたは XML ポリシー・ファイルを使用する場合、このパラメーターは自動的に true に設定されます。
  • このコマンドを有効にするために、ブローカーを再始動する必要はありません。 例えば、clearGrid コマンドは即時に有効になり、指定されたマップのすべてのデータが消去されます。
  • 接続パラメーター・ファイル (.broker) を指定して、リモート・ブローカーに接続しようとする場合、コマンドは WebSphere MQ Java™ クライアント・コードを使用しようとします。 このオプションは z/OS ではサポートされておらず、以下のエラーが返されます。
    BIP1046E: Unable to connect with the broker (name)
    
    The reported reason code is MQRC_ENVIRONMENT_ERROR. 
    ローカル・キュー・マネージャーを指定する必要があります。

構文

構文図を読む構文図をスキップする
>>-mqsicacheadmin--+------------+------------------------------->
                   '-BrokerName-'   

>--+-----------------------------+-- -c --command--------------->
   +- -cep --connectionEndPoints-+                  
   '- -n --brokerFileName--------'                  

>--+---------------+-------------------------------------------><
   '- -m --mapName-'   

パラメーター

BrokerName
(オプション) 変更するローカル・ブローカーの名前。 このパラメーターを指定しない場合、代わりに、connectionEndPoints パラメーターまたは brokerFileName パラメーターのいずれかを指定する必要があります。

 

-cep connectionEndPoints
(オプション) ブローカーで稼働しているキャッシュ・カタログ・サーバーの接続に関する詳細。 このパラメーターの形式は、hostName:listenerPort です。 このパラメーターを指定しない場合、代わりに、brokerName パラメーターまたは brokerFileName パラメーターのいずれかを指定する必要があります。

 

-n brokerFileName
(オプション) リモート・ブローカー接続パラメーターを格納するファイル (*.broker)。 このパラメーターを指定しない場合、代わりに、brokerName パラメーターまたは connectionEndPoints パラメーターのいずれかを指定する必要があります。

 

-c command
(必須) 組み込みキャッシュに対して実行するコマンド。 このコマンドに有効な値は以下のとおりです。
clearGrid
組み込みキャッシュ内の指定されたマップからすべてのデータを消去します。 このコマンドは即時に有効になり、ブローカーを再始動する必要はありません。
showMapSizes
組み込みキャッシュのすべてのマップのサイズを表示します。
placementServiceStatus
ObjectGrid 配置操作の状況を表示します。
routetable
組み込みキャッシュのすべての WebSphere eXtreme Scale シャードおよびパーティションの現行ルーティング・テーブルを表示します。
showPlacement
組み込みキャッシュのすべてのコンテナー・サーバーおよびそのシャードをリストします。
listHosts
組み込みキャッシュに参加しているすべてのホストをリストします。

 

-m mapName
(オプション) コマンドの実行対象となるマップの名前。 このパラメーターは、コマンド clearGrid の場合に必須です。 それ以外のすべてのコマンドでは、このパラメーターは無視されます。

 

応答

標準のコマンド応答に加えて、以下の応答がこのコマンドによって返されます。
  • BIP7186 mqsicacheadmin コマンドの使用法情報
  • BIP7187 mqsicacheadmin コマンドからの出力
  • BIP7188 グローバル・キャッシュのカタログ・サーバーの接続パラメーターを判別できません

許可

プラットフォーム固有の許可について詳しくは、以下のトピックを参照してください。 ブローカー管理セキュリティーを有効に設定した場合は、管理セキュリティーのタスクと権限で説明されている権限もセットアップする必要があります。

コマンドは常に 1 行で入力します。 いくつかの例では、読みやすいように改行しています。

以下の例は、組み込みキャッシュのすべてのマップのサイズを表示します。
mqsicacheadmin brokerName -c showMapSizes
以下の例は、-cep パラメーターを使用してカタログ・サーバーに接続し、各 WebSphere eXtreme Scale シャードのルーティング・テーブルを表示します。
mqsicacheadmin -cep server.company.com:2800 -c routetable
以下の例は、「myMap」という名前のマップからすべてのデータを消去します。
mqsicacheadmin brokerName -c clearGrid -m myMap
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:49:20


参照トピック参照トピック | バージョン 8.0.0.5 | bn23783_