Default messaging provider topic connection factory [設定]

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

  • 資源 -> JMS -> 主題 Connection Factory -> factory_name
  • 資源 -> JMS -> JMS 提供者 -> a_messaging_provider -> [其他內容] 主題 Connection Factory -> factory_name
Use this panel to browse or change the configuration properties of the selected JMS topic connection factory for use with the default messaging JMS provider. These configuration properties control how connections are created to associated JMS topics.

By default, connections created by using this JMS connection factory in the server containers (for example, from an enterprise bean) are pooled by using Java™ Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) connection pooling. You can modify the connection pool settings for this connection factory by selecting Connection pool properties in the Additional properties section of the administrative console panel.

The configuration of a container-managed authentication alias and mapping module on a connection factory are deprecated. You now set these properties in the bindings for the resource reference of the application. If you do not want to modify the bindings for an existing application, locate this connection factory in the J2C panels where you can still find these properties.

「配置」標籤

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

一般內容

範圍

Specifies the highest topological level at which application servers can use this resource object.

Information Value
必要
資料類型 字串

提供者

Specifies a JMS provider, which enables asynchronous messaging based on the Java Message Service (JMS). It provides J2EE connection factories to create connections for specific JMS queue or topic destinations. JMS provider administrative objects are used to manage JMS resources for the associated JMS provider.

Information Value
必要
資料類型 字串

名稱

The required display name for the resource.

Information Value
必要
資料類型 字串

JNDI 名稱

The JNDI name for the resource.

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

Information Value
必要
資料類型 字串

說明

An optional description for the resource.

Information Value
必要
資料類型 文字區

種類

An optional category string to use when classifying or grouping the resource.

Information Value
必要
資料類型 字串

匯流排名稱

這是這個 Connection Factory 用來建立其連線的服務整合匯流排的名稱。
Enter the name of the local bus in situations where an application makes connection to foreign buses.
Information Value
必要
資料類型 自訂

目標

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

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

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

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

Information Value
必要
資料類型 字串

目標類型

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

To specify a non-clustered bus member the Target property must be set to <Node01>.<server1>, for example Node01.server1. For a cluster bus member the Target property must be set to the cluster name.

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

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

目標重要性

For more information about using this property with other connection factory properties for workload management of connections, see the topic Administrative properties for JMS connections to a bus.

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

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

目標入埠傳輸鏈

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

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

提供者端點

您只在有用戶端應用程式是在應用程式伺服器之外執行,或有應用程式在另一 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 內容會控制適當傳訊引擎的選擇及應用程式連接至所選傳訊引擎的方式。
  • 如果沒有提供任何安全認證,則依預設
    • 如果沒有指定 host,會使用 localhost
    • 如果沒有指定 port,會使用埠 7276
    • 如果沒有指定引導通道鏈,會使用稱為 BootstrapBasicMessaging 的引導傳輸鏈
  • 如果已提供安全認證,則依預設
    • 如果沒有指定 host,會使用 localhost
    • 如果沒有指定 port,會使用埠 7286
    • 如果沒有指定引導通道鏈,且埠號等於或大於 7286,會使用稱為 BootstrapSecureMessaging 的引導傳輸鏈
    • 如果未指定引導通道鏈,且埠號落在 7276 - 7285 範圍內,會使用稱為 BootstrapBasicMessaging 的引導傳輸鏈。
[IBM i]Note: 如果是 IBM® i 平台,您必須(至少)將預設主機名稱從 localhost 改成 your.server.name

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

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

Note: 在配置與非預設引導伺服器間的連線時,請指定所需的端點位址值並使用冒號做為分隔字元。
例如:在 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]Note: 如果是 IBM i 平台,您必須(至少)將預設主機名稱從 localhost 改成 your.server.name
port_number
若有指定,則為管理鏈結之遠端系統的下列其中一個傳訊引擎位址:
  • SIB_ENDPOINT_ADDRESS(如果沒有啟用安全的話)
  • 對於安全連線而言,如果啟用安全,就是 SIB_ENDPOINT_SECURE_ADDRESS

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

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

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

已提供下列預先定義的引導傳輸鏈:

BootstrapBasicMessaging
這對應於伺服器傳輸鏈 InboundBasicMessaging (JFAP-TCP/IP)
BootstrapSecureMessaging
這對應於伺服器傳輸鏈 InboundSecureMessaging (JFAP-SSL-TCP/IP)
BootstrapTunneledMessaging
在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱伺服器 -> 伺服器類型 -> WebSphere Application Server -> server_name -> [伺服器傳訊] 傳訊引擎入埠傳輸。)這個傳輸鏈會建立 JFAP 通道,並使用 HTTP 封套。
BootstrapTunneledSecureMessaging
在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱伺服器 -> 伺服器類型 -> WebSphere Application Server -> 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
Information Value
必要
資料類型 文字區

連線近似性

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

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

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

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

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

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

用戶端 ID

Information Value
必要
資料類型 字串

訂閱首頁

如果要使應用程式能夠使用可延續的訂閱,您必須設定這個內容。
Information Value
必要
資料類型 自訂

非持續性訊息可靠性

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

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

可靠非持續性
傳訊引擎停止或失效時捨棄的訊息。

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

確定的持續性
不捨棄訊息。

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

持續訊息可靠性

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

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

可靠非持續性
傳訊引擎停止或失效時捨棄的訊息。

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

確定的持續性
不捨棄訊息。

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

先讀

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

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

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

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

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

暫時主題名稱字首

Information Value
必要
資料類型 字串

共用可延續訂閱

一般而言,每次只有一個階段作業可以有 TopicSubscriber 用於特定的可延續訂閱。 這個內容可讓您置換這個行為,使可延續的訂閱能夠同時有多個消費端。
Information Value
必要
資料類型 下拉清單
範圍
在叢集中
在伺服器叢集中建立連線時,容許共用可延續訂閱。

一律共用
各連線可以共用可延續的訂閱。

絕不共用
各連線絕不共用可延續的訂閱

Pass message payload by reference

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

CAUTION:
定義這些內容所略過的 JMS 規格部分,以確保訊息資料的完整性。 任何使用這些內容的 JMS 應用程式,都必須嚴格遵循「依參照傳遞 JMS 訊息有效負載的原因和時機」主題中所說明的規則,否則,會有喪失資料完整性的風險。
利用這個 Connection Factory 來傳送訊息的應用程式必須遵循下列規則:
  • 應用程式不會修改 JMS 物件訊息所包含的資料物件。
  • 應用程式利用對於 writeBytes(byte[]) 的單一呼叫來移入 JMS 位元組訊息,位元組陣列在訊息內設定之後,應用程式就不會修改它。

Information Value
必要
資料類型 布林
利用這個 Connection Factory 來接收訊息的應用程式必須遵循下列規則:
  • 應用程式不會修改從 JMS 物件訊息取得的資料物件。資料物件是當作唯讀來處理。

Information Value
必要
資料類型 布林

記載遺漏的交易環境定義

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

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

Information Value
必要
資料類型 布林

管理快取的控點

Select this option to track handle management, which can be useful for debugging purposes. However, tracking handles can significantly reduce performance if used at run time.
Information Value
必要
資料類型 布林

與 CMP 共用資料來源

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

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

Information Value
必要
資料類型 布林

XA 回復鑑別別名

Select the alias to be used during transaction recovery processing.

This property provides a list of the J2C authentication data entry aliases that have been defined to WebSphere Application Server. You can select a data entry alias to be used to authenticate during XA recovery processing.

If you have enabled security for the associated service integration bus, select the alias that specifies the user ID and password used for XA recovery that is valid in the user registry for WebSphere Application Server. This property must be set if bus security is enabled and XA transactions are to be used.

Information Value
必要
資料類型 下拉清單

對映配置別名

Specifies the mapping configuration alias for the Java Authentication and Authorization Service (JAAS) mapping configuration that is used by this connection factory.

只有當元件資源參照中缺乏 loginConfiguration 時,才會使用這個欄位。元件資源參照的登入配置和相關內容的規格決定了參照鑑別值是儲存器時的儲存器管理鑑別策略。If the DefaultPrincipalMapping login configuration is specified, the associated property will be a JAAS - J2C authentication data entry alias. See related item JAAS - J2C authentication data entry to define a new alias.

Information Value
必要
資料類型 下拉清單
儲存器管理鑑別別名

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

Information Value
必要
資料類型 下拉清單

其他內容

連線儲存區內容
An optional set of connection pool settings.

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: July 9, 2016 11:10
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=SIBJMSTopicConnectionFactory_DetailForm
檔名:SIBJMSTopicConnectionFactory_DetailForm.html