定義 JMS Queue Connection Factory 配置。

名稱 類型 預設值 說明

connectionManagerRef

最上層 connectionManager 元素的參照(字串)。

Connection Factory 的連線管理程式。

containerAuthDataRef

最上層 authData 元素的參照(字串)。

儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。

id

字串

唯一的配置 ID。

jaasLoginContextEntryRef

最上層 jaasLoginContextEntry 元素的參照(字串)。

鑑別用的 JAAS 登入環境定義項目。如果在伺服器執行期間更新,會將更新套用至新的連線要求;使用中的連線不受影響。

jndiName

string

資源的 JNDI 名稱。

recoveryAuthDataRef

最上層 authData 元素的參照(字串)。

交易回復的鑑別資料。

connectionManager

Connection Factory 的連線管理程式。

名稱 類型 預設值 說明

agedTimeout

精準度是秒鐘的時間量

-1

可透過儲存區維護來捨棄連線之前所經歷的時間量。值 -1 表示會停用此逾時。值 0 表示捨棄每次連線,如此會停用連線儲存區。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

connectionTimeout

精準度是秒鐘的時間量

30s

連線要求逾時之前所經歷的時間量。值 -1 表示停用此逾時,意味著無限等待。值 0 表示立即,意味著不等待。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

maxIdleTime

精準度是秒鐘的時間量

30m

在儲存區維護期間,連線可以維持未用或閒置的時間量,一旦超過此時間,即可捨棄該連線(前提是這麼做,並不會將儲存區減少至低於大小下限)。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

maxPoolSize

int
下限: 0

50

儲存區的實體連線數目上限。值 0 表示無限制。最佳設定視應用程式性質而定。若為其中每個執行緒都取得資料庫連線的應用程式,您可以透過與 `coreThreads` 屬性的 1:1 對映來開始。

minPoolSize

int
下限: 0

儲存區中所要維護的實體連線數目下限。不會預先移入儲存區。存在逾時值可置換此下限。

purgePolicy

  • EntirePool

  • FailingConnectionOnly

  • ValidateAllConnections

EntirePool

指定在儲存區中偵測到過時連線時所要毀損的連線。
EntirePool
當偵測到過時連線時,儲存區中的所有連線均標示為「過時」,當不再使用時,就會關閉。
FailingConnectionOnly
當偵測到過時連線時,只會關閉所發現的不正確連線。
ValidateAllConnections
當偵測到過時連線時,會測試連線,並關閉所發現的不正確連線。

reapTime

精準度是秒鐘的時間量

3m

儲存區維護執行緒的執行間隔時間量。值 -1 表示會停用儲存區維護。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

進階內容

autoCloseConnections

boolean

true

如果應用程式在 Servlet 要求、Enterprise Bean 實例、受管理執行程式作業、環境定義作業或受管理完成階段結束之後保持連線開啟,則嘗試予以清除。如果在上述一個應用程式構件中取得不可共用的連線,而且該連線在該構件結束時保持開啟,則儲存器會嘗試關閉該連線控點。儲存器還可以關閉不支援 DissociatableManagedConnection 的可共用連線。應用程式應當一律遵循規格所定義的程式設計模型,並在適當的時候關閉連線,而非仰賴於儲存器,即使啟用這個選項也是一樣。

enableContainerAuthForDirectLookups

boolean

false

如果設為 true,則連線使用儲存器鑑別。如果設為 false,則連線使用應用程式鑑別。

enableSharingForDirectLookups

boolean

true

如果設為 true,則連線共用。如果設為 false,則連線不共用。

maxConnectionsPerThread

int
下限: 0

限制每一個執行緒上的開啟連線數目。

numConnectionsPerThreadLocal

int
下限: 0

針對每一個執行緒快取指定數目的連線。 此設定可以為每個執行緒保留指定數目的資料庫連線,以改善大型多核心 (8+) 機器上的效能。 為了取得最佳效能,如果您有 n 個應用程式執行緒,請將儲存區連線數上限設為至少為 numConnectionsPerThreadLocal 屬性值的 n 倍。 對所有連線要求使用相同的認證。 例如,如果您使用 20 個應用程式執行緒,請將儲存區連線數上限設為 20 或以上。 如果您將 numConnectionPerThreadLocal 屬性的值設為 2,且您有 20 個應用程式執行緒,請將儲存區連線數上限設為 40 或以上。 如果設定 numConnectionsPerThreadLocal 無法改善效能,因為應用程式連線使用型樣無法受益於使用 numConnectionsPerThreadLocal,請從配置中移除屬性或將值設為 0。

containerAuthData

儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

jaasLoginContextEntry

鑑別用的 JAAS 登入環境定義項目。如果在伺服器執行期間更新,會將更新套用至新的連線要求;使用中的連線不受影響。

名稱 類型 預設值 說明

loginModuleRef

最上層 jaasLoginModule 元素的參照清單(逗點區隔的字串)。

hashtable,userNameAndPassword,certificate,token

JAAS 登入模組 ID 的參照。

name

string
必要

JAAS 配置項目的名稱。

properties.wasJms

JMS Queue Connection Factory 用來建立 JMS 佇列之相關 JMS 提供者的連線,供點對點傳訊使用。

名稱 類型 預設值 說明

busName

string

defaultBus

連接至 WebSphere Application Server 傳統版中的服務整合匯流排時的匯流排名稱。

nonPersistentMapping

  • BestEffortNonPersistent

  • ExpressNonPersistent

  • ReliableNonPersistent

ExpressNonPersistent

這個 Connection Factory 所傳送之非持續性 JMS 訊息所適用的可靠性。

password

可逆的編碼密碼(字串)

建議使用儲存器管理的鑑別別名,而非配置這個內容。

persistentMapping

  • AssuredPersistent

  • ReliablePersistent

ReliablePersistent

套用在這個 Connection Factory 所傳送的持續性 JMS 訊息之可靠性。

readAhead

  • AlwaysOff

  • AlwaysOn

  • Default

Default

先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。

remoteServerAddress

string

用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。

targetTransportChain

string

傳輸鏈指定與 WebSphere Application Server 傳統版中的服務整合匯流排通訊時,所能使用的通訊協定。

temporaryQueueNamePrefix

string

temp

使用這個 Queue Connection Factory 的應用程式所建立的暫時佇列所使用之字首(最多 12 個字元)。

userName

string

建議使用儲存器管理的鑑別別名,而非配置這個內容。

properties.wmqJms

WebSphere MQ JMS Queue Connection Factory

名稱 類型 預設值 說明

CCSID

int
下限: 1

819

連線的編碼字集 ID。

applicationName

string

應用程式向佇列管理程式登錄的名稱。

arbitraryProperties

string

指定它處未定義之內容的能力

ccdtURL

string

這個 URL 用來識別包含用戶端通道定義表 (CCDT) 的檔案名稱和位置,同時也指定檔案的存取方式。

channel

string

要使用的 MQI 通道的名稱。

clientId

string

連線的用戶端 ID。

connectionNameList

string

用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。

failIfQuiesce

boolean

true

如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。

headerCompression

  • NONE

  • SYSTEM

NONE

連線上壓縮標頭資料所能使用的技術清單

hostName

string

佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。

localAddress

string

對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。

messageCompression

  • NONE

  • RLE

NONE

連線上壓縮訊息資料所能使用的技術清單。

password

可逆的編碼密碼(字串)

建立佇列管理程式連線時,要使用的預設密碼。(建議使用儲存器管理的鑑別別名,而非配置這個內容)

pollingInterval

精準度是毫秒的時間量

如果階段作業內每個訊息接聽器的佇列上都沒有適當的訊息,這個值便是每個訊息接聽器在重新嘗試從它的佇列取得訊息之前,所經歷的間隔上限(毫秒)。如果經常出現階段作業中任何訊息接聽器都沒有適當訊息的情況,請考慮增加這個內容的值。只有在 TRANSPORT 參數值是 BIND 或 CLIENT 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

port

int
下限: 1

1414

佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。

providerVersion

  • 6

  • 7

  • unspecified

unspecified

應用程式準備連接的佇列管理程式的版本、版次、修正層次和修正套件。

queueManager

string

要連接的佇列管理程式名稱

receiveExit

string

識別一個通道接收結束程式,或要連續執行的一系列接收結束程式。

receiveExitInit

string

當呼叫通道接收結束程式時,傳給通道接收結束程式的使用者資料

rescanInterval

精準度是毫秒的時間量

5s

當點對點網域中的訊息消費者利用訊息選取元來選取要接收的訊息時,適用於 JMS 的 WebSphere MQ 類別會依照佇列的 MsgDeliverySequence 屬性所決定的順序來搜尋 WebSphere MQ 佇列,尋找適當的訊息. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

securityExit

string

識別通道安全結束程式

securityExitInit

string

當呼叫通道安全結束程式時,傳給通道安全結束程式的使用者資料

sendCheckCount

int
下限: 0

在單一非交易 JMS 階段作業內,在檢查非同步放置錯誤之間,所容許的傳送呼叫數目。

sendExit

string

識別一個通道傳送結束程式,或要連續執行的一系列傳送結束程式。

sendExitInit

string

當呼叫通道傳送結束程式時,傳給通道傳送結束程式的使用者資料。

shareConvAllowed

boolean

true

如果通道定義相符,從相同程序到相同佇列管理程式,用戶端連線是否能夠與其他最上層的 JMS 連線共用它的 Socket

sslCertStores

string

保存憑證撤銷清冊 (CRL) 以用於 SSL 連線的「輕量型目錄存取通訊協定 (LDAP)」伺服器。

sslCipherSuite

string

用於 SSL 連線的 CipherSuite。

sslFipsRequired

boolean

SSL 連線是否必須使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 所支援的 CipherSuite。

sslPeerName

string

對於 SSL 連線,這是用來檢查佇列管理程式提供的數位憑證其中之識別名稱的範本。

sslResetCount

int
下限: 0
上限: 999999999

在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數。

targetClientMatching

boolean

true

傳送給送入訊息的 JMSReplyTo 標頭欄位所識別之佇列的回覆訊息,是否只在送入訊息有 MQRFH2 標頭時,才會有 MQRFH2 標頭。

tempQPrefix

string

用來形成 WebSphere MQ 動態佇列名稱的字首。

temporaryModel

string

建立 JMS 暫時佇列的來源模型佇列名稱。JMS 層可以利用 SYSTEM.JMS.TEMPQ.MODEL 來建立接受持續訊息的佇列,預設值無法如此。SYSTEM.DEFAULT.MODEL.QUEUE 只能開啟一次。SYSTEM.JMS.TEMPQ.MODEL 可以開啟許多次。SYSTEM.DEFAULT.MODEL.QUEUE 已淘汰。

transportType

  • BINDINGS

  • CLIENT

CLIENT

佇列管理程式連線使用用戶端模式或連結模式。如果指定了 BINDINGS_THEN_CLIENT 值,資源配接器會先嘗試在連結模式之下建立連線。如果這個連線失敗,便嘗試建立用戶端模式連線。

userName

string

建立佇列管理程式連線時,要使用的預設使用者名稱。(建議使用儲存器管理的鑑別別名,而非配置這個內容)

recoveryAuthData

交易回復的鑑別資料。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。