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

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

mqsilist コマンド - z/OS

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

構文

z/OS コマンド - BIPLIST

構文図を読む構文図をスキップする
>>-mqsilist--+---------------------------------+---------------->
             '-| 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------'         

z/OS コンソール・コマンド

同義語:l

構文図を読む構文図をスキップする
>>-+-list-+--+-----------+--+--------+--+----------------+-----><
   '-l----'  '- e=egName-'  '- r=yes-'  '- d=detailLevel-'   

パラメーターを使わずにこのコマンドを指定した場合、実行グループのリストが表示されます。

パラメーター

brokerSpec
このコマンドのターゲット・ブローカーを識別するには、以下のいずれかの形式で、1 つ以上のパラメーターを指定しなければなりません。
brokerName
このパラメーターは、ローカルに定義されているブローカーの名前を識別します。
-n brokerFileName
このパラメーターは、ローカル・ブローカーに関する接続の詳細を含むファイルの名前を識別します。

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

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

-i ipAddress, -p port, -q qMgr
これらのパラメーターは、ブローカーに関する接続の詳細を識別します。 キュー・マネージャーを指定する場合は、ローカル・コンピューター上に定義する必要があります。

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

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

  • -i ipAddress: ブローカーが稼働中のコンピューターのホスト名または IP アドレス。 このパラメーターを指定しない場合、ローカル・コンピューターを表す値が使用されます。
  • -p port: ブローカーのキュー・マネージャーが listen する TCP ポート。 このパラメーターを指定しない場合、値 1414 が使用されます。
  • -q qMgr: ブローカーのキュー・マネージャーの名前。 このパラメーターを指定しない場合、ローカル・コンピューター上のデフォルトのキュー・マネージャーを表す値が使用されます。
z/OS® のリモート・キュー・マネージャーには接続できません。使用上の注意を参照してください。
-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 パラメーターで指定したアプリケーション内の特定のライブラリーの内容をリストすることもできます。

使用上の注意

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

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

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

コンソール・コマンドを使用して、ブローカーの実行グループに関する要約を要求します。 (d= パラメーターを指定しないため、デフォルト値 1 が使用されます。)
F MQP1BRK,list 
次のような応答が生成されます。
BIP1286I: Execution group 'ello' on broker 'MQP1BRK' is running.

BIP8071I: Successful command completion.
コンソール・コマンドを使用して、指定した実行グループの中のメッセージ・フローをリストします。
F MQP1BRK,list e='exgrp1'		
次のような形式の応答が生成されます。
BIP1288I: Message flow 'simpleflow' on execution group 'ello' is running.

BIP8071I: Successful command completion
コンソール・コマンドを使用して、デフォルトの実行グループのアプリケーション myApplication に含まれるライブラリー myEGLibrary 用に構成されているデプロイ済みオブジェクトをリストします。
F MB8BROKER,list e='default' k='myApplication' y='myEGLibrary'

BIPLIST を使ってコマンドを実行する例と、生成される応答については、mqsilist コマンド - Windows、Linux、および UNIX システムを参照してください。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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