D3 JMS 構成

最終公開日 : Sep 16, 2026
Related information

分散データ配信用の JMS (D3)

デフォルトの HTTP および TCP プロトコルの代わりに JMS を使用するように D3 を構成するには、'ebx' Web アプリケーションの WEB-INF/web.xml 展開記述子で宣言されている JMS 接続ファクトリ と次のキューを構成する必要があります。
注意:
TIBCO EBX® メイン構成が、プロパティ ebx.d3.modeebx.jms.activate、および ebx.jms.d3.activate を通じて JMS および D3 (「スレーブ」、「ハブ」、または「マスター」ノード) をアクティブ化しない場合、以下の環境エントリは EBX® ランタイムによって無視されます。これらのプロパティの詳細については、EBX® メイン構成プロパティの JMS および 分散データ配信 (D3) を参照してください。

プライマリノードとレプリカノードでの共通宣言 (共有キューの場合)

予約済みリソース名 デフォルトの JNDI 名 説明
jms/EBX_D3MasterQueue JBoss: java:/jms/EBX_D3MasterQueue D3 プライマリ JMS キュー (D3 モード「スレーブ」または「ハブ」のみ)。SOAP 要求を D3 プライマリノードに送信するために使用されるキュー名を指定します。メッセージプロデューサーは、プライマリノードリポジトリ ID をヘッダーフィールド JMSType の値として設定します。 Java タイプ: jakarta.jms.Queue
jms/EBX_D3ReplyQueue JBoss: java:/jms/EBX_D3ReplyQueue D3 応答 JMS キュー (「シングル」モードを除くすべての D3 モード用)。SOAP 応答を受信するための応答キューの名前を指定します。消費は、ヘッダーフィールド JMSCorrelationID を使用してフィルタリングされます。 Java タイプ: jakarta.jms.Queue
jms/EBX_D3ArchiveQueue JBoss: java:/jms/EBX_D3ArchiveQueue D3 JMS アーカイブキュー (「シングル」モードを除くすべての D3 モード用)。D3 ノードが使用する転送アーカイブ キューの名前を指定します。消費量は、ヘッダー フィールド JMSCorrelationID を使用してフィルタリングされます。アーカイブの重みがプロパティ ebx.jms.d3.archiveMaxSizeInKB で指定されたしきい値よりも高い場合、アーカイブは複数のシーケンスに分割されます。したがって、消費量は、代わりにヘッダーフィールド JMSXGroupID および JMSXGroupSeq を使用してフィルタリングされます。 Java タイプ: jakarta.jms.Queue
jms/EBX_D3CommunicationQueue JBoss: java:/jms/EBX_D3CommunicationQueue D3 JMS 通信キュー (「シングル」モードを除くすべての D3 モード用)。リクエストを受信する通信キューの名前を指定します。消費は、現在のリポジトリ ID に対応するヘッダーフィールド JMSType を使用してフィルタリングされます。 Java タイプ: jakarta.jms.Queue
注意:
これらの JNDI 名はデフォルトで設定されていますが、EBX.ear に含まれる Web アプリケーションアーカイブ ebx.war 内で変更できます (JBoss、Websphere、またはその他のアプリケーションサーバーを使用している場合)。

プライマリノード上のオプションの宣言 (レプリカ固有のキュー用)

注意:
5.5.0 より前の互換性の昇順、または単方向キュートポロジに使用されます。
プライマリノードの展開記述子は、各レプリカノードの特定の通信キューとアーカイブキューを宣言して手動で変更する必要があります。これは、「ebx.war」内の「web.xml」にリソース名を追加することから成ります。レプリカ固有のノードキューは、1 つ以上のレプリカノードで使用できます。
リソースには自由に名前を付けることができますが、関連付けられているキューの物理名は、リソース jms/EBX_D3ArchiveQueue および jms/EBX_D3CommunicationQueue のレプリカ ノードの定義に対応している必要があります。
注意:
物理キュー名の一致:登録時に、レプリカノードは通信およびアーカイブの物理キュー名を送信します。これらのキューは、プライマリノードで宣言されたすべてのリソース間で物理キュー名によって一致します。一致しない場合は、登録は失敗します。

JMS 構成の例

プライマリノードと、共有キューを持つ2つのレプリカノード間

D3_JMS_configuration_master-slave_shared.png

プライマリノードとレプリカ固有のキューを持つレプリカノード間

D3_JMS_configuration_master-slave_specific.png

共有キューを持つ 2 つのハブノード間

D3_JMS_configuration_hub-hub_shared.png

レプリカ固有のキューを持つ 2 つのハブノード間

D3_JMS_configuration_hub-hub_specific.png