請使用這個畫面來檢視或變更選取要搭配 WebSphere MQ JMS Provider 使用之 Queue Connection Factory 的配置內容。
這些配置內容會控制如何建立連線來通往相關聯的 JMS Queue Destination。
Queue Connection Factory 用來建立通往 Queue Destination 的 JMS 連線。
Queue Connection Factory 是 WebSphere MQ JMS Provider 所建立的。
WebSphere MQ JMS Provider 的 Queue Connection Factory 有下列內容。
-
名稱
- 用來識別這個 Queue Connection Factory,供 IBM WebSphere Application Server 內管理作業使用的名稱。在跨越 WebSphere 管理領域的 JMS Connection Factory 內,這個名稱必須是唯一的。
-
JNDI 名稱
- 將 Connection Factory 連結至應用程式伺服器名稱空間時所用的 JNDI 名稱。
請依照慣例使用完整的 JNDI 名稱;比方說,在 jms/Name 格式中,Name 是資源的邏輯名稱。
這個名稱用來鏈結平台的連結資訊。
連結會將模組部署描述子所定義的資源關聯到由平台連結至 JNDI 內的實際(實體)資源。
-
說明
- 這個 Connection Factory 的說明,供 IBM WebSphere Application Server 內管理作業使用。
-
種類
- 就您的 IBM WebSphere Application Server 管理記錄,用來分類或分組這個 Connection Factory 的種類。
-
內容管理鑑別別名
- 這個別名指定使用者 ID 和密碼以便針對應用程式管理鑑別來鑑別 JMS 提供者的連線。
這個內容提供已定義給 WebSphere Application Server 的 J2C 鑑別資料項目別名清單。您可以選取一個資料項目別名來鑑別到 JMS 提供者的新連線。
如果您已啟用 WebSphere Application Server 廣域安全,請選取一個指定使用者 ID 和密碼的別名來鑑別到 JMS 提供者的新連線。
這個別名的使用,是根據應用程式元件部署描述子的 Connection Factory 資源參照中所宣告的資源鑑別 (res-auth) 設定而定。
附註:
- 使用者 ID 若超過 12 字元就無法與內嵌的 WebSphere JMS Provider 一起用於鑑別。
比方說,預設的 Windows NT 使用者 ID Administrator 就無效,內嵌的 WebSphere 傳訊不能用它,因為它包含 13 個字元。
因此,WebSphere JMS Provider Connection Factory 的鑑別別名必須指定少於 12 個字元的使用者 ID。
- 如果在使用連結傳輸模式時,您要使用 WebSphere MQ JMS Provider JMS 連線,請在 WebSphere MQ Queue Connection Factory 中設定傳輸類型=BINDINGS 這個內容。
您也必須選擇下列選項之一:
- 如果要使用安全憑證,請確定指定的使用者是 WebSphere Application Server 程序目前的登入使用者。
如果指定的使用者不是 WebSphere Application Server 程序目前的登入使用者,WebSphere MQ JMS 連結鑑別會擲出下列錯誤:"MQJMS2013 提供給 MQQueueManager 的安全鑑別無效"。
- 不指定安全憑證。
在 WebSphere MQ Connection Factory 中,確定沒有設定元件管理的鑑別別名和儲存區管理的鑑別別名這兩個內容。
-
儲存區管理鑑別別名
- 這個別名指定使用者 ID 和密碼以便針對儲存區管理來鑑別 JMS 提供者的連線。
這個內容提供已定義給 WebSphere Application Server 的 J2C 鑑別資料項目別名清單。您可以選取一個資料項目別名來鑑別到 JMS 提供者的新連線。
如果您已啟用 WebSphere Application Server 廣域安全,請選取一個指定使用者 ID 和密碼的別名來鑑別到 JMS 提供者的新連線。
這個別名的使用,是根據應用程式元件部署描述子的 Connection Factory 資源參照中所宣告的資源鑑別 (res-auth) 設定而定。
附註:
- 使用者 ID 若超過 12 字元就無法與內嵌的 WebSphere JMS Provider 一起用於鑑別。
比方說,預設的 Windows NT 使用者 ID Administrator 就無效,內嵌的 WebSphere 傳訊不能用它,因為它包含 13 個字元。
因此,WebSphere JMS Provider Connection Factory 的鑑別別名必須指定少於 12 個字元的使用者 ID。
- 如果在使用連結傳輸模式時,您要使用 WebSphere MQ JMS Provider JMS 連線,請在 WebSphere MQ Queue Connection Factory 中設定傳輸類型=BINDINGS。
您也必須選擇下列選項之一:
- 如果要使用安全憑證,請確定指定的使用者是 WebSphere Application Server 程序目前的登入使用者。
如果指定的使用者不是 WebSphere Application Server 程序目前的登入使用者,WebSphere MQ JMS 連結鑑別會擲出下列錯誤:"MQJMS2013 提供給 MQQueueManager 的安全鑑別無效"。
- 不指定安全憑證。
在 WebSphere MQ Connection Factory 中,確定元件管理的鑑別別名和儲存區管理的鑑別別名兩者都沒有設定。
-
佇列管理程式
- 這個 Connection Factory 的 WebSphere MQ 佇列管理程式的名稱。
這個 Factory 所建立的連線會連接至該佇列管理程式。
| 資料類型 |
字串 |
| 預設值 |
空值 |
| 範圍 |
有效的 WebSphere MQ 佇列管理程式名稱,1 至 48 個 ASCII 字元
|
-
主機
- WebSphere MQ 佇列管理程式執行其中的主機名稱,只供用戶端連線使用。
| 資料類型 |
字串 |
| 預設值 |
空值 |
| 範圍 |
有效 TCP/IP 主機名稱 |
-
埠
- 通往 WebSphere MQ 佇列管理程式的連線所用的 TCP/IP 埠號,只供用戶端連線使用。
這個埠必須配置在 WebSphere MQ 佇列管理程式中。
| 資料類型 |
整數 |
| 預設值 |
空值 |
| 範圍 |
有效的 TCP/IP 埠號,必須配置在 WebSphere MQ 佇列管理程式中。 |
-
通道
- 通往 WebSphere MQ 佇列管理程式的連線所用的通道名稱,只供用戶端連線使用。
| 資料類型 |
字串 |
| 預設值 |
空值 |
| 範圍 |
1 至 20 個 ASCII 字元 |
-
傳輸類型
- 指定要利用 WebSphere MQ 用戶端連線或 JNI 連結來連接 WebSphere MQ 佇列管理程式。
外部 JMS 提供者會控制 JMS 用戶端和 JMS 伺服器之間的通訊協定。
當您使用非 ASF 非持續性、不可延續的非交易式傳訊時,或當您要滿足安全問題且用戶端在佇列管理程式節點的本端時,請調整傳輸類型。
| 資料類型 |
列舉 |
| 單位 |
不適用 |
| 預設值 |
BINDINGS |
| 範圍 |
-
BINDINGS
- 利用 JNI 連結來連接佇列管理程式。
BINDINGS 是共用記憶體通訊協定,佇列管理程式必須在 JMS 用戶端的相同節點中才能使用它,它會帶來必須利用 EJB 角色來解決的安全風險。
如果在使用連結傳輸模式時,您要使用 WebSphere MQ JMS Provider JMS 連線,請在 WebSphere MQ Queue Connection Factory 中設定傳輸類型=BINDINGS。
您也必須選擇下列選項之一:
- 如果要使用安全憑證,請確定指定的使用者是 WebSphere Application Server 程序目前的登入使用者。
如果指定的使用者不是 WebSphere Application Server 程序目前的登入使用者,WebSphere MQ JMS 連結鑑別會擲出下列錯誤:"MQJMS2013 提供給 MQQueueManager 的安全鑑別無效"。
- 不指定安全憑證。
在 WebSphere MQ Connection Factory 中,確定元件管理的鑑別別名和儲存區管理的鑑別別名兩者都沒有設定。
-
CLIENT
- 利用 WebSphere MQ 用戶端連線來連接佇列管理程式。CLIENT 是典型的 TCP 型通訊協定。
-
DIRECT
- 適用於使用 DIRECT 模式的 WebSphere MQ Event Broker。
DIRECT 是非交易式、不可延續和非持續性的發佈/訂閱傳訊所用的小型 Socket 通訊協定。
DIRECT 只適用於使用非 ASF 通訊協定的用戶端和訊息驅動 Bean。
-
QUEUED
- QUEUED 是標準 TCP 通訊協定。
|
| 建議
|
-
Queue Connection Factory 傳輸類型
- BINDINGS 的速度快了 30% 或更多,但比較不安全。
如果您有安全考量,BINDINGS 比 CLIENT 適合。
-
Topic Connection Factory 傳輸類型
- DIRECT 的速度最快,應該儘可能使用它。
當您要滿足其他安全作業,且佇列管理程式在 JMS 用戶端本端時,請使用 BINDINGS。
在所有其他情況下,QUEUED 都是倒退的。
請注意,當使用訊息驅動 Bean 且在負荷狀態下,在 CSD2 之前使用 DIRECT 設定的 WebSphere MQ 5.3 可能會遺失訊息。
除非分配管理系統的 maxClientQueueSize 設為 0,否則,用戶端型的應用程式也會發生這個情況。
您可以利用 #wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID 指令,將這個值設為 0;
您可以啟動分配管理系統,查看事件日誌/應用程式來找出事件 2201,以取得其中的 executionGroupUUID。
這個值通常是 ffffffff-0000-0000-000000000000。
|
-
模型佇列定義
- 當要求的佇列不存在時,佇列管理程式可用來建立暫時佇列的模型佇列定義名稱。
| 資料類型 |
字串 |
| 預設值 |
空值 |
| 範圍 |
1 至 48 個 ASCII 字元
|
-
用戶端 ID
- 通往 MQSeries MQ 佇列管理程式的連線所用的 JMS 用戶端 ID。
-
CCSID
- 供 WebSphere MQ 佇列管理程式使用的編碼字集 ID。
這個編碼字集 ID (CCSID) 必須是 WebSphere MQ 所支援的 CCSID 之一。
| 資料類型 |
字串 |
| 單位 |
整數 |
| 預設值 |
空值 |
| 範圍 |
1 至 65535 個字元 |
如果需要支援的 CCSID 和不同編碼字集間之訊息轉換的詳細資訊,請參閱 WebSphere MQ System Administration 和 WebSphere MQ Application Programming Reference 等書。
請從 WebSphere MQ 傳訊多重平台和特定平台叢書網頁中找到這些書;
比方說,從
http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html
、
IBM Publications Center
取得,或從 WebSphere MQ Collection Kit (SK2T-0730) 取得。
-
訊息保留
- 請選取這個勾選框來指定將不要的訊息保留在佇列中。
否則,會根據不要的訊息本身的佈署選項來處理這些訊息。
| 資料類型 |
列舉 |
| 單位 |
不適用 |
| 預設值 |
已清除
|
| 範圍 |
-
已選取
- 將不要的訊息保留在佇列中。
-
已清除
- 根據不要的訊息本身的佈署選項來處理這些訊息。
|
-
已啟用 XA
- 指定 Connection Factory 要用在訊息的 XA 或非 XA 協調上,以及控制應用程式伺服器要不要使用 XA QCF/TCF。
如果不會在相同交易中使用多重資源,請啟用 XA。
如果您將這個內容設為 NON_XA,JMS 階段作業仍會列在交易中,但它會使用資源管理程式本端交易呼叫(session.commit 和 session.rollback),而不是 XA 呼叫。
此舉可以提升效能。
但是,這也表示只有一個資源可以列在 WebSphere Application Server 的交易中。
WebSphere Application Server Enterprise 中的最後一個參與者支援,可讓您將一個非 XA 資源與其他 XA 相容資源列在一起。
如果 WebSphere Topic Connection Factory 將 Port 內容設為 DIRECT,便不會套用這個內容,而且其值一定是 NON_XA。
| 資料類型 |
列舉 |
| 單位 |
不適用 |
| 預設值 |
已啟用 XA |
| 範圍 |
-
XA
- Connection Factory 供訊息的 XA 協調使用
-
NON_XA
- Connection Factory 供訊息的非 XA 協調使用
|
| 建議
|
當收到的訊息佇列或主題是交易中的唯一資源時,請勿啟用 XA。
當涉及包括其他佇列或主題在內的其他資源時,請啟用 XA。
|
-
連線儲存池
- 指定一組選用的連線儲存池設定。
所有 J2C 連接器會共用連線儲存池內容。
應用程式伺服器會將連線和階段作業與 JMS 提供者置於儲存池中,來提高效能。
此舉與任何 WebSphere MQ 連線儲存池作業無關。
您必須針對您的應用程式,來配置連線和階段作業儲存池內容,否則可能不會得到您所要的連線和階段作業行為。
如果 JMS 資源的並行伺服器端存取作業超出預設值,請變更連線儲存池的大小。連線儲存池大小是以個別佇列或主題為基礎來設定的。
請參閱下表,以取得詳細資料。
-
階段作業儲存池
- 一組選用的階段作業儲存池設定。
這個鏈結提供鏈結至所有 J2C 連接器共用的選用連線儲存池內容的畫面。
應用程式伺服器會將連線和階段作業與 JMS 提供者置於儲存池中,來提高效能。
此舉與任何 WebSphere MQ 連線儲存池作業無關。
您必須針對您的應用程式,來配置連線和階段作業儲存池內容,否則可能不會得到您所要的連線和階段作業行為。
-
自訂內容
- 這是一組傳給 WebSphere MQ 的選用自訂內容名稱值配對。
您可以利用「自訂內容」頁面來定義下列 Secure Socket Layer (SSL) 內容。
只有在設定了傳輸類型=CLIENT 這個內容時,這些內容才適用。
如果需要設定這些內容的詳細資訊,請參閱 WebSphere MQ Using Java 一書中的 SSL properties 一節。