定義 JMS 主題 Connection Factory 配置。
Name | Type | Default | Description |
---|---|---|---|
id | string | 唯一的配置 ID。 | |
connectionManagerRef | 最上層 connectionManager 元素的參照(字串)。 | Connection Factory 的連線管理程式。 | |
containerAuthDataRef | 最上層 authData 元素的參照(字串)。 | 儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。 | |
jndiName | string | 資源的 JNDI 名稱。 | |
recoveryAuthDataRef | 最上層 authData 元素的參照(字串)。 | 交易回復的鑑別資料。 |
Connection Factory 的連線管理程式。
Name | Type | Default | Description |
---|---|---|---|
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 秒。 |
maxPoolSize | int Min: 0 | 50 | 儲存區的實體連線數目上限。值 0 表示無限制。 |
minPoolSize | int Min: 0 | 儲存區中所要維護的實體連線數目下限。不會預先移入儲存區。存在逾時值可置換此下限。 | |
purgePolicy |
| EntirePool | 指定在儲存區中偵測到過時連線時所要毀損的連線。 FailingConnectionOnly 當偵測到過時連線時,只會關閉所發現的不正確連線。 ValidateAllConnections 當偵測到過時連線時,會測試連線,並關閉所發現的不正確連線。 EntirePool 當偵測到過時連線時,儲存區中的所有連線均標示為「過時」,當不再使用時,就會關閉。 |
reapTime | 精準度是秒鐘的時間量 | 3m | 儲存區維護執行緒的執行間隔時間量。值 -1 表示會停用儲存區維護。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
maxConnectionsPerThread | int Min: 0 | 限制每一個執行緒上的開啟連線數目。 | |
numConnectionsPerThreadLocal | int Min: 0 | 針對每一個執行緒快取指定數目的連線。 | |
enableSharingForDirectLookups | boolean | true | 如果設為 true,則連線共用。如果設為 false,則連線不共用。 |
儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。
Name | Type | Default | Description |
---|---|---|---|
user | string | 連接至 EIS 時要使用的使用者名稱。 | |
password | 可逆的編碼密碼(字串) | 連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。 |
交易回復的鑑別資料。
Name | Type | Default | Description |
---|---|---|---|
user | string | 連接至 EIS 時要使用的使用者名稱。 | |
password | 可逆的編碼密碼(字串) | 連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。 |
JMS Topic Connection Factory 用來建立通往 JMS 目的地之相關 JMS 提供者的連線,供發佈/訂閱傳訊使用。
Name | Type | Default | Description |
---|---|---|---|
busName | string | defaultBus | 當連接到完整設定檔伺服器中的服務整合匯流排時,匯流排的名稱。 |
clientID | string | clientID | 所有連線上的可延續(和共用不可延續)主題訂閱所需要的 JMS 用戶端 ID。如果應用程式正在執行可延續(和共用不可延續)的發佈/訂閱傳訊,就需要這個 ID。 |
durableSubscriptionHome | string | defaultME | 可延續訂閱的起始位置是定義需要與其建立連線的 ME 名稱。 |
nonPersistentMapping |
| ExpressNonPersistent | 這個 Connection Factory 所傳送之非持續性 JMS 訊息所適用的可靠性。 ReliableNonPersistent ReliableNonPersistent ExpressNonPersistent ExpressNonPersistent BestEffortNonPersistent BestEffortNonPersistent |
persistentMapping |
| ReliablePersistent | 套用在這個 Connection Factory 所傳送的持續性 JMS 訊息之可靠性。 ReliablePersistent ReliablePersistent AssuredPersistent AssuredPersistent |
readAhead |
| Default | 先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。 AlwaysOn AlwaysOn AlwaysOff AlwaysOff Default Default |
temporaryTopicNamePrefix | string | temp | 使用這個 Topic Connection Factory 的應用程式所建立的暫時主題所使用之字首(最多 12 個字元)。 |
password | 可逆的編碼密碼(字串) | 建議使用儲存器管理的鑑別別名,而非配置這個內容。 | |
remoteServerAddress | string | 用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。 | |
shareDurableSubscription | string | 控制連線是否可以共用可延續訂閱。 | |
targetTransportChain | string | 傳輸鏈指定與完整設定檔伺服器中的服務整合匯流排通訊時所能使用的通訊協定。 | |
userName | string | 建議使用儲存器管理的鑑別別名,而非配置這個內容。 |
WebSphere MQ JMS Topic Connection Factory
Name | Type | Default | Description |
---|---|---|---|
port | int Min: 1 | 1414 | 佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。 |
providerVersion |
| unspecified | 應用程式準備連接的佇列管理程式的版本、版次、修正層次和修正套件。 unspecified unspecified 6 6 7 7 |
shareConvAllowed | boolean | true | 如果通道定義相符,從相同程序到相同佇列管理程式,用戶端連線是否能夠與其他最上層的 JMS 連線共用它的 Socket |
targetClientMatching | boolean | true | 傳送給送入訊息的 JMSReplyTo 標頭欄位所識別之佇列的回覆訊息,是否只在送入訊息有 MQRFH2 標頭時,才會有 MQRFH2 標頭。 |
transportType |
| CLIENT | 佇列管理程式連線使用用戶端模式或連結模式。如果指定了 BINDINGS_THEN_CLIENT 值,資源配接器會先嘗試在連結模式之下建立連線。如果這個連線失敗,便嘗試建立用戶端模式連線。 BINDINGS BINDINGS CLIENT CLIENT |
CCSID | int Min: 1 | 819 | 連線的編碼字集 ID。 |
failIfQuiesce | boolean | true | 如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。 |
headerCompression |
| NONE | 連線上壓縮標頭資料所能使用的技術清單 SYSTEM SYSTEM NONE NONE |
messageCompression |
| NONE | 連線上壓縮訊息資料所能使用的技術清單。 RLE RLE NONE NONE |
rescanInterval | 精準度是毫秒的時間量 | 5s | 當點對點網域中的訊息消費者利用訊息選取元來選取要接收的訊息時,適用於 JMS 的 WebSphere MQ 類別會依照佇列的 MsgDeliverySequence 屬性所決定的順序來搜尋 WebSphere MQ 佇列,尋找適當的訊息. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
sslResetCount | int Min: 0 Max: 999999999 | 0 | 在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數。 |
cleanupLevel |
| SAFE | 基於分配管理系統的訂閱商店的清除層次。 NONDUR NONDUR FORCE FORCE SAFE SAFE NONE NONE STRONG STRONG |
cloneSupport |
| DISABLED | 是否能夠同時執行相同可延續主題訂閱者的兩個或更多實例。 DISABLED DISABLED ENABLED ENABLED |
messageSelection |
| CLIENT | 決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。 BROKER BROKER CLIENT CLIENT |
pubAckInterval | int Min: 0 | 25 | 在適用於 JMS 的 WebSphere MQ 類別要求來自分配管理系統的確認通知之前,發佈者所發佈的訊息數目。 |
sparseSubscriptions | boolean | false | 控制 TopicSubscriber 物件的訊息擷取原則。 |
statusRefreshInterval | 精準度是毫秒的時間量 | 1m | 長時間執行且會偵測訂閱者何時遺失其佇列管理程式連線的交易的重新整理間隔(毫秒)。只有在 SUBSTORE 值是 QUEUE 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
subscriptionStore |
| BROKER | 決定適用於 JMS 的 WebSphere MQ 類別對於作用中訂閱之相關持續資料的儲存位置。 BROKER BROKER MIGRATE MIGRATE QUEUE QUEUE |
wildcardFormat |
| TOPIC | 要使用的萬用字元語法版本。 CHAR CHAR TOPIC TOPIC |
applicationName | string | 應用程式向佇列管理程式登錄的名稱。 | |
ccdtURL | string | 這個 URL 用來識別包含用戶端通道定義表 (CCDT) 的檔案名稱和位置,同時也指定檔案的存取方式。 | |
channel | string | 要使用的 MQI 通道的名稱。 | |
clientId | string | 連線的用戶端 ID | |
connectionNameList | string | 用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。 | |
hostName | string | 佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。 | |
password | 可逆的編碼密碼(字串) | 建立佇列管理程式連線時,要使用的預設密碼。(建議使用儲存器管理的鑑別別名,而非配置這個內容) | |
queueManager | string | 要連接的佇列管理程式名稱 | |
tempTopicPrefix | string | 當建立暫時主題時,JMS 會產生格式為 TEMP/TEMPTOPICPREFIX/unique_id 的主題字串,如果這個內容保留預設值,就只有 TEMP/unique_id。指定不是空白的 TEMPTOPICPREFIX,會容許定義特定的模型佇列,以便建立訂閱者對於這個連線之下所建立之暫時主題的受管理佇列。 | |
userName | string | 建立佇列管理程式連線時,要使用的預設使用者名稱。(建議使用儲存器管理的鑑別別名,而非配置這個內容) | |
localAddress | string | 對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。 | |
pollingInterval | 精準度是毫秒的時間量 | 如果階段作業內每個訊息接聽器的佇列上都沒有適當的訊息,這個值便是每個訊息接聽器在重新嘗試從它的佇列取得訊息之前,所經歷的間隔上限(毫秒)。如果經常出現階段作業中任何訊息接聽器都沒有適當訊息的情況,請考慮增加這個內容的值。只有在 TRANSPORT 參數值是 BIND 或 CLIENT 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 | |
sendCheckCount | int Min: 0 | 在單一非交易 JMS 階段作業內,在檢查非同步放置錯誤之間,所容許的傳送呼叫數目。 | |
sslCertStores | string | 保存憑證撤銷清冊 (CRL) 以用於 SSL 連線的「輕量型目錄存取通訊協定 (LDAP)」伺服器。 | |
sslCipherSuite | string | 用於 SSL 連線的 CipherSuite。 | |
sslFipsRequired | boolean | SSL 連線是否必須使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 所支援的 CipherSuite。 | |
sslPeerName | string | 對於 SSL 連線,這是用來檢查佇列管理程式提供的數位憑證其中之識別名稱的範本。 | |
brokerCCSubQueue | string | 連線消費者接收不可延續訂閱訊息的來源佇列名稱 | |
brokerControlQueue | string | 分配管理系統控制佇列的名稱 | |
brokerPubQueue | string | 已發佈之訊息所送往的佇列名稱(串流名稱)。 | |
brokerQueueManager | string | 分配管理系統執行所在的佇列管理程式名稱 | |
brokerSubQueue | string | 不可延續訊息消費者接收訊息的來源佇列名稱 | |
brokerVersion |
| 使用中的分配管理系統版本 1 1 2 2 | |
cleanupInterval | 精準度是毫秒的時間量 | 在背景執行發佈/訂閱清理公用程式的間隔(毫秒)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 | |
receiveExit | string | 識別一個通道接收結束程式,或要連續執行的一系列接收結束程式。 | |
receiveExitInit | string | 當呼叫通道接收結束程式時,傳給通道接收結束程式的使用者資料 | |
securityExit | string | 識別通道安全結束程式 | |
securityExitInit | string | 當呼叫通道安全結束程式時,傳給通道安全結束程式的使用者資料 | |
sendExit | string | 識別一個通道傳送結束程式,或要連續執行的一系列傳送結束程式。 | |
sendExitInit | string | 當呼叫通道傳送結束程式時,傳給通道傳送結束程式的使用者資料。 | |
arbitraryProperties | string | 指定它處未定義之內容的能力 |