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

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

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

附註:

JMS 提供者的 Queue Connection Factory 有下列內容。

名稱

用來識別這個 Queue Connection Factory 的名稱,供 WebSphere Application Server 內管理作業使用。 在整個 WebSphere 管理網域的各個 JMS Connection Factory 內,這個名稱必須是唯一的。

資料類型 String
說明

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

資料類型 String
預設值 空值
JNDI 名稱

應用程式用戶端執行時期利用這個欄位來擷取配置資訊。

使用者 ID

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

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

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

資料類型 String
密碼

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

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

資料類型 String
預設值 空值
重新輸入密碼

確認密碼。

佇列管理程式

這個 Connection Factory 的 WebSphere MQ 佇列管理程式的名稱。

這個 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 佇列管理程式。 外部 JMS 提供者會控制 JMS 用戶端和 JMS 伺服器之間的通訊協定。 當您使用非 ASF 非持續性、不可延續的非交易式傳訊時,或當您要滿足安全問題且用戶端在佇列管理程式節點的本端時,請調整傳輸類型。

資料類型 列舉
單位 不適用
預設值 BINDINGS
範圍
BINDINGS
JNDI 連結用來連接佇列管理程式。BINDINGS 是共用記憶體通訊協定,佇列管理程式必須在 JMS 用戶端的相同節點中,它才能使用,它會帶來應該用 EJB 角色來解決的安全風險。
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,否則,用戶端應用程式也會出現這個遺失情況。您可以使用下列指令將它設定為 0:
#wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID
您可以啟動分配管理系統,查看事件日誌/應用程式找出事件 2201,來找到 executionGroupUUID。 這個值通常是 ffffffff-0000-0000-000000000000。
附註:在 WAS 6.1 內無法使用 WebSphere MQ 5.3 JMS,因為 WAS 6.1 採用 Java 5 執行時期。 因此,無法使用 WebSphere MQ 5.3 佇列管理程式來建立跨記憶體的連線。 如果您先前使用 WebSphere MQ 5.3,連線使用 BINDINGS,但移轉至 WebSphere Application Server 6.1 版時改用 CLIENT 網路連線,效能可能會退化。 如果您使用 WebSphere MQ 5.3 for z/OS®,您也可能需加購一份特性套件。

[z/OS]當執行於 64 位元 z/OS 時,傳輸類型必須設為 CLIENT,因為目前未提供 64 位元 WebSphere MQ z/OS,無法利用 BINDINGS 模式來連接到 31 位元的 WebSphere MQ z/OS。 您也可能需加購一份 WebSphere MQ 特性套件,才能取得這項支援。

用戶端 ID

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

資料類型 String
CCSID

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

這個編碼字集 ID (CCSID) 必須是 WebSphere MQ 所支援的 CCSID 之一。

資料類型 String

如需支援的 CCSID 以及在不同的編碼字集之間轉換訊息資料的相關資訊,請參閱 WebSphere MQ 資訊中心的《系統管理手冊》和 Application Programming Reference

訊息保留

請選取這個勾選框來指定將不要的訊息保留在佇列中。否則,會根據不要的訊息本身的處置選項來處理這些訊息。

資料類型 列舉
單位 不適用
預設值 已清除
範圍
已選取
將不要的訊息保留在佇列中。
已清除
根據不要的訊息本身的處置選項來處理這些訊息。
暫時模型

如果 Connection Factory 尚不存在,便用來建立暫時 Connection Factory 的模型定義名稱。

資料類型 String
範圍 1 至 48 個 ASCII 字元
暫時佇列字首

動態佇列命名所用的字首。

資料類型 String
靜止便失敗

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

資料類型 勾選框
預設值 已選取
本端伺服器位址

請指定本端伺服器位址。

資料類型 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_pqcfm.html