jmsQueueConnectionFactory - JMS Queue Connection Factory (jmsQueueConnectionFactory)

定義 JMS Queue Connection Factory 配置。

NameTypeDefaultDescription
idstring唯一的配置 ID。
connectionManagerRef最上層 connectionManager 元素的參照(字串)。Connection Factory 的連線管理程式。
containerAuthDataRef最上層 authData 元素的參照(字串)。儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。
jndiNamestring資源的 JNDI 名稱。
recoveryAuthDataRef最上層 authData 元素的參照(字串)。交易回復的鑑別資料。

connectionManager

Connection Factory 的連線管理程式。

NameTypeDefaultDescription
agedTimeout精準度是秒鐘的時間量-1可透過儲存區維護來捨棄連線之前所經歷的時間量。值 -1 表示會停用此逾時。值 0 表示捨棄每次連線,如此會停用連線儲存區。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
connectionTimeout精準度是秒鐘的時間量30s連線要求逾時之前所經歷的時間量。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
maxIdleTime精準度是秒鐘的時間量30m在儲存區維護期間,連線可以維持未用或閒置的時間量,一旦超過此時間,即可捨棄該連線(前提是這麼做,並不會將儲存區減少至低於大小下限)。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
maxPoolSizeint
Min: 0
50儲存區的實體連線數目上限。值 0 表示無限制。
minPoolSizeint
Min: 0
儲存區中所要維護的實體連線數目下限。不會預先移入儲存區。存在逾時值可置換此下限。
purgePolicy
  • FailingConnectionOnly
  • ValidateAllConnections
  • EntirePool
EntirePool指定在儲存區中偵測到過時連線時所要毀損的連線。
FailingConnectionOnly
當偵測到過時連線時,只會關閉所發現的不正確連線。
ValidateAllConnections
當偵測到過時連線時,會測試連線,並關閉所發現的不正確連線。
EntirePool
當偵測到過時連線時,儲存區中的所有連線均標示為「過時」,當不再使用時,就會關閉。
reapTime精準度是秒鐘的時間量3m儲存區維護執行緒的執行間隔時間量。值 -1 表示會停用儲存區維護。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
maxConnectionsPerThreadint
Min: 0
限制每一個執行緒上的開啟連線數目。
numConnectionsPerThreadLocalint
Min: 0
針對每一個執行緒快取指定數目的連線。
enableSharingForDirectLookupsbooleantrue如果設為 true,則連線共用。如果設為 false,則連線不共用。

containerAuthData

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

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

recoveryAuthData

交易回復的鑑別資料。

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

properties.wasJms

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

NameTypeDefaultDescription
busNamestringdefaultBus當連接到完整設定檔伺服器中的服務整合匯流排時,匯流排的名稱。
nonPersistentMapping
  • ReliableNonPersistent
  • ExpressNonPersistent
  • BestEffortNonPersistent
ExpressNonPersistent這個 Connection Factory 所傳送之非持續性 JMS 訊息所適用的可靠性。
ReliableNonPersistent
ReliableNonPersistent
ExpressNonPersistent
ExpressNonPersistent
BestEffortNonPersistent
BestEffortNonPersistent
persistentMapping
  • ReliablePersistent
  • AssuredPersistent
ReliablePersistent套用在這個 Connection Factory 所傳送的持續性 JMS 訊息之可靠性。
ReliablePersistent
ReliablePersistent
AssuredPersistent
AssuredPersistent
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
Default先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
temporaryQueueNamePrefixstringtemp使用這個 Queue Connection Factory 的應用程式所建立的暫時佇列所使用之字首(最多 12 個字元)。
password可逆的編碼密碼(字串)建議使用儲存器管理的鑑別別名,而非配置這個內容。
remoteServerAddressstring用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。
targetTransportChainstring傳輸鏈指定與完整設定檔伺服器中的服務整合匯流排通訊時所能使用的通訊協定。
userNamestring建議使用儲存器管理的鑑別別名,而非配置這個內容。

properties.wmqJms

WebSphere MQ JMS Queue Connection Factory

NameTypeDefaultDescription
portint
Min: 1
1414佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
providerVersion
  • unspecified
  • 6
  • 7
unspecified應用程式準備連接的佇列管理程式的版本、版次、修正層次和修正套件。
unspecified
unspecified
6
6
7
7
shareConvAllowedbooleantrue如果通道定義相符,從相同程序到相同佇列管理程式,用戶端連線是否能夠與其他最上層的 JMS 連線共用它的 Socket
targetClientMatchingbooleantrue傳送給送入訊息的 JMSReplyTo 標頭欄位所識別之佇列的回覆訊息,是否只在送入訊息有 MQRFH2 標頭時,才會有 MQRFH2 標頭。
transportType
  • BINDINGS
  • CLIENT
CLIENT佇列管理程式連線使用用戶端模式或連結模式。如果指定了 BINDINGS_THEN_CLIENT 值,資源配接器會先嘗試在連結模式之下建立連線。如果這個連線失敗,便嘗試建立用戶端模式連線。
BINDINGS
BINDINGS
CLIENT
CLIENT
CCSIDint
Min: 1
819連線的編碼字集 ID。
failIfQuiescebooleantrue如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。
headerCompression
  • SYSTEM
  • NONE
NONE連線上壓縮標頭資料所能使用的技術清單
SYSTEM
SYSTEM
NONE
NONE
messageCompression
  • RLE
  • NONE
NONE連線上壓縮訊息資料所能使用的技術清單。
RLE
RLE
NONE
NONE
rescanInterval精準度是毫秒的時間量5s當點對點網域中的訊息消費者利用訊息選取元來選取要接收的訊息時,適用於 JMS 的 WebSphere MQ 類別會依照佇列的 MsgDeliverySequence 屬性所決定的順序來搜尋 WebSphere MQ 佇列,尋找適當的訊息. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
applicationNamestring應用程式向佇列管理程式登錄的名稱。
ccdtURLstring這個 URL 用來識別包含用戶端通道定義表 (CCDT) 的檔案名稱和位置,同時也指定檔案的存取方式。
channelstring要使用的 MQI 通道的名稱。
clientIdstring連線的用戶端 ID。
connectionNameListstring用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。
hostNamestring佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
password可逆的編碼密碼(字串)建立佇列管理程式連線時,要使用的預設密碼。(建議使用儲存器管理的鑑別別名,而非配置這個內容)
queueManagerstring要連接的佇列管理程式名稱
temporaryModelstring建立 JMS 暫時佇列的來源模型佇列名稱。JMS 層可以利用 SYSTEM.JMS.TEMPQ.MODEL 來建立接受持續訊息的佇列,預設值無法如此。SYSTEM.DEFAULT.MODEL.QUEUE 只能開啟一次。SYSTEM.JMS.TEMPQ.MODEL 可以開啟許多次。SYSTEM.DEFAULT.MODEL.QUEUE 已淘汰。
tempQPrefixstring用來形成 WebSphere MQ 動態佇列名稱的字首。
userNamestring建立佇列管理程式連線時,要使用的預設使用者名稱。(建議使用儲存器管理的鑑別別名,而非配置這個內容)
localAddressstring對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。
pollingInterval精準度是毫秒的時間量如果階段作業內每個訊息接聽器的佇列上都沒有適當的訊息,這個值便是每個訊息接聽器在重新嘗試從它的佇列取得訊息之前,所經歷的間隔上限(毫秒)。如果經常出現階段作業中任何訊息接聽器都沒有適當訊息的情況,請考慮增加這個內容的值。只有在 TRANSPORT 參數值是 BIND 或 CLIENT 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
sendCheckCountint
Min: 0
在單一非交易 JMS 階段作業內,在檢查非同步放置錯誤之間,所容許的傳送呼叫數目。
sslCertStoresstring保存憑證撤銷清冊 (CRL) 以用於 SSL 連線的「輕量型目錄存取通訊協定 (LDAP)」伺服器。
sslCipherSuitestring用於 SSL 連線的 CipherSuite。
sslFipsRequiredbooleanSSL 連線是否必須使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 所支援的 CipherSuite。
sslPeerNamestring對於 SSL 連線,這是用來檢查佇列管理程式提供的數位憑證其中之識別名稱的範本。
sslResetCountint
Min: 0

Max: 999999999
在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數。
receiveExitstring識別一個通道接收結束程式,或要連續執行的一系列接收結束程式。
receiveExitInitstring當呼叫通道接收結束程式時,傳給通道接收結束程式的使用者資料
securityExitstring識別通道安全結束程式
securityExitInitstring當呼叫通道安全結束程式時,傳給通道安全結束程式的使用者資料
sendExitstring識別一個通道傳送結束程式,或要連續執行的一系列傳送結束程式。
sendExitInitstring當呼叫通道傳送結束程式時,傳給通道傳送結束程式的使用者資料。
arbitraryPropertiesstring指定它處未定義之內容的能力