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

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

mqsilist コマンド - WindowsLinux、および UNIX システム

mqsilist コマンドを使用して、1 つ以上のブローカーとそのデプロイ済みリソースについての情報をリストします。

構文

構文図を読む構文図をスキップする
>>-mqsilist--+----------------------------------+--------------->
             +- -a -----------------------------+   
             '-| brokerSpec |--+--------------+-'   
                               '- -e --egName-'     

>--+-------------------+--+-----------------------+--+------+--->
   '- -d --detailLevel-'  '- -k --applicationName-'  '- -r -'   

>--+---------------------+--+-------------------+--------------->
   '- -v --traceFileName-'  '- -w --timeoutSecs-'   

>--+-------------------+---------------------------------------><
   '- -y --libraryName-'   

brokerSpec

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

パラメーターを使わずにこのコマンドを指定した場合、このコンピューターの現在のインストール済み環境で作成済みのブローカーに関する要約が戻されます。

現在のインストール済み環境は、(Windows では) 既に開いているコマンド・コンソール、または (Linux および UNIX システムでは) アクティブな mqsiprofile に関連付けられます。

パラメーター

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: ブローカーのキュー・マネージャーの名前。 このパラメーターを指定しない場合、ローカル・コンピューター上のデフォルトのキュー・マネージャーを表す値が使用されます。
-a
(オプション) ローカル・コンピューターのすべてのインストール済み環境にある、インストールされたすべてのブローカーをリストします。

バージョン 7.0 より前のバージョンがインストールされたコンピューターに対してこのオプションを指定した場合、それらのバージョンのブローカーだけがリストされます (存在する場合)。 このコマンドで別の詳細レベルを指定した場合 (またはデフォルトを受け入れた場合) であっても、これらの古いブローカーに関する詳細レベルは -d 0 になります。 以前のバージョンで作成した他のコンポーネントについての情報を表示するには、それに該当するバージョンの mqsilist コマンドを使用する必要があります。

このオプションを使ってリモート・ブローカーとそのリソースについての情報をリストすることはできません。

-d detailLevel
(オプション) 戻される詳細のレベルを指定します。デフォルト値は 1 です。
  • 0 の場合、ブローカーの名前とそれに関連するキュー・マネージャーの名前だけが戻されます (この情報は以前のバージョンで提供された詳細と同じです)。

    開始中に、実行グループが PID 0 を報告する可能性があることに注意してください。

  • 1 の場合、リソースごとに 1 行の要約が戻されます。
  • 2 の場合、各リソースについての詳細情報が戻されます。
-e egName
(オプション) ブローカー内の実行グループを選択します。メッセージ・フローをリストする実行グループのラベルを指定してください。コマンドは、ブローカー内の指定された実行グループに割り当てられたメッセージ・フローのリストを戻します。

メッセージ・フローの情報が戻されるためには、指定されたブローカーがアクティブでなければなりません。

-k applicationOrServiceName
(オプション) このパラメーターは、アプリケーションまたはサービス用に構成されるデプロイされたオブジェクトをリストします。 このパラメーターを使用する場合には、-e パラメーターを使って実行グループを指定する必要もあります。
-r
(オプション) コマンドを再帰的に実行して、サブコンポーネントについての情報を表示します。
-v traceFileName
(オプション) このパラメーターは、指定されたファイルに内部デバッグ・トレース情報を送信します。
-w timeoutSecs
(オプション) このパラメーターは、コマンドが完了したことを確認するためにユーティリティーが待機する時間 (秒数) を指定します。デフォルト値は 60 です。
-y libraryName
(オプション) このパラメーターは、ライブラリー用に構成されるデプロイされたオブジェクトをリストします。 このパラメーターを使用する場合には、-e パラメーターを使って実行グループを指定する必要もあります。 また、このパラメーターと共に -k パラメーターを使用して、-k パラメーターで指定したアプリケーション内の特定のライブラリーの内容をリストすることもできます。

以下の例は、現在のインストール済み環境で作成されたすべてのブローカーをリストします。
mqsilist -d0
次のような応答が生成されます。
BIP8099I: Broker: MB8BROKER  -  MB8QMGR
BIP8099I: Broker: test  -  testqm

BIP8071I: Successful command completion.
以下の例では、デフォルトの実行グループのアプリケーション myApplication 用に構成されているデプロイ済みオブジェクトがリストされます。
mqsilist MB8BROKER -e default -k myApplication
以下の例では、デフォルトの実行グループのアプリケーション myApplication に含まれるライブラリー myEGLibrary 用に構成されているデプロイ済みオブジェクトがリストされます。
mqsilist MB8BROKER -e default -k myApplication -y myEGLibrary
以下の例では、デフォルトの実行グループのアプリケーション myApplication に関する詳細情報が戻ります。
mqsilist MB8BROKER -e default -k myApplication -d2
以下の例では、アプリケーション myApplication に構成されているデプロイ済みオブジェクトすべてがリストされます。
mqsilist MB8BROKER -e default -k myApplication -r
以下の例は、特定のブローカー上に定義されている実行グループについての要約を要求します。 (-d パラメーターを指定しないため、デフォルト値 1 が使用されます。)
mqsilist MB8BROKER 
次のような応答が生成されます。
BIP1286I: Execution group 'ello' on broker 'MB8BROKER' is running.

BIP8071I: Successful command completion.
ローカル・コンピューター上のブローカーに関連するすべてのリソースについての詳細情報を表示します。
mqsilist -a -r -d2
次のような応答が生成されます。
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:¥Program Files¥IBM¥MQSI¥7.0

===================================
BIP1284I: Broker 'MB7BROKER' on queue manager 'MB7QMGR' is running.

Broker version: '7000' (build 'S000-L90708')
Platform: 'Microsoft Windows'
Process ID: '3116'
Short description: ''
Long description: ''

-----------------------------------
BIP1286I: Execution group 'ello' on broker 'MB7BROKER' is running.

Number of message flows that are enabled to run: '2'.
Number of applications that are enabled to run: '1'.
Process ID: '4220'
UUID: '45ef67ac-2201-0000-0080-f364270ba85e'
Short description: ''
Long description: ''

--------
BIP1288I: Message flow 'simpleflow' on execution group 'ello' is running.

Additional thread instances: '0'
Deployed: '24/07/09 16:37' in Bar file 'C:¥Documents and Settings¥Matt¥My Documents¥BAR Files¥test.bar'
Last edited: '08/08/07 17:42'
User-defined property names:
Keywords:
  Author = 'Matt'
  Information = 'This flow simply removes messages from SYSTEM.DEFAULT.LOCAL.QUEUE'
  Usage = 'This usage is buried inside the CMF'
  VERSION = 'v1.1'
--------
BIP1288I: Message flow 'MyApplicationFlow' on execution group 'ello' is running.

Additional thread instances: '0'
Deployed: '27/07/09 20:15' in Bar file 'C:¥Documents and Settings¥Matt¥My Documents¥BAR Files¥overridden.bar'
Last edited: '12/06/07 17:06'
User-defined property names:
Keywords:

--------
BIP1290I: File 'Swift_2002_MT103.dictionary' is deployed to execution group 'ello'.

Deployed: '27/07/09 16:47' in Bar file 'C:¥Documents and Settings¥Matt¥My Documents¥BAR Files¥SWIFT.bar'
Last edited: '06/09/05 15:17'.
Keywords:

===================================
BIP1285I: Broker 'test' on queue manager 'testqm' is stopped.

Start the broker for more information.

BIP8071I: Successful command completion.
ブローカーが待機モードのマルチインスタンス・ブローカーである場合には、次のような応答が生成されます。
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:¥Program Files¥IBM¥MQSI¥7.0

===================================
BIP1292I: Broker 'MIBROKER1' is a multi-instance broker .
The broker instance is running in Standby-mode on multi-instance
Queue manager ‘MIQMGR1'

More information will be available when the broker instance is active.

BIP8071I: Successful command completion
ブローカーがアクティブ・モードのマルチインスタンス・ブローカーである場合には、次のような応答が生成されます。
BIP1280I: The number of runtime installations on this machine is '1'.

 7.0.0.0 : C:¥Program Files¥IBM¥MQSI¥7.0

===================================
BIP1293I: Broker 'MIBROKER1' is a multi instance broker .
The broker instance is active and running on multi-instance
Queue manager ‘MIQMGR1'

-----------------------------------
BIP1286I: Execution group 'default' on broker 'MIBROKER1' is running.

Number of message flows that are enabled to run: '1'.
Number of applications that are enabled to run: '1'.
Process ID: '4876'
UUID: '45ef7be4-2203-0000-0080-b764270fa96c'
Short description: ''
Long description: ''

--------
BIP1288I: Message flow 'jmsflow' on execution group 'default' is running.

Additional thread instances: '0'
Deployed: '26/09/09 18:21' in Bar file 'C:¥Documents and Settings¥JDoe¥My Documents¥
  BAR Files¥test.bar'
Last edited: '24/09/09 12:16'
User-defined property names:
Keywords:
  Author = 'JDoe'
  Information = 'This flow runs a simple jms scenario'
  Usage = 'Takes JMS input and writes to an MQOutput node'
  VERSION = 'v2.3'
--------

BIP8071I: Successful command completion.
ブローカーが WebSphere MQ サービスとして始動しているマルチインスタンス・ブローカーである場合には、次のような応答が生成されます。
BIP1296I: ブローカー 'HABK1' は、WebSphere MQ サービスとして始動するマルチインスタンス・ブローカーです。
マルチインスタンス・キュー・マネージャー 'HAQM1' は停止しました。
BIP1298I: ブローカー 'BK3' は WebSphere MQ サービスとして始動します。 
キュー・マネージャー 'QM3' は停止しました。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:47:47


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