[V9.0.5 2018 年 3 月]

エージェントの応答本体属性

エージェント・オブジェクトを指定した HTTP GET メソッドを使用してエージェントに関する情報を要求する場合、次の属性が名前付きの JSON オブジェクト内で返されます。

以下のオブジェクトは、応答に組み込まれるデフォルトの属性であり、常に返されます。
名前
ストリング
調整キュー・マネージャーの下に登録されるエージェントの名前を示します。
タイプ
ストリング
エージェントのタイプを指定します。詳しくは、 GET を参照してください。
state
ストリング
エージェントの状態を指定します。詳しくは、 GET を参照してください。
以下のオブジェクトを使用できます。

general

description
ストリング
エージェント作成時に説明を設定した場合、エージェントの説明を示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.説明
statusAge
ストリング
エージェントの経過時間を示します。 経過時間は、調整キュー・マネージャーが稼働しているマシンのシステム時刻と、エージェントによって最後の状況がパブリッシュされた時刻の差として計算されます。
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.statusAge
バージョン
ストリング
キュー・マネージャーのバージョンを示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.バージョン
レベル
ストリング
実行中のキュー・マネージャーのビルド・レベルを示します。
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.level
statusPublicationRate
整数
エージェントが自身の状況をパブリッシュする速度を秒単位で指定します。
この属性のデフォルト値は 300 秒です
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.statusPublicationRate
statusPublishTime
ストリング
エージェントが自身の状況をパブリッシュした時刻を世界時定数形式で示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.statusPublish時間
maximumQueuedTransfers
整数
エージェントが、新規の転送要求を拒否するまでに、キューに入れておくことができる保留中の転送の最大数を指定します。
この属性のデフォルト値は 1000 です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.maximumQueued転送
maximumQueuedTransfers
整数
エージェントが、新規の転送要求を拒否するまでに、キューに入れておくことができる保留中の転送の最大数を指定します。
この属性のデフォルト値は 1000 です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.maximumQueued転送
maximumDestinationTransfers
整数
宛先エージェントが時点を問わず常に一度に処理できる並行転送の最大数を示します。
この属性のデフォルト値は 25 です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.maximumDestination転送
maximumSourceTransfers
整数
ソース・エージェントが時点を問わず常に一度に処理できる並行転送の最大数を示します。
この属性のデフォルト値は 25 です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.maximumSource転送
operatingSystem
ストリング
エージェント・キュー・マネージャーが作成されるオペレーティング・システムを示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =general
  • attributes=*
  • attributes=general.operatingSystem

qmgrConnection

このオブジェクトは、キュー・マネージャー接続に関する情報を提供します。
qmgrName
ストリング
エージェント・キュー・マネージャーの名前を示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.qmgrName
transportType
ストリング
エージェントがキュー・マネージャーに接続するトランスポート・タイプを示します。トランスポート・タイプは client または bindings のいずれかです
デフォルト値は bindings です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.transportType
host
ストリング
エージェント・キュー・マネージャーのホスト名を示します。transportType が client である場合にのみ使用されます
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.ホスト
port
integer
エージェント・キュー・マネージャーのチャネル通信ポートを示します。transportType が client である場合にのみ使用されます
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.ポート
channelName
ストリング
エージェント・キュー・マネージャーのチャネルを示します。transportType が client である場合にのみ使用されます
この属性のデフォルト値は SYSTEM.DEF.SVRCONN に設定されています
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.channelName
standbyHost
ストリング
複数インスタンスのエージェント・キュー・マネージャーのスタンバイ・インスタンスに接続するためにクライアント接続によって使用されるホスト名を示します
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.standbyHost
standbyPort
整数
クライアントが複数インスタンスのエージェント・キュー・マネージャーのスタンバイ・インスタンスに接続するために使用できるポート番号を示します
この属性のデフォルト値は -1 に設定されています
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =qmgrConnection
  • attributes=*
  • attributes=qmgrConnection.standbyPort

connectDirectBridge

このオブジェクトは、直接ブリッジ・タイプ・エージェントに接続するための情報を提供します。 他のタイプのエージェントの場合、このオブジェクトは追加されません。
nodeName
ストリング
このエージェントから宛先の Connect:Direct ノードにメッセージを転送するために使用する Connect:Direct ノードの名前を示します。
この属性のデフォルト値はありません。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =connectDirectBridge
  • attributes=*
  • attributes=connectDirectBridge.nodeName
host
ストリング
-cdNodeパラメーターで指定された Connect:Direct ノードが配置されているシステムのホスト名または IP アドレスを指定します。
-cdNodeHostパラメーターを指定しない場合は、ローカル・システムのホスト名または IP アドレスのデフォルトが使用されます。
この属性のデフォルト値は、構成されているホストの詳細です (例、localhost)
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =connectDirectBridge
  • attributes=*
  • attributes=connectDirectBridge.ホスト
port
整数
クライアント・アプリケーションがノードとの通信に使用する Connect:Direct ノードのポート番号を示します。
この属性のデフォルト値は 1363 です
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =connectDirectBridge
  • attributes=*
  • attributes=connectDirectBridge.ポート

protocolBridge

このオブジェクトは、プロトコル・ブリッジ・タイプ・エージェントに関する情報を提供します。 他のタイプのエージェントの場合、このオブジェクトは追加されません。
endpoints
ストリング
ブリッジがサポートできるエンドポイントの数を示します。
注: デフォルトのプロトコル・サーバーを設定していない場合、 defaultServer フィールドは使用できません。
この属性のデフォルト値は、 IBM® WebSphere® MQ 7.0.1multiple です。
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =protocolBridge
  • attributes=*
  • attributes=protocolBridge.エンドポイント
defaultServer
ストリング
デフォルトのプロトコル・サーバーが設定されている場合、そのホスト名または IP アドレスを指定します。 デフォルトのプロトコル・フィールドが設定されていない場合、この値はブランクになります。
この値は、プロトコル・タイプ、サーバー、およびポートをすべて含めた、以下の形式のストリングです。

<protocolType>://<serverName or IP address>:<port>
以下に例を示します。
"ftp://localhost:21" 
この属性にはデフォルト値はありません
この属性は、照会時に以下のいずれかが設定されている場合にのみ返されます。
  • 属性 =protocolBridge
  • attributes=*
  • attributes=protocolBridge.defaultServer