IBM MQ 傳訊提供者 Connection Factory 設定

請利用這個畫面，來檢視或變更所選 Connection Factory 的配置內容，以便搭配使用 WebSphere® MQ 傳訊提供者。這些配置內容會控制如何建立連線來通往相關聯的 JMS 佇列和主題。

IBM MQ 傳訊提供者支援 JMS 1.1 不關聯於特定網域的介面，例如：統一 JMS Connection Factory。不關聯於特定網域的應用程式可以使用相同的介面進行點對點傳訊和發佈/訂閱傳訊，也可以在相同交易內支援點對點傳訊和發佈/訂閱傳訊。當使用 JMS 1.1 時，建議將不關聯於特定網域的統一 JMS Connection Factory 用於新應用程式。網域特定介面延伸了不關聯於特定網域的對等項目，因此使用網域特定 Queue Connection Factory 和 Topic Connection Factory 的應用程式，可以選擇使用任一介面。

如果要檢視 IBM MQ Connection Factory 設定，請利用管理主控台來完成下列步驟：

在導覽窗格中，按一下資源 > JMS->Connection Factory 來顯示現有 Connection Factory。
適當的話，在內容窗格中，將範圍設定改成定義 Connection Factory 的層次。這會限制所顯示的 Connection Factory 集。
選取您要使用的 Connection Factory 的名稱。

在「一般內容」之下，有四個內容群組：

管理
連線
進階
安全設定

請先進行「管理」、「連線」、「進階」和「安全」等內容設定群組的任何必要變更，按一下套用來儲存配置，然後才在「其他內容」之下的內容窗格中，按下列任何鏈結：

進階內容，顯示或變更 IBM MQ Connection Factory 的進階內容。
分配管理系統內容，顯示或變更 IBM MQ Connection Factory 的分配管理系統內容。
自訂內容，顯示或變更 IBM MQ Connection Factory 的自訂內容。
用戶端傳輸內容，顯示或變更 IBM MQ Connection Factory 的用戶端傳輸內容。如果所選 Connection Factory 不是利用「用戶端通道定義表 (Client Channel Definition Table, CCDT)」來建立的，請遵循此鏈結來輸入連接 IBM MQ 的所有必要資訊。如果所選 Connection Factory 是利用 CCDT 來建立的，則您不需要提供用戶端傳輸內容，因此不會出現鏈結。
連線儲存區，顯示或變更 IBM MQ Connection Factory 的連線儲存區詳細資料。
階段作業儲存區，顯示或變更 IBM MQ Connection Factory 的階段作業儲存區詳細資料。

在「相關項目」之下，您可以按一下 JAAS - J2C 鑑別資料來配置搭配 Connection Factory 使用的鑑別資訊。

您可以使用 IBM MQ 管理指令，來指定下列其他內容：

-localAddress
-clonedSubs
-componentAuthAlias

如需這些內容的相關資訊，請參閱 createWMQConnectionFactory 指令。

註：當指定 IBM MQ 內容時，適用下列限制：

名稱最多可有 48 個字元，但通道例外，它最多只能有 20 個字元。
您指定的內容值必須符合在配置 IBM MQ 的 JMS 資源時所指定的值。如需配置 IBM MQ JMS 資源的相關資訊，請參閱 IBM MQ 資訊中心的使用 Java 和 IBM MQ 系統管理區段。

如果 IBM MQ 功能的停用範圍會影響此 IBM MQ 傳訊提供者資源，則會出現一則參考訊息，指出 IBM MQ 已停用。在單一伺服器環境中，於停用 IBM MQ 功能之後重新啟動伺服器時，才會顯示此參考訊息。在網路部署環境中，會立即顯示參考訊息。如需相關資訊，請參閱在 WebSphere Application Server 中停用 IBM MQ 功能。

IBM MQ Unified Connection Factory 的內容如下。

管理

範圍

應用程式能夠見到這個 Connection Factory 定義的層次。

傳訊提供者、名稱空間連結或共用程式庫之類的資源可以定義在多個範圍，定義在較明確範圍的資源會改寫定義在較一般範圍的複本。

顯示的範圍只供參考，無法在這個畫面中改變。如果您要瀏覽或變更不同範圍的其他資源，請在 Connection Factory 集合畫面中變更範圍，然後按一下套用，之後再按一下資源類型的鏈結。

參考資訊	值
資料類型	String

提供者

建立 Queue Connection Factory 時，所指派的 JMS 提供者。

對於所有使用這個畫面的 Connection Factory，提供者都是 IBM MQ 傳訊提供者。

顯示提供者，只供參考。

參考資訊	值
資料類型	String

名稱

這個 Connection Factory 在 WebSphere Application Server 中的識別名稱，以作為管理之用。

參考資訊	值
資料類型	String
範圍	在定義於 Cell 的這組 Connection Factory 中，這個名稱必須是唯一的。

JNDI 名稱

用來將 Connection Factory 連結到 JNDI 名稱空間的 JNDI 名稱。

請依照慣例使用完整的 JNDI 名稱；比方說，在 jms/Name 格式中，Name 是資源的邏輯名稱。

參考資訊	值
資料類型	String

說明

這個 Connection Factory 在 WebSphere Application Server 中的說明，以作為管理之用。

參考資訊	值
資料類型	String
預設值	空值

連線

配置連線所需的資訊，視所選 Queue Connection Factory 是否為利用「用戶端通道定義表 (CCDT)」所建立的而定。

如果所選 Connection Factory 是利用 CCDT 來建立的，則只會顯示下列內容：

用戶端通道定義表 URL
佇列管理程式
SSL 配置

如果所選 Connection Factory 不是利用 CCDT 來建立的，則會顯示下列內容：

佇列管理程式
傳輸
如果選取以個別的主機和埠值格式來輸入主機和埠資訊，則無法使用連線名稱清單內容，但可以使用下列內容：
- 主機名稱
- 埠
如果選取以連線名稱清單格式來輸入主機和埠資訊，則可以使用連線名稱清單內容，但無法使用下列內容：
- 主機名稱
- 埠
伺服器連線通道
如果您清除利用 SSL 來維護 IBM MQ 通訊安全性的勾選框，便無法使用下列內容：
- 集中管理
- 特定配置
- SSL 配置

如需設定 IBM MQ SSL 內容的相關資訊，請參閱 IBM MQ 資訊中心之使用 Java 區段中的 SSL 內容。

用戶端通道定義表 URL

指定 IBM MQ CCDT 之位置的 URL。

參考資訊	值
資料類型	String

佇列管理程式

如果指定的 Connection Factory 是以 CCDT 為基礎，這個內容便會用來選取 CCDT 中的項目。否則，這個內容是指定所要連接的佇列管理程式名稱或佇列共用群組名稱。建立指向這個 IBM MQ 資源的連線，以便傳送或接收訊息。

參考資訊

值

資料類型

String

範圍

如果這個 Connection Factory 不是以 CCDT 為基礎，這個值必須是有效的佇列管理程式名稱。

如果這個 Connection Factory 是以 CCDT 為基礎，這個值必須是下列其中一個項目：

有效的佇列管理程式名稱
星號 (*) 後面加上佇列管理程式名稱¹
星號 (*)
空白¹

¹當您在這個表單中，指定「佇列管理程式」內容值，來搭配使用 CCDT 時，以 Connection Factory 建立的個別連線可能會連接不同的佇列管理程式。當 CCDT 包含多個用戶端連線通道定義以及一個相符的佇列管理程式名稱 (QMNAME) 參數，且這些連線通道定義針對不同的佇列管理程式定義了網路連線詳細資料，就會從多個佇列管理程式中選取。

如果指定的 Connection Factory 是以 CCDT 為基礎，且 CCDT 可以從多個佇列管理程式中選取，您可能無法回復廣域交易。因此，對於指定 CCDT 的 Connection Factory，您有兩種替代方案可選：

指定「佇列管理程式」內容時，避免目標佇列管理程式語義不明確，也就是說，指定給這個內容的值不得包含星號 (*)。
資源避免和列在廣域交易中的應用程式搭配使用。

傳輸

IBM MQ 連線傳輸類型。傳輸類型用來決定連接 IBM MQ 時所用的確切機制。

參考資訊	值
資料類型	下拉清單
預設值	先連結，後用戶端
範圍	用戶端利用 TCP/IP 型網路連線，與 IBM MQ 佇列管理程式通訊。先連結，後用戶端嘗試佇列管理程式的連結模式連線。如果不可能，便回復透過用戶端傳輸。連結建立交叉記憶體連線來連接執行於相同節點的佇列管理程式。停用下列用戶端傳輸模式內容：主機名稱埠連線名稱清單伺服器連線通道如需配置`先連結，後用戶端`或`連結`傳輸類型的相關資訊，請參閱以原生程式庫資訊配置 IBM MQ 傳訊提供者。

以個別的主機和埠值格式來輸入主機和埠資訊

如果選取這個圓鈕，則表示使用主機名稱和埠內容所提供的資訊，來建立 IBM MQ 佇列管理程式連線。

選取這個選項會啟用主機名稱和埠內容，並且停用連線名稱清單內容。如果要輸入連線名稱清單資訊，請按一下以連線名稱清單格式來輸入主機和埠資訊。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個圓鈕。

參考資訊	值
資料類型	圓鈕

主機名稱

要連接的 IBM MQ 佇列管理程式的主機名稱、IPv4 或 IPv6 位址。

參考資訊	值
資料類型	String

埠

IBM MQ 用來接聽的埠號。

參考資訊	值
資料類型	Integer
預設值	1414
範圍	這個值必須在 1-65535 的範圍中（頭尾包括在內）。

以連線名稱清單格式來輸入主機和埠資訊

如果選取這個圓鈕，則表示使用連線名稱清單內容所提供的資訊，來建立 IBM MQ 佇列管理程式連線。

連線名稱清單可用來連接單一佇列管理程式或多重實例的佇列管理程式。如需使用多重實例佇列管理程式的相關資訊，請參閱 IBM MQ 資訊中心。選取這個選項會啟用連線名稱清單內容，並且停用主機名稱和埠內容。如果要輸入個別的主機和埠資訊，請按一下以個別的主機和埠值格式來輸入主機和埠資訊。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個圓鈕。

參考資訊	值
資料類型	圓鈕

連線名稱清單

當您希望 Connection Factory 連接多重實例的佇列管理程式時，要使用的連線名稱清單，且其中指定主機名稱和埠的詳細資料。

這個內容只能用來容許連接多重實例的佇列管理程式。不得用來容許連接非多重實例的佇列管理程式，否則可能導致交易完整性問題。

參考資訊

值

資料類型

String

預設值

未設定

範圍

必須以下列格式，將這個欄位設定成字串：

host[(port)][,host(port)]

埠資訊是選用的，如果沒有指定，則預設值為 1414。

host 必須是有效的 TCP/IP 主機名稱，或是 IPv4 或 IPv6 位址。

port 必須是 1 到 65536（頭尾包括在內）範圍中的整數值。

例如 localhost(1234),remotehost1(1234),remotehost2

如果指定連線名稱清單內容，會自動將主機名稱或埠內容設為連線名稱清單中之第一項的主機名稱和埠號。因此，如果您指定 localhost(1234),remotehost1(1234),remotehost2，主機名稱會設為 localhost，埠會設為 1234。

只有在範圍內容指定 Cell 或叢集，或是範圍內容指定正在執行 WebSphere Application Server 8.0 版或更新版本的節點或伺服器時，才能使用這個內容。

如果是在混合 Cell 環境中使用，8.0 版之前的 WebSphere Application Server 版本無法使用連線名稱清單內容中的資訊。在此情況下，會根據連線名稱清單中的第一個元素，改用主機名稱和埠名稱欄位中的資訊。

伺服器連線通道

當連接至 IBM MQ 時，所用的 IBM MQ 伺服器連線通道名稱。

參考資訊	值
資料類型	String
預設值	SYSTEM.DEF.SVRCONN
範圍	這個值必須是定義於所連接之 IBM MQ 佇列管理程式的伺服器連線通道。

利用 SSL 來維護與 IBM MQ 的通訊安全

這個選項決定是否利用 SSL (Secure Socket Layer) 來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全。

當在應用程式伺服器環境中使用 IBM MQ 傳訊提供者 Connection Factory 時，應用程式伺服器會管理 SSL 配置。如果要變更 SSL 配置參數，請利用管理主控台，導覽至安全 > SSL 憑證和金鑰管理畫面。

當在用戶端環境中使用 IBM MQ 傳訊提供者 Connection Factory 時，用戶端會從 ssl.client.props 檔中取得 SSL 配置資訊。請參閱這個主題的相關參照資訊，以取得如何使用這個檔案的詳細說明。

在 IBM MQ 傳訊提供者 Connection Factory 的 SSL 配置中，您只能使用一個密碼組合。如果您指定了多個密碼組合，只會使用第一個。

參考資訊	值
資料類型	勾選框。如果清除這個勾選框，會停用下列 SSL 內容：集中管理特定配置 SSL 配置

集中管理

當利用 SSL 通訊協定來與 IBM MQ 通訊時，請選取這個圓鈕來指定 SSL 配置是取自集中管理的 WebSphere Application Server SSL 配置。

當您選取這個圓鈕時，會利用 IBM MQ 傳訊提供者 Connection Factory 中的主機名稱和埠屬性，來選取適當的 SSL 配置。如果由連線名稱清單提供主機和埠資訊，則表示使用清單中第一個元素的主機名稱和埠資訊，來選取適當的 SSL 配置。如果要提供將符合 Connection Factory 的 SSL 配置，請參閱相關參照之下所列的「動態出埠端點 SSL 配置設定」主題。

參考資訊	值
資料類型	圓鈕

特定配置

當您想要指定利用 SSL 來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全時，所用的特定 SSL 配置，請選取這個圓鈕。

參考資訊	值
資料類型	圓鈕

SSL 配置

當利用 SSL 來維護與 IBM MQ 佇列管理程式或佇列共用群組的網路通訊安全時，所用的 SSL 配置。

如果選取集中管理圓鈕，且已明確定義 WebSphere MQ 傳訊提供者資源，便會停用這個內容。

如果 WebSphere MQ 傳訊提供者資源是以 CCDT 為基礎，一律會啟用這個內容。

如果這個 WebSphere MQ 傳訊提供者資源是以 CCDT 為基礎，則只有在 CCDT 中的相關項目已配置使用 SSL 時，才使用這個參數。

另外，如果所選的 SSL 配置是 none，則會使用 WebSphere MQ 傳訊提供者的預設集中管理的 WebSphere Application Server SSL 配置。

參考資訊	值
資料類型	下拉清單

進階

用戶端 ID

當連接 IBM MQ 傳訊提供者時，所指定的用戶端 ID。

就慣例來說，用戶端 ID 不是使用者 ID，並且跟安全無關。可延續的訂閱在發佈/訂閱傳訊時，會使用它。在訂閱者「離開」期間（例如，不在執行中或者失敗），可延續訂閱會繼續收集訊息，並在訂閱者重新連接時，遞送那些訊息。用戶端身分是您重新連接時用來指出您的訂閱者身分的記號，如此您就能取得不在場期間為您儲存的訊息。

參考資訊	值
資料類型	String

接受複製的可延續訂閱

選項，可決定不同伺服器是否能夠同時存取可延續訂閱的多重實例。

參考資訊	值
資料類型	勾選框
預設值	已清除
範圍	已選取不同伺服器可以同時存取可延續訂閱的多重實例。已清除不同伺服器不能同時存取可延續訂閱的多重實例。

提供者版本

IBM MQ 傳訊提供者版本。此值用來決定是否連接到佇列管理程式的特定版本。另外，它也用來決定用戶端所需要的功能類型。

參考資訊

值

資料類型

String

範圍

輸入的值必須是空字串，或是下列格式之一：

n.n.n.n
n.n.n
n.n
n

其中 n 是大於或等於零的數值。

例如 6.0.0.0。

支援分散兩段式確定通訊協定

選項，可指定 Connection Factory 是否支援傳訊交易的 XA 協調作業。如果要在相同交易中使用包含這個 Connection Factory 的多項資源，請啟用這個選項。

如果清除這個內容，便會停用分散兩段式確定通訊協定的支援。JMS 階段作業仍可以列在交易中，但它會使用資源管理程式本端交易呼叫 session.commit 和 session.rollback，而不是 XA 呼叫。此舉可以提升效能。不過，只有一個資源可以列在 WebSphere Application Server 的交易中。

最後一個參與者支援可讓您將非 XA 資源與其他具備 XA 功能的資源列在一起。

參考資訊	值
資料類型	勾選框
預設值	已選取
範圍	已選取 Connection Factory 支援利用分散兩段式確定通訊協定來協調交易的工作。已清除 Connection Factory 不支援利用分散兩段式確定通訊協定，來協調交易的工作。

如果交易涉及其他資源，其中包括其他佇列或主題，請保持選取這個選項。您必須確定這條佇列連線的目標佇列管理程式是交易中的唯一資源，才能清除這個選項。

安全設定

XA 回復的鑑別別名

在 XA 回復期間，連接 IBM MQ 時要使用的使用者名稱和密碼。

參考資訊	值
資料類型	下拉清單
預設值	（無）
範圍	定義於 Cell 的所有鑑別別名及 "(none)" 值，指定在 XA 回復期間，不傳遞任何認證給 IBM MQ。

對映配置別名

只有在元件資源參照的登入配置不存在時，才使用這個欄位。

當資源權限值是「儲存器」時，偏好的鑑別策略定義方法是在元件資源參照上指定登入配置和相關內容。

如果指定了 DefaultPrincipalMapping 登入配置，相關內容便是 JAAS - J2C 鑑別資料項目別名。如果要配置搭配 Connection Factory 使用的鑑別資訊，請在「相關項目」之下，按一下 JAAS - J2C 鑑別資料。

參考資訊	值
資料類型	下拉清單
預設值	（無）
範圍	以下是可用的選項： ClientContainer WSLogin WSKRB5Login DefaultPrincipalMapping TrustedConnectionMapping KerberosMapping

儲存器管理鑑別別名

指定用來連接 IBM MQ 傳訊提供者之使用者名稱和密碼的鑑別別名。

參考資訊	值
資料類型	下拉清單
預設值	（無）
範圍	定義於 Cell 的所有鑑別別名及 "(none)" 值，指定不傳遞任何認證給 IBM MQ。

檔名： umj_pjcfm.html