預設傳訊提供者 Queue Connection Factory [設定]

JMS Queue Connection Factory 用來建立 JMS 佇列之相關 JMS 提供者的連線,供點對點傳訊使用。請利用 Queue Connection Factory 管理物件來管理預設傳訊提供者的 JMS Queue Connection Factory。

如果要在主控台中檢視這個頁面,請按下列其中一個路徑:

  • 資源 -> JMS -> Queue Connection Factory -> factory_name
  • 資源 -> JMS -> JMS 提供者 -> a_messaging_provider -> [其他內容] Queue Connection Factory -> factory_name
請利用這個畫面來瀏覽或變更所選之 JMS Queue Connection Factory 的配置內容,以搭配預設傳訊 JMS 提供者使用。這些配置內容會控制如何建立相關聯之 JMS 佇列的連線。

依預設,在伺服器儲存器中利用這個 JMS Connection Factory 來建立的連線(例如,從 Enterprise Bean),會使用「Java Platform、Enterprise Edition (Java EE) 連接器架構 (J2C)」連線儲存區來聯合排存。 您可以在管理主控台畫面的「其他內容」區段中,選取連線儲存區內容鏈結,以修改 Connection Factory 的連線儲存區設定。

「配置」標籤

「配置」標籤顯示這個物件的配置內容。 即使停止再重新啟動執行時期環境,這些內容值也會保留下來。請參閱資訊中心作業說明,以取得如何將配置變更套用於執行時期環境的相關資訊。

一般內容

範圍

指定應用程式伺服器可以使用這個資源物件的最高拓蹼層次。

參考資訊
必要的
資料類型 String

提供者

指定一個 JMS 提供者,以根據 Java 訊息服務 (JMS) 來啟用非同步傳訊。 它提供 J2EE Connection Factory 來建立特定 JMS 佇列目的地或主題目的地的連線。JMS 提供者管理物件是用來管理相關聯之 JMS 提供者的 JMS 資源。

參考資訊
必要的
資料類型 String

名稱

必要的資源顯示名稱。

參考資訊
必要的
資料類型 String

JNDI 名稱

資源的 JNDI 名稱。

請依照慣例,使用格式為 jms/Name 的 JNDI 名稱,其中 Name 是資源的邏輯名稱。使用 JNDI 及其語法的詳細資訊,請參閱「WebSphere® Application Server 中的 JNDI 支援」主題。

參考資訊
必要的
資料類型 String

說明

資源的選用說明。

參考資訊
必要的
資料類型 文字區

種類

分類或分組資源時所用的選用種類字串。

參考資訊
必要的
資料類型 String

匯流排名稱

要連接的服務整合匯流排名稱。

這是這個 Connection Factory 用來建立其連線的服務整合匯流排的名稱。
請輸入應用程式建立連線來連接外部匯流排時,本端匯流排的名稱。
參考資訊
必要的
資料類型 自訂

Target

識別傳訊引擎群組的目標名稱。請利用目標類型內容來指定目標類型。

參考資訊
必要的
資料類型 String

目標類型

Target 內容所指名的目標類型。

這是指出目標名稱,以用來決定處理工作時所要使用的一或多個傳訊引擎。目標的類型由 目標類型 內容指出

連線會在符合選擇準則的可用傳訊引擎之間,進行負載平衡。

如果應用程式要能夠連接至匯流排中的任何傳訊引擎,請勿設定這個內容。

如需這個內容要如何與其他 Connection Factory 內容搭配使用,以管理連線工作量的相關資訊,請參閱「JMS 與匯流排連線的管理內容」主題。

參考資訊
必要的
資料類型 下拉清單
範圍
匯流排成員名稱
匯流排成員的名稱。這個選項會擷取指定的匯流排成員(應用程式伺服器或伺服器叢集)所管理的作用中傳訊引擎。

如果要指定非叢集化的匯流排成員,就必須將 Target 內容設為 <Node01>.<server1>,例如 Node01.server1。 如果是叢集匯流排成員,Target 內容就必須設為叢集名稱。

自訂傳訊引擎群組名稱
傳訊引擎自訂群組(形成自我宣告的叢集)的名稱。這個選項會擷取登錄在指名自訂群組中的作用中傳訊引擎。

傳訊引擎名稱
傳訊引擎的名稱。這個選項會擷取可用來連接指名的傳訊引擎的端點。

目標重要性

這個內容指定目標群組的重要性。

如需這個內容要如何與其他 Connection Factory 內容搭配使用,以管理連線工作量的相關資訊,請參閱「JMS 與匯流排連線的管理內容」主題。

參考資訊
必要的
資料類型 下拉清單
範圍
偏好的
傳訊引擎最好是選自目標群組。如果目標群組中有可用的傳訊引擎,就會選取它。如果目標群組中沒有可用的傳訊引擎,但有在目標群組之外、在相同服務整合匯流排中的傳訊引擎,就會選取這個傳訊引擎。

必要的
傳訊引擎必須選自目標群組。如果目標群組中有可用的傳訊引擎,就會選取它。如果目標群組中沒有可用的傳訊引擎,連線程序會失敗。

目標入埠傳輸鏈

當以應用程式之外的個別程序來連接傳訊引擎時,應用程式應設為目標之入埠傳輸鏈的名稱。 如果選擇了另一個程序中的傳訊引擎,傳訊引擎必須在執行指定的入埠傳輸鏈的伺服器中,才可以建立連線。 請參閱資訊中心,以取得相關資訊。

如果所選傳訊引擎位於應用程式所在相同伺服器,則會進行直接的進行中連線,且會忽略這個傳輸鏈內容。

傳輸鏈代表在伺服器內作業的網路通訊協定堆疊。 您指定的名稱必須是如伺服器 -> 伺服器類型 -> WebSphere 應用程式伺服器 -> server_name -> [伺服器傳訊] 傳訊引擎入埠傳輸所列,是管理傳訊引擎的伺服器所提供的傳輸鏈之一。 提供的傳輸鏈如下,但您可以在這個畫面中定義您自己的傳輸鏈。
InboundBasicMessaging
這是一個使用標準 TCP/IP 連線 (JFAP-TCP/IP) 的連線導向通訊協定。它支援兩段式的交易式(遠端 XA)流程,因此,在用戶端或伺服器系統上執行的訊息生產端或消費端可以參與這個用戶端或伺服器系統上所管理的廣域交易。 XA 流程的特定用途,是支援從執行於某伺服器的應用程式存取在第二部伺服器上的傳訊引擎,原因可能是第一部伺服器沒有適當的傳訊引擎。 如果使用遠端 XA 流程,應用程式必須能夠在本端使用交易協調程式。
InboundSecureMessaging
這是包裝在 SSL 中的 InboundBasicMessaging 通訊協定。
如需這個內容要如何與其他 Connection Factory 內容搭配使用,以管理連線工作量的相關資訊,請參閱「JMS 與匯流排連線的管理內容」主題。
參考資訊
必要的
資料類型 String

提供者端點

用來連接引導伺服器的逗點區隔端點 Triplet 清單,語法如下:hostName:portNumber:chainName。 例如,Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging。如果未指定 hostName,預設值是 localhost。 如果未指定 portNumber,預設值是 7276。 如果未指定 chainName,預設值是 BootstrapBasicMessaging。 請參閱資訊中心,以取得相關資訊。

您只在有用戶端應用程式是在應用程式伺服器之外執行,或有應用程式在另一 Cell 中的伺服器上,想利用這個 Connection Factory 來連接 Connection Factory 上所指定的目標服務整合匯流排時,才需修改這個內容。

如果要使用預設傳訊提供者的 JMS 目的地,應用程式會連接至目的地所指派的目標服務整合匯流排中的傳訊引擎。比方說,JMS 佇列會指派給服務整合匯流排中的佇列目的地。

在應用程式伺服器之外執行(例如:在用戶端儲存器中執行或在 WebSphere Application Server 環境之外執行)的用戶端應用程式,無法在目標匯流排中直接找到適合連接的傳訊引擎。 同樣地,在 Cell 內某部伺服器中執行,且要連接到另一個 Cell 中之目標匯流排的應用程式,也無法在目標匯流排中直接找到要連接的適當傳訊引擎。

在這些實務中,用戶端(或另一個匯流排中的伺服器)必須利用本身是目標匯流排成員的引導伺服器來完成引導程序。 引導伺服器是執行「SIB 服務」,但不需要執行任何傳訊引擎的應用程式伺服器。 引導伺服器會選取在支援所需目標傳輸鏈的應用程式伺服器中執行的傳訊引擎。 為了能夠採行引導程序,您必須在用戶端所用的 Connection Factory 中配置一或多個提供者端點

引導伺服器會使用特定之埠和引導傳輸鏈。這個埠是管理鏈結遠端系統之傳訊引擎的 SIB_ENDPOINT_ADDRESS(如果啟用安全,就是 SIB_ENDPOINT_SECURE_ADDRESS)。當配上主機名稱時,即構成引導伺服器的端點位址

應用程式所用的 JMS Connection Factory 內容會控制適當傳訊引擎的選擇及應用程式連接至所選傳訊引擎的方式。
  • 若未提供安全認證,則依預設
    • 如果未指定任何主機,就使用 localhost
    • 如果未指定任何埠,就使用 7276
    • 如果未指定引導通道鏈,就使用稱為 BootstrapBasicMessaging 的引導傳輸鏈
  • 若有提供安全認證,則依預設
    • 如果未指定任何主機,就使用 localhost
    • 如果未指定任何埠,就使用 7286
    • 如果未指定引導通道鏈,就使用稱為 BootstrapBasicMessaging 的引導傳輸鏈
[IBM i] 註: 如果是 IBM® i 平台,您必須(至少)將預設主機名稱從 localhost 改成 your.server.name

如果您要應用程式使用含不同端點位址的引導伺服器,您必須在用戶端應用程式所用的 JMS Connection Factory 的提供者端點內容上,指定必要的端點位址。 您可以指定引導伺服器的一或多個端點位址。

在應用程式伺服器之外的應用程式所用的每個 JMS Connection Factory 都必須指定引導伺服器的端點位址。 如果要避免指定太長的引導伺服器清單,您可以提供少數具有高可用性的伺服器來作為專用的引導伺服器。 之後,您只需要在每個 Connection Factory 上指定一份短的引導伺服器清單。

註: 在配置與非預設引導伺服器間的連線時,請指定所需的端點位址值並使用冒號作為分隔字元。
例如:在 boothost1 主機上,有一個伺服器指派了非安全埠號 7278,所用的預設傳輸鏈為 BootstrapBasicMessaging
boothost1:7278:BootstrapBasicMessaging
or
boothost1:7278
boothost2 主機上,有一個伺服器指派了安全埠號 7289,所用的預先定義傳輸鏈為 BootstrapTunneledSecureMessaging
boothost2:7289:BootstrapTunneledSecureMessaging
端點位址的語法如下:
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
其中:
host_name
伺服器執行所在的主機名稱。可以是 IP 位址。若為 IPv6 位址,請按如下所示,用方括弧 ([]) 括住 host_name
[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
. 如果沒有指定一值,預設值是 localhost
[IBM i] 註: 如果是 IBM i 平台,您必須(至少)將預設主機名稱從 localhost 改成 your.server.name
port_number
若有指定,則為管理鏈結之遠端系統的下列其中一個傳訊引擎位址:
  • SIB_ENDPOINT_ADDRESS(如果沒有啟用安全的話)
  • 對於安全連線而言,如果啟用安全,就是 SIB_ENDPOINT_SECURE_ADDRESS

如果沒有指定 port_number,則預設值為 7276

如果要利用管理主控台來尋找任何這些值,請按一下伺服器 -> 伺服器類型 -> WebSphere 應用程式伺服器 -> server_name -> [通訊] 埠

chain_name
連接引導伺服器時所用之預先定義的引導傳輸鏈名稱。如果沒有指定,預設值是 BootstrapBasicMessaging

以下是所提供的預先定義的引導傳輸鏈:

BootstrapBasicMessaging
這對應於伺服器傳輸鏈 InboundBasicMessaging (JFAP-TCP/IP)
BootstrapSecureMessaging
這對應於伺服器傳輸鏈 InboundSecureMessaging (JFAP-SSL-TCP/IP)
BootstrapTunneledMessaging
在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱伺服器 -> 伺服器類型 -> WebSphere 應用程式伺服器 -> server_name -> [伺服器傳訊] 傳訊引擎入埠傳輸。)這個傳輸鏈會建立 JFAP 通道,並使用 HTTP 封套。
BootstrapTunneledSecureMessaging
在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱伺服器 -> 伺服器類型 -> WebSphere 應用程式伺服器 -> server_name -> [伺服器傳訊] 傳訊引擎入埠傳輸。)這個傳輸鏈會建立 JFAP 通道,並使用 HTTP 封套。

指定 host_name : chain_name,而不是 host_name : : chain_name(兩個冒號),並不正確。 完全不輸入有效,輸入下列任何字串也有效:"a"、"a:"、":7276"、"::chain",等等。 如果您未指定一值,則會套用預設值,但您必須使用 ":" 來隔開各欄位。

如果您提供多個引導伺服器,請識別所有必要的端點位址。 請用逗點字元隔開各個端點位址。以前例中的伺服器為例:
boothost1:7278:BootstrapBasicMessaging,
  boothost2:7289:BootstrapTunneledSecureMessaging,
  [2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
參考資訊
必要的
資料類型 文字區

連線近似性

關聯於引導傳訊引擎,且可接受連線要求之傳訊引擎的近似性。

當用戶端發出用戶端連線要求時,處理程序會依照下列邏輯來附加至必要的匯流排:
  • 如果指定了目標群組,便連接至符合目標類型下列條件的第一個傳訊引擎:
    • 伺服器 - 尋找相同伺服器中的傳訊引擎。
    • 叢集 - 先在相同伺服器,之後在相同叢集的其他伺服器中,尋找傳訊引擎。
    • 主機 - 先在相同伺服器,之後在相同叢集的其他伺服器,之後在相同主機的其他伺服器中,尋找傳訊引擎。
    • 匯流排 - 先在相同伺服器,之後在相同叢集的其他伺服器,之後在相同主機的其他伺服器中,尋找傳訊引擎,之後尋找相同匯流排中的任何其他傳訊引擎。
  • 如果未指定目標群組,或指定了目標群組,但找不到適當的傳訊引擎,且目標重要性是偏好的,就會連接到符合下列目標類型條件的第一個傳訊引擎:
    • 伺服器 - 尋找相同伺服器中的傳訊引擎。
    • 叢集 - 連線失敗。
    • 主機 - 先在相同伺服器,之後在相同主機的其他伺服器中,尋找傳訊引擎。
    • 匯流排 - 先在相同伺服器的目標群組中,之後在相同主機的其他伺服器中,尋找傳訊引擎,之後尋找相同匯流排中的任何其他傳訊引擎。

如需這個內容要如何與其他 Connection Factory 內容搭配使用,以管理連線工作量的相關資訊,請參閱「JMS 與匯流排連線的管理內容」主題。

參考資訊
必要的
資料類型 下拉清單
範圍
匯流排
可建立連線來通往相同匯流排中的傳訊引擎。

叢集
可建立連線來通往相同伺服器叢集中的傳訊引擎。

主機
可建立連線來通往相同主機中的傳訊引擎。

伺服器
可建立連線來通往相同應用程式伺服器中的傳訊引擎。

非持續性訊息可靠性

套用在使用這個 Connection Factory 所傳送之非持續性 JMS 訊息的可靠性。

您可以將 JMS 應用程式所傳送訊息之目的地的遞送可靠性選項,變更為非持續性。 預設值是快速非持續性,但您仍有一系列其他選項,其中包括具有持續性質的選項,最可靠是確定持續性。 如需相關資訊,請參閱「訊息可靠性層次 - JMS 遞送模式和服務整合服務品質」主題。
參考資訊
必要的
資料類型 下拉清單
範圍
最大努力非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。訊息也可能因為用來傳送訊息的連線無法使用,或系統資源受到限制,而遭到捨棄。

快速非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。如果用來傳送訊息的連線無法使用,也可能捨棄訊息。

可靠非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。

可靠持續性
當傳訊引擎失敗時,可能會捨棄訊息。

確定持續性
不捨棄訊息。

作為匯流排目的地
使用配置給匯流排目的地的遞送選項。

持續性訊息可靠性

套用在使用這個 Connection Factory 所傳送之持續性 JMS 訊息的可靠性。

您可以將 JMS 應用程式所傳送訊息之目的地的遞送可靠性選項,變更為持續性。 預設值是可靠持續性,但您仍有一系列其他選項,其中包括具有非持續性質的選項,最不可靠是最大努力非持續性。 如需相關資訊,請參閱「訊息可靠性層次 - JMS 遞送模式和服務整合服務品質」主題。
重要: 如果您變更 JMS 應用程式所傳送之訊息的遞送可靠性選項,從持續性訊息可靠性選項(確定持續性可靠持續性)之一,改成非持續性訊息可靠性選項(最大努力非持續性快速非持續性可靠非持續性)之一,在特定情況中,會有失去訊息的風險。 例如,在伺服器重新啟動時,或工作量很大時。
參考資訊
必要的
資料類型 下拉清單
範圍
最大努力非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。訊息也可能因為用來傳送訊息的連線無法使用,或系統資源受到限制,而遭到捨棄。

快速非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。如果用來傳送訊息的連線無法使用,也可能捨棄訊息。

可靠非持續性
當傳訊引擎停止或失敗時,會捨棄訊息。

可靠持續性
當傳訊引擎失敗時,可能會捨棄訊息。

確定持續性
不捨棄訊息。

作為匯流排目的地
使用配置給匯流排目的地的遞送選項。

先讀

先讀是一種事先將訊息指派給消費端的最佳化。這會改進滿足消費端要求所花的時間。

指派給消費端的訊息會鎖定在伺服器中,這個目的地的任何其他消費端都無法使用這些訊息。指派給消費端的訊息,如果在這個消費端關閉之前都未使用,之後便會在伺服器中解開鎖定,任何其他消費端都可以接收它。

您可以設定個別 JMS 目的地的先讀內容來置換 JMS 目的地的這個內容。

參考資訊
必要的
資料類型 下拉清單
範圍
預設值
訊息提供者會事先將訊息指派給不可延續的訂閱和非共用的可延續訂閱的消費端。也就是說,必須在只能有單一消費端時,才會開啟先讀最佳化。

已啟用
傳訊提供者會事先將訊息指派給消費端。這會改進滿足消費端要求所花的時間。

停用
傳訊提供者不會事先將訊息指派給消費端。

暫時佇列名稱字首

應用程式利用這個 Connection Factory 來建立的暫時佇列之開頭所用的字首。

參考資訊
必要的
資料類型 String

依參照傳遞訊息有效負載

當傳送大型物件訊息或位元組訊息時,為了序列化、解除序列化及複製訊息有效負載,可能會耗用大量的記憶體和處理器成本。 如果您在 Connection Factory 或啟動規格上啟用依參照傳遞訊息有效負載內容,您會通知預設傳訊提供者置換 JMS 1.1 規格,這項資料的複製有可能會縮減或略過。

注意:
定義這些內容所略過的 JMS 規格部分,以確保訊息資料的完整性。 任何使用這些內容的 JMS 應用程式,都必須嚴格遵循「依參照傳遞 JMS 訊息有效負載的原因和時機」主題中所說明的規則,否則,會有喪失資料完整性的風險。

利用這個 Connection Factory 來傳送訊息的應用程式必須遵循下列規則:

  • 應用程式不會修改 JMS 物件訊息所包含的資料物件。
  • 應用程式利用對於 writeBytes(byte[]) 的單一呼叫來移入 JMS 位元組訊息,位元組陣列在訊息內設定之後,應用程式就不會修改它。

如果啟用的話,用這個 Connection Factory 來連接匯流排的訊息生產端應用程式所傳送的物件/位元組訊息,在設定之時,並不會複製它們的資料,系統只在絕對必要之時,才會將訊息資料序列化。 傳送這些訊息的應用程式,在訊息內設定了資料之後,便無法修改資料。

參考資訊
必要的
資料類型 布林

利用這個 Connection Factory 來接收訊息的應用程式必須遵循下列規則:

  • 應用程式不會修改從 JMS 物件訊息取得的資料物件。資料物件是當作唯讀來處理。

如果啟用的話,連接這個 Connection Factory 的訊息消費端應用程式所接收的物件訊息,系統只在絕對必要之時,才會將它們的訊息資料序列化。 應用程式必須將取自這些訊息的資料視為 readOnly。

參考資訊
必要的
資料類型 布林

記載遺漏的交易環境定義

當取得連線時,儲存器是否要記載遺漏了交易環境定義。

Java EE 程式設計模型指示連線應該一律有交易環境定義。 不過,部分應用程式不會正確地有相關的交易環境定義。

請選取這個內容,在沒有交易環境定義的情況下,記載所建立的連線。

參考資訊
必要的
資料類型 布林

管理快取的控點

是否應該由儲存器來追蹤快取控點(保留在 Bean 實例變數中的控點)。

請選取這個選項來追蹤可用於除錯的控點管理。不過,如果在執行時期使用追蹤控點,效能可能會受到很大影響。
參考資訊
必要的
資料類型 布林

與 CMP 共用資料來源

允許在 JMS 和儲存器管理持續性 (CMP) Entity EJB Bean 之間共用連線。

這個選項用在「使儲存器管理持續性 (CMP) Entity Bean 能夠共用傳訊引擎的資料儲存庫所用的資料庫連線」的作業中。 經過評估,這有可能使整體通訊量增進 15% 的效能,不過,只適用於連接至傳訊引擎所在的應用程式伺服器之 Entity Bean。

如需使用這個選項的相關資訊,請參閱「啟用 CMP Entity Bean 和傳訊引擎資料儲存庫以共用資料庫連線」主題。

參考資訊
必要的
資料類型 布林

XA 回復鑑別別名

XA 回復處理期間所用的鑑別別名。

請選取交易回復處理期間所要使用的別名。

這個內容提供已定義給 WebSphere Application Server 的 JCA 鑑別資料項目別名清單。 在 XA 回復處理程序期間,您可以選取要用來鑑別的資料項目別名。

如果您已針對相關聯的服務整合匯流排啟用安全,請選取一個別名,指定在 WebSphere Application Server 的使用者登錄中,用來進行有效 XA 回復的使用者 ID 和密碼。 若有啟用匯流排安全,且要使用 XA 交易,則必須設定這個內容。

參考資訊
必要的
資料類型 下拉清單

對映配置別名

指定這個 Connection Factory 所用之「Java 鑑別和授權服務 (JAAS)」對映配置的對映配置別名。

只有在元件資源參照的 loginConfiguration 不存在時,才會使用這個欄位。元件資源參照的登入配置和相關內容的規格決定了參照鑑別值是儲存器時的儲存器管理鑑別策略。如果指定了 DefaultPrincipalMapping 登入配置,相關內容便是 JAAS - J2C 鑑別資料項目別名。請參閱相關的項目 JAAS - J2C 鑑別資料項目來定義新的別名。

參考資訊
必要的
資料類型 下拉清單
儲存器管理鑑別別名

這個別名指定針對儲存器管理鑑別來鑑別 JMS 提供者連線時所用的使用者 ID 和密碼。 這個設定只有在 res-auth 值是 container,且部署應用程式時未設定鑑別別名時才會使用。

參考資訊
必要的
資料類型 下拉清單

其他內容

連線儲存區內容
選用的連線儲存區設定集。


檔名: SIBJMSQueueConnectionFactory_DetailForm.html