應用程式用戶端的 WebSphere MQ Provider Topic Connection Factory 設定

請利用這個畫面來檢視或變更所選 Topic Connection Factory 的配置內容，以便搭配 WebSphere^® MQ 產品「Java™ 訊息服務 (JMS)」提供者使用。這些配置內容會控制如何建立 JMS 提供者和 WebSphere MQ 之間的連線。

如果要檢視這個「應用程式用戶端資源配置工具」(ACRCT) 頁面，請按一下檔案 > 開啟。瀏覽 EAR 檔之後，請按一下開啟。展開選取的 JAR 檔 > 傳訊提供者 > WebSphere MQ 提供者。用滑鼠右鍵按一下 Topic Connection Factory，再按一下新建。

附註：

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

MA0C 分配管理系統：當建立 MA0C 分配管理系統的 WebSphere Application Server 第 6 版 Topic Connection Factory 時，您應考慮下列屬性值：

BrokerControlQueue: 此值在 MA0C 分配管理系統的 SYSTEM.BROKER.CONTROL.QUEUE 中是固定的，它是分配管理系統所要讀取的佇列。
BrokerVersion: 請針對 MA0C 分配管理系統，將此值設為 BASIC。
ClientID: 請針對 MA0C 分配管理系統，設定一個您要的值（此值為一個字串，且純粹是您用戶端應用程式的 ID）。
已啟用 XA: 請針對 MA0C 分配管理系統，將此值設為 TRUE 或 FALSE（您所用的設定為一個效能加強旗標 - 在大部分時候，您有可能會想將此值設為 'true'）。
BrokerMessage 選取: 此值在 MA0C 分配管理系統的 CLIENT 中為固定的，這是因為分配管理系統會根據用戶端的訊息選取而定。
直接分配管理系統授權類型: MA0C 分配管理系統不需要此值。

WebSphere MQ 產品 JMS 提供者的 Topic Connection Factory 有下列內容。

名稱

用來識別這個 Topic Connection Factory 的名稱，供 WebSphere Application Server 內管理作業使用。在 JMS 提供者內，名稱必須是唯一的。

資料類型

String

說明

這個 Topic Connection Factory 的說明，供 WebSphere Application Server 內管理作業使用。

資料類型

String

JNDI 名稱

將 Topic Connection Factory 連結到應用程式伺服器名稱空間時所用的 Java 命名和目錄介面 (JNDI) 名稱。

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

這個名稱用來鏈結平台的連結資訊。連結會將模組部署描述子所定義的資源關聯到由平台連結到 JNDI 內的實際（實體）資源。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 45 個 ASCII 字元

使用者 ID

如果呼叫端應用程式沒有明確提供使用者 ID 和密碼，就搭配密碼內容來進行鑑別的使用者 ID。

如果您指定了使用者 ID 內容值，您也必須指定密碼內容值。

如果呼叫端應用程式沒有明確提供使用者 ID 和密碼，例如，如果呼叫端應用程式使用 createTopicConnection() 方法，就會使用 Connection Factory 使用者 ID 和密碼內容。 JMS 用戶端會將使用者 ID 和密碼傳送給 JMS 伺服器。

資料類型

String

密碼

在呼叫端應用程式沒有明確提供使用者 ID 和密碼時，要搭配使用者 ID 內容來進行鑑別的密碼。

如果您指定了使用者 ID 內容值，您也必須指定密碼內容值。

資料類型

String

重新輸入密碼

確認密碼。

佇列管理程式

這個 Connection Factory 的 WebSphere MQ 佇列管理程式的名稱。這個 Connection Factory 所建立的連線會連接這個佇列管理程式。

資料類型

String

輸入主機名稱和埠資訊

依預設，會選取這個圓鈕，如果選取的話，會啟用主機和埠內容，並停用連線名稱清單內容。

資料類型	圓鈕
預設值	已選取

主機

WebSphere MQ 佇列管理程式執行其中的主機名稱，只供用戶端連線使用。

資料類型	String
範圍	有效的 TCP/IP 主機名稱

埠

通往 WebSphere MQ 佇列管理程式的連線所用的 TCP/IP 埠號，只供用戶端連線使用。

這個埠必須配置於 WebSphere MQ 佇列管理程式。

資料類型	Integer
範圍	配置於 WebSphere MQ 佇列管理程式的有效 TCP/IP 埠號。

輸入連線名稱清單資訊

如果選取的話，這個圓鈕會啟用連線名稱清單內容，並停用主機和埠名稱內容。如果您想要連接到多重實例佇列管理程式，請選取這個圓鈕。

資料類型	圓鈕
預設值	已清除

連線名稱清單

這是一份逗點區隔的主機和埠資訊清單，可用來連接到多重實例的佇列管理程式。

清單格式如下：

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

其中 port 是選用的，如果未設定的話，預設值是 1414。例如：

hostname1,hostname2(1415)

如需多重實例佇列管理程式進一步的相關資訊，請參閱 WebSphere MQ 資訊中心。

這個內容只能用來連接多重實例的佇列管理程式。它不能用來連接特殊佇列管理程式的清單，否則，可能會發生交易完整性問題。

通道

連接至 WebSphere MQ 佇列管理程式之用戶端連線所用的通道名稱，只供用戶端連線使用。

資料類型	String
範圍	1 至 20 個 ASCII 字元

傳輸類型

要利用 WebSphere MQ 用戶端連線或 JNDI 連結來連接 WebSphere MQ 佇列管理程式。

資料類型	列舉
預設值	BINDINGS
範圍	CLIENT WebSphere MQ 用戶端連線用來連接 WebSphere MQ 佇列管理程式。 BINDINGS JNDI 連結用來連接 WebSphere MQ 佇列管理程式。

用戶端 ID

通往 MQSeries MQ 佇列管理程式的連線所用的 JMS 用戶端 ID。

資料類型

String

CCSID

搭配 WebSphere MQ 佇列管理程式使用的編碼字集 ID。

這個編碼字集 ID (CCSID) 必須是 WebSphere MQ 支援的其中一個 CCSID。如需詳細資料，請參閱 Topic Connection Factory 內容。

資料類型	String
單位	Integer
範圍	1 至 65535 個字元

分配管理系統控制佇列

所有指令訊息（除了發佈和刪除發佈的要求）都要送往其中的分配管理系統控制佇列的名稱。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 48 個 ASCII 字元

分配管理系統佇列管理程式

提供發佈和訂閱訊息分配管理系統之 WebSphere MQ 佇列管理程式的名稱。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 48 個 ASCII 字元

分配管理系統發佈佇列

接收預設串流所有發佈訊息的分配管理系統輸入佇列的名稱。

接收預設串流所有發佈訊息的分配管理系統輸入佇列（串流佇列）的名稱。應用程式也可以將刪除預設串流中之發佈訊息的要求傳送到這個佇列。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 48 個 ASCII 字元

分配管理系統訂閱佇列

從中擷取不可延續的訂閱訊息之分配管理系統佇列的名稱。

從中擷取不可延續的訂閱訊息之分配管理系統佇列的名稱。訂閱者在登錄訂閱時指定佇列的名稱。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 48 個 ASCII 字元

分配管理系統 CCSubQ

從中擷取 ConnectionConsumer 要求的不可延續的訂閱訊息之分配管理系統佇列的名稱。這個內容只適用於 Web 儲存器。

資料類型	String
單位	En_US ASCII 字元
範圍	1 至 48 個 ASCII 字元

分配管理系統版本

訊息分配管理系統是 WebSphere MQ MA0C SupportPac™，或 WebSphere 系列訊息分配管理系統產品的較新版本所提供。

資料類型	列舉
預設值	進階
範圍	進階訊息分配管理系統是由 WebSphere 系列訊息分配管理系統產品的較新版本（MQ Integrator 和 MQ 發佈與訂閱）所提供。基本訊息分配管理系統是 WebSphere MQ MA0C SupportPac（WebSphere MQ - 發佈和訂閱）所提供的。

清除層次

發佈或訂閱清除公用程式所提供的清除層次。

資料類型

列舉

預設值

SAFE

範圍

ASPROP
NONE

STRONG

清理間隔

在背景執行發佈/訂閱清除公用程式的間隔（以毫秒為單位）。

資料類型	Integer
單位	毫秒
預設值	6000

選取訊息

要在何處選取分配管理系統訊息。

資料類型

列舉

預設值

BROKER

範圍

BROKER: 在分配管理系統位置選取訊息。

訊息 CLIENT: 在用戶端位置選取訊息。

發佈確認間隔

需要分配管理系統發出確認的發佈要求間隔（訊息數）。

資料類型	Integer
預設值	25

少量訂閱

啟用少量訂閱。

資料類型	勾選框
預設值	已清除

狀態更新間隔

重新整理發佈或訂閱狀態的交易間隔（以毫秒為單位）。

資料類型	Integer
預設值	6000

訂閱儲存庫

WebSphere MQ 用來儲存作用中 JMS 訂閱相關資料的位置。

資料類型

列舉

預設值

MIGRATE

範圍

MIGRATE

QUEUE

BROKER

多重播送

這個 Connection Factory 是否使用多重播送傳輸。

資料類型

列舉

預設值

NOT USED

範圍

NOT USED: 這個 Connection Factory 不使用多重播送傳輸。

ENABLED: 這個 Connection Factory 一律使用多重播送傳輸。

ENABLED_IF_AVAILABLE: 這個 Connection Factory 使用多重播送傳輸。

ENABLED_RELIABLE: 這個 Connection Factory 使用可靠的多重播送傳輸。

ENABLED_RELIABLE_IF_AVAILABLE: 如果能夠使用可靠的多重播送傳輸，這個 Connection Factory 便使用可靠的多重播送傳輸。

直接鑑別

是否要使用直接分配管理系統授權。

資料類型

列舉

預設值

無

範圍

NONE: 不使用直接分配管理系統授權。

PASSWORD: 用密碼來鑑別直接分配管理系統授權。

CERTIFICATE: 用憑證來鑑別直接分配管理系統授權。

Proxy 主機名稱

與 WebSphere MQ 通訊時所用的 Proxy 主機名稱。

資料類型

String

Proxy 埠

與 WebSphere MQ 通訊時所用的 Proxy 埠號。

資料類型	Integer
預設值	0

靜止便失敗

若佇列管理程式進入受管制的失敗情況，應用程式是否會從方法呼叫返回。

資料類型	勾選框
預設值	已選取

本端伺服器位址

本端伺服器位址。

資料類型

String

輪詢間隔

非同步訊息遞送期間，掃描所有接收端的間隔時間（以毫秒為單位）。

資料類型	Integer
單位	毫秒
預設值	5000

重新掃描間隔

掃描主題來尋找已加到主題中但不符合正常順序的訊息之間隔（以毫秒為單位）。

重新掃描間隔用來控制已加到主題中，但卻不符合 WebSphere MQ 瀏覽游標相對順序的訊息掃描作業。

資料類型	Integer
單位	毫秒
預設值	5000

SSL 密碼組合

通往 WebSphere MQ 之 SSL 連線所用的密碼組合。

請將這個內容設定為 JSSE 提供者所提供的有效密碼組合。這個值必須符合 SVRCONN 通道指定為通道內容的 CipherSpec。

如果您設定 SSL 同層級名稱內容，您就必須設定這個內容。

SSL 憑證儲存庫

用來檢查 SSL 憑證撤銷之零或多個「憑證撤銷清冊 (CRL)」伺服器的清單。如果您指定這個內容的值，就必須使用 Java 2 1.4 版的 WebSphere MQ JVM。

這個值是用空格分開的項目清單，格式如下：

ldap://hostname:[port]

這個值後面有一個單斜線 (/)。如果忽略 port，就會使用預設 LDAP 埠 389。在連線時，會核對指定的 CRL 伺服器來檢查伺服器所提供的 SSL 憑證。如需 CRL 安全的相關資訊，請參閱 WebSphere MQ 資訊中心的《安全》，關於「使用憑證撤銷清冊」的相關資訊。

SSL 同層級名稱

對於 SSL 而言，必須符合 WebSphere MQ 佇列管理程式所提供之名稱的識別名稱 Skeleton。這個識別名稱用來檢查伺服器在連線時所提供的識別憑證。

如果未設定這個內容，就會執行這類憑證檢查。

如果未指定 SSL 密碼組合內容，系統不會處理 SSL 同層級名稱內容。

這個內容是一份用逗點或分號來分隔的屬性名稱/值配對清單。例如：

CN=QMGR.*, OU=IBM, OU=WEBSPHERE

給定的範例會檢查伺服器在連線時提供的識別憑證。如果要順利完成連線，憑證必須有開頭是 QMGR 的共用名稱，且必須有至少兩個組織單位名稱，第一個是 IBM，第二個是 WEBSPHERE。檢查不區分大小寫。

如需識別名稱及如何搭配 WebSphere MQ 來使用的詳細資料，請參閱 WebSphere MQ 資訊中心的《安全》，關於「識別名稱」的相關資訊。

連線儲存區

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

所有 J2C 連接器會共用連線儲存區內容。

應用程式伺服器會將連線和階段作業與 JMS 提供者置於儲存區中，來提高效能。這與任何 WebSphere MQ 連線儲存區無關。您必須針對您的應用程式，來配置連線和階段作業儲存區內容，否則可能不會得到您所要的連線和階段作業行為。

如果 JMS 資源的並行伺服器端存取作業超出預設值，請變更連線儲存區的大小。連線儲存區大小是以個別佇列或主題為基礎來設定的。

資料類型	勾選框
預設值	已選取

用戶端重新連線選項

指定在通訊或佇列管理程式失敗的事件中，是否自動重新連接用戶端模式連線。除非在小型或受管理用戶端環境中使用 Connection Factory，否則，會忽略這個內容。

資料類型	下拉清單
預設值	DISABLED
範圍	DISABLED 用戶端重新連線不會自動進行。 ASDEF 使用用戶端配置檔通道段落中的 DefRecon 屬性值。如果沒有指定 DefRecon 值，這個設定的作用與 DISABLED 值相同。 RECONNECT 任何符合佇列管理程式屬性值的佇列管理程式都會重新連線，有可能不是連線最初所連接的佇列管理程式。 QMGR 只有連線最初連接的佇列管理程式才會重新連線。

如需自動用戶端重新連線的相關資訊，請參閱 WebSphere MQ 資訊中心。

用戶端重新連線逾時值

在通訊或佇列管理程式失敗之後，用戶端模式連線用來嘗試自動重新連接佇列管理程式的時間上限（秒）。除非在小型或受管理用戶端環境中使用 Connection Factory，否則，會忽略這個參數。是否使用這個參數，會隨著用戶端重新連線選項參數值而不同。

資料類型	Integer
單位	秒
預設值	1800
範圍	大於零的值，最多可達 2147483647

如需自動用戶端重新連線的相關資訊，請參閱 WebSphere MQ 資訊中心。

標示（線上）的鏈結表示需要存取網際網路。

檔名：ucli_ptcfm.html