Default messaging provider unified connection factory [設定]
如果要在主控台中檢視這個頁面,請按下列其中一個路徑:
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 connection factory properties influence how the default messaging provider chooses the messaging engine to which your JMS application connects. 依預設,環境會自動將應用程式連接到匯流排上可用的傳訊引擎。 不過,您可以指定額外的配置詳細資料來影響連線程序;比方說,識別特殊的引導伺服器,或是限制只能連線到某些可用傳訊引擎的子群組,或改進可用性或效能,或確保收到之訊息的循序處理。 For information about how to do this, see the topic Configuring the messaging engine selection process for JMS applications.
「配置」標籤
「配置」標籤顯示這個物件的配置內容。 這些內容會保留下來,即使停止並重新啟動執行時期環境也一樣。請參閱資訊中心作業說明,以取得如何將配置變更套用於執行時期環境的相關資訊。
一般內容
範圍
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.
Information | Value |
---|---|
必要 | 是 |
資料類型 | 字串 |
說明
An optional description for the resource.
Information | Value |
---|---|
必要 | 否 |
資料類型 | 文字區 |
種類
An optional category string to use when classifying or grouping the resource.
Information | Value |
---|---|
必要 | 否 |
資料類型 | 字串 |
匯流排名稱
Information | Value |
---|---|
必要 | 是 |
資料類型 | 自訂 |
目標
在執行連線近似性搜尋來選取適當的傳訊引擎之前,會先選取本身是指定目標群組成員的一組傳訊引擎。之後,會將連線近似性搜尋限制於這些傳訊引擎中。 如果未指定目標群組(預設值),在連線近似性搜尋期間會考量匯流排中的所有傳訊引擎。
比方說,如果將 目標類型 內容設為 匯流排成員名稱,則 目標 內容指定可從中選擇合適傳訊引擎的匯流排成員名稱。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 字串 |
目標類型
Information | Value |
---|---|
必要 | 否 |
資料類型 | 下拉清單 |
範圍 |
|
目標重要性
Information | Value |
---|---|
必要 | 否 |
資料類型 | 下拉清單 |
範圍 |
|
目標入埠傳輸鏈
這些傳輸鏈指定可用來與用戶端應用程式連接之應用程式伺服器通訊的通訊協定。
如果所選傳訊引擎位於應用程式所在相同伺服器,則會進行直接的進行中連線,且會忽略這個傳輸鏈內容。
- InboundBasicMessaging
- 這是一個使用標準 TCP/IP 連線 (JFAP-TCP/IP) 的連線導向通訊協定。它支援兩段式交易 (遠端 XA) 流程,所以在用戶端或伺服器系統上執行的訊息生產者或消費者,都可以參與該用戶端或伺服器系統所管理的廣域交易。 XA 流程的特定用途,是支援從執行於某伺服器的應用程式存取在第二部伺服器上的傳訊引擎,原因可能是第一部伺服器沒有適當的傳訊引擎。 如果使用遠端 XA 流程,應用程式必須能夠在本端使用交易協調程式。
- InboundSecureMessaging
- 這是包裝在 SSL 中的 InboundBasicMessaging 通訊協定。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 字串 |
提供者端點
您只在有用戶端應用程式是在應用程式伺服器之外執行,或有應用程式在另一 Cell 中的伺服器上,想利用這個 Connection Factory 來連接 Connection Factory 上所指定的目標服務整合匯流排時,才需修改這個內容。
如果要使用預設傳訊提供者的 JMS 目的地,應用程式會連接至目的地所指派的目標服務整合匯流排中的傳訊引擎。比方說,JMS 佇列會指派給服務整合匯流排中的佇列目的地。
在應用程式伺服器之外執行(例如:在用戶端儲存器中執行或在 WebSphere Application Server 環境之外執行)的用戶端應用程式,無法在目標匯流排中直接找到適合連接的傳訊引擎。 同樣地,在 Cell 內某部伺服器中執行,且要連接到另一個 Cell 中之目標匯流排的應用程式,也無法在目標匯流排中直接找到要連接的適當傳訊引擎。
在這些實務中,用戶端(或另一個匯流排中的伺服器)必須利用本身是目標匯流排成員的引導伺服器來完成引導程序。 引導伺服器是執行「SIB 服務」,但不需要執行任何傳訊引擎的應用程式伺服器。 引導伺服器會選取在支援所需目標傳輸鏈的應用程式伺服器中執行的傳訊引擎。 為了能夠採行引導程序,您必須在用戶端所用的 Connection Factory 中配置一或多個提供者端點。
引導伺服器會使用特定之埠和引導傳輸鏈。這個埠是管理鏈結遠端系統之傳訊引擎的 SIB_ENDPOINT_ADDRESS(如果啟用安全,就是 SIB_ENDPOINT_SECURE_ADDRESS)。當配上主機名稱時,即構成引導伺服器的端點位址。
- 如果沒有提供任何安全認證,則依預設
- 如果沒有指定 host,會使用 localhost
- 如果沒有指定 port,會使用埠 7276
- 如果沒有指定引導通道鏈,會使用稱為 BootstrapBasicMessaging 的引導傳輸鏈
- 如果已提供安全認證,則依預設
- 如果沒有指定 host,會使用 localhost
- 如果沒有指定 port,會使用埠 7286
- 如果沒有指定引導通道鏈,且埠號等於或大於 7286,會使用稱為 BootstrapSecureMessaging 的引導傳輸鏈
- 如果未指定引導通道鏈,且埠號落在 7276 - 7285 範圍內,會使用稱為 BootstrapBasicMessaging 的引導傳輸鏈。
![[IBM i]](../images/iseries.gif)
如果您要應用程式使用含不同端點位址的引導伺服器,您必須在用戶端應用程式所用的 JMS Connection Factory 的 Provider endpoints 內容上,指定必要的端點位址。 您可以指定引導伺服器的一或多個端點位址。
在應用程式伺服器之外的應用程式所用的每個 JMS Connection Factory 都必須指定引導伺服器的端點位址。 如果要避免指定太長的引導伺服器清單,您可以提供少數具有高可用性的伺服器來作為專用的引導伺服器。 之後,您只需要在每個 Connection Factory 上指定一份短的引導伺服器清單。
boothost1:7278:BootstrapBasicMessaging
or
boothost1:7278
在 boothost2 主機上,有一個伺服器指派了安全埠號 7289,所用的預先定義傳輸鏈為 BootstrapTunneledSecureMessaging:
boothost2:7289:BootstrapTunneledSecureMessaging
[ [host_name] [ ":" [port_number] [ ":" chain_name] ] ]
其中:- host_name
- 伺服器執行所在的主機名稱。可以是 IP 位址。若為 IPv6 位址,請按如下所示,用方括弧 ([]) 括住 host_name:
. 如果未指定一值,預設值為 localhost。[2002:914:fc12:179:9:20:141:42]:7276:BootstrapBasicMessaging
Note: 如果是 IBM i 平台,您必須(至少)將預設主機名稱從 localhost 改成 your.server.name。
- port_number
- 若有指定,則為管理鏈結之遠端系統的下列其中一個傳訊引擎位址:
- SIB_ENDPOINT_ADDRESS(如果沒有啟用安全的話)
- 對於安全連線而言,如果啟用安全,就是 SIB_ENDPOINT_SECURE_ADDRESS。
如果未指定 port_number,則預設值為 7276。
如果要利用管理主控台來尋找任何這些值,請按一下。
- chain_name
- 連接引導伺服器時所用之預先定義的引導傳輸鏈名稱。如果未指定,預設值為 BootstrapBasicMessaging。
已提供下列預先定義的引導傳輸鏈:
- BootstrapBasicMessaging
- 這對應於伺服器傳輸鏈 InboundBasicMessaging (JFAP-TCP/IP)
- BootstrapSecureMessaging
- 這對應於伺服器傳輸鏈 InboundSecureMessaging (JFAP-SSL-TCP/IP)
- BootstrapTunneledMessaging
- 在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱。)這個傳輸鏈會建立 JFAP 通道,並使用 HTTP 封套。
- BootstrapTunneledSecureMessaging
- 在使用這個引導傳輸鏈之前,您必須先在引導伺服器上定義一個對應的伺服器傳輸鏈。 (請參閱。)這個傳輸鏈會建立 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 |
---|---|
必要 | 否 |
資料類型 | 自訂 |
非持續性訊息可靠性
Information | Value |
---|---|
必要 | 否 |
資料類型 | 下拉清單 |
範圍 |
|
持續訊息可靠性
Information | Value |
---|---|
必要 | 否 |
資料類型 | 下拉清單 |
範圍 |
|
先讀
指派給消費者的訊息已在伺服器上鎖定,而該目的地的任何其他消費者都無法使用那些訊息。指派給消費者的訊息,如果在這個消費者關閉之前都未使用,之後便會在伺服器中解開鎖定,任何其他消費者都可以接收它。
您可以設定個別 JMS 目的地的 Read ahead 內容來置換 JMS 目的地的這個內容。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 下拉清單 |
範圍 |
|
暫時佇列名稱字首
Information | Value |
---|---|
必要 | 否 |
資料類型 | 字串 |
暫時主題名稱字首
Information | Value |
---|---|
必要 | 否 |
資料類型 | 字串 |
Pass message payload by reference
當傳送大型物件訊息或位元組訊息時,為了序列化、解除序列化及複製訊息有效負載,可能會耗用大量的記憶體和處理器成本。 如果您在 Connection Factory 或啟動規格上啟用 pass message payload by reference 內容,您會通知預設傳訊提供者置換 JMS 1.1 規格,這項資料的複製有可能會縮減或略過。
利用這個 Connection Factory 來傳送訊息的應用程式必須遵循下列規則:
- 應用程式不會修改 JMS 物件訊息所包含的資料物件。
- 應用程式利用對於 writeBytes(byte[]) 的單一呼叫來移入 JMS 位元組訊息,位元組陣列在訊息內設定之後,應用程式就不會修改它。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 布林 |
利用這個 Connection Factory 來接收訊息的應用程式必須遵循下列規則:
- 應用程式不會修改從 JMS 物件訊息取得的資料物件。資料物件是當作唯讀來處理。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 布林 |
記載遺漏的交易環境定義
請選取這個內容,在沒有交易環境定義的情況下,記載所建立的連線。
Information | Value |
---|---|
必要 | 否 |
資料類型 | 布林 |
管理快取的控點
Information | Value |
---|---|
必要 | 否 |
資料類型 | 布林 |
XA 回復的鑑別別名
Specifies the alias that the connection factory uses to authenticate with the EIS for transaction recovery.
This property provides a list of the JCA 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.