JMS 主題 Connection Factory (jmsTopicConnectionFactory)

定義 JMS 主題 Connection Factory 配置。

屬性名稱 資料類型 預設值 說明
connectionManagerRef 最上層 connectionManager 元素的參照(字串)。   Connection Factory 的連線管理程式。
containerAuthDataRef 最上層 authData 元素的參照(字串)。   儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。
id string   唯一的配置 ID。
jndiName string   資源的 JNDI 名稱。
recoveryAuthDataRef 最上層 authData 元素的參照(字串)。   交易回復的鑑別資料。
connectionManager
說明:Connection Factory 的連線管理程式。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
agedTimeout 精準度是秒鐘的時間量 -1 可透過儲存區維護來捨棄實體連線之前所經歷的時間量。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
connectionTimeout 精準度是秒鐘的時間量 30s 連線要求逾時之前所經歷的時間量。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
maxConnectionsPerThread int

下限:0

  限制每一個執行緒上的開啟連線數目。
maxIdleTime 精準度是秒鐘的時間量 30m 儲存區維護期間可以捨棄未用或閒置連線之前所經歷的時間量(前提是這麼做,並不會將儲存區減少至低於大小下限)。值 -1 表示會停用此逾時。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
maxPoolSize int

下限:0

50 儲存區的實體連線數目上限。值 0 表示無限制。
minPoolSize int

下限:0

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

下限:0

  針對每一個執行緒快取指定數目的連線。
purgePolicy
  • ValidateAllConnections
  • FailingConnectionOnly
  • EntirePool
EntirePool 指定在儲存區中偵測到過時連線時所要毀損的連線。
ValidateAllConnections
當偵測到過時連線時,會測試連線,並關閉所發現的不正確連線。
FailingConnectionOnly
當偵測到過時連線時,只會關閉所發現的不正確連線。
EntirePool
當偵測到過時連線時,儲存區中的所有連線均標示為「過時」,當不再使用時,就會關閉。
reapTime 精準度是秒鐘的時間量 3m 儲存區維護執行緒的執行間隔時間量。值 -1 表示會停用儲存區維護。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
containerAuthData
說明:儲存器管理鑑別的預設鑑別資料,當連結沒有為 res-auth=CONTAINER 的資源參照指定鑑別別名時,就會套用它。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
password 可逆的編碼密碼(字串)   連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。
user string   連接至 EIS 時要使用的使用者名稱。
properties.wasJms
說明:JMS Topic Connection Factory 用來建立通往 JMS 目的地之相關 JMS 提供者的連線,供發佈/訂閱傳訊使用。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
busName string defaultBus 當連接到完整設定檔伺服器中的服務整合匯流排時,匯流排的名稱。
clientID string clientID 所有連線上的可延續(和共用不可延續)主題訂閱所需要的 JMS 用戶端 ID。如果應用程式正在執行可延續(和共用不可延續)的發佈/訂閱傳訊,就需要這個 ID。
durableSubscriptionHome string defaultME 可延續訂閱的起始位置是定義需要與其建立連線的 ME 名稱。
nonPersistentMapping
  • BestEffortNonPersistent
  • ReliableNonPersistent
  • ExpressNonPersistent
ExpressNonPersistent 這個 Connection Factory 所傳送之非持續性 JMS 訊息所適用的可靠性。
BestEffortNonPersistent
BestEffortNonPersistent
ReliableNonPersistent
ReliableNonPersistent
ExpressNonPersistent
ExpressNonPersistent
password 可逆的編碼密碼(字串)   建議使用儲存器管理的鑑別別名,而非配置這個內容。
persistentMapping
  • AssuredPersistent
  • ReliablePersistent
ReliablePersistent 套用在這個 Connection Factory 所傳送的持續性 JMS 訊息之可靠性。
AssuredPersistent
AssuredPersistent
ReliablePersistent
ReliablePersistent
readAhead
  • AlwaysOff
  • Default
  • AlwaysOn
Default 先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。
AlwaysOff
AlwaysOff
Default
Default
AlwaysOn
AlwaysOn
remoteServerAddress string   用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。
shareDurableSubscription string   控制連線是否可以共用可延續訂閱。
targetTransportChain string   傳輸鏈指定與完整設定檔伺服器中的服務整合匯流排通訊時所能使用的通訊協定。
temporaryTopicNamePrefix string temp 使用這個 Topic Connection Factory 的應用程式所建立的暫時主題所使用之字首(最多 12 個字元)。
userName string   建議使用儲存器管理的鑑別別名,而非配置這個內容。
properties.wmqJms
說明:WebSphere MQ JMS Topic Connection Factory
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
CCSID int

下限:1

819 連線的編碼字集 ID。
applicationName string   應用程式向佇列管理程式登錄的名稱。
arbitraryProperties string   指定它處未定義之內容的能力
brokerCCSubQueue string   連線消費者接收不可延續訂閱訊息的來源佇列名稱
brokerControlQueue string   分配管理系統控制佇列的名稱
brokerPubQueue string   已發佈之訊息所送往的佇列名稱(串流名稱)。
brokerQueueManager string   分配管理系統執行所在的佇列管理程式名稱
brokerSubQueue string   不可延續訊息消費者接收訊息的來源佇列名稱
brokerVersion
  • 2
  • 1
  使用中的分配管理系統版本
2
2
1
1
ccdtURL string   這個 URL 用來識別包含用戶端通道定義表 (CCDT) 的檔案名稱和位置,同時也指定檔案的存取方式。
channel string   要使用的 MQI 通道的名稱。
cleanupInterval 精準度是毫秒的時間量   在背景執行發佈/訂閱清理公用程式的間隔(毫秒)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
cleanupLevel
  • SAFE
  • FORCE
  • NONDUR
  • NONE
  • STRONG
SAFE 基於分配管理系統的訂閱商店的清除層次。
SAFE
SAFE
FORCE
FORCE
NONDUR
NONDUR
NONE
NONE
STRONG
STRONG
clientId string   連線的用戶端 ID
cloneSupport
  • ENABLED
  • DISABLED
DISABLED 是否能夠同時執行相同可延續主題訂閱者的兩個或更多實例。
ENABLED
ENABLED
DISABLED
DISABLED
connectionNameList string   用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。
failIfQuiesce boolean true 如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。
headerCompression
  • SYSTEM
  • NONE
NONE 連線上壓縮標頭資料所能使用的技術清單
SYSTEM
SYSTEM
NONE
NONE
hostName string   佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
localAddress string   對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。
messageCompression
  • RLE
  • NONE
NONE 連線上壓縮訊息資料所能使用的技術清單。
RLE
RLE
NONE
NONE
messageSelection
  • CLIENT
  • BROKER
CLIENT 決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。
CLIENT
CLIENT
BROKER
BROKER
password 可逆的編碼密碼(字串)   建立佇列管理程式連線時,要使用的預設密碼。(建議使用儲存器管理的鑑別別名,而非配置這個內容)
pollingInterval 精準度是毫秒的時間量   如果階段作業內每個訊息接聽器的佇列上都沒有適當的訊息,這個值便是每個訊息接聽器在重新嘗試從它的佇列取得訊息之前,所經歷的間隔上限(毫秒)。如果經常出現階段作業中任何訊息接聽器都沒有適當訊息的情況,請考慮增加這個內容的值。只有在 TRANSPORT 參數值是 BIND 或 CLIENT 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
port int

下限:1

1414 佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
providerVersion
  • 7
  • 6
  • unspecified
unspecified 應用程式準備連接的佇列管理程式的版本、版次、修正層次和修正套件。
7
7
6
6
unspecified
unspecified
pubAckInterval int

下限:0

25 在適用於 JMS 的 WebSphere MQ 類別要求來自分配管理系統的確認通知之前,發佈者所發佈的訊息數目。
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
sparseSubscriptions boolean false 控制 TopicSubscriber 物件的訊息擷取原則。
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

0 在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數。
statusRefreshInterval 精準度是毫秒的時間量 1m 長時間執行且會偵測訂閱者何時遺失其佇列管理程式連線的交易的重新整理間隔(毫秒)。只有在 SUBSTORE 值是 QUEUE 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
subscriptionStore
  • MIGRATE
  • BROKER
  • QUEUE
BROKER 決定適用於 JMS 的 WebSphere MQ 類別對於作用中訂閱之相關持續資料的儲存位置。
MIGRATE
MIGRATE
BROKER
BROKER
QUEUE
QUEUE
targetClientMatching boolean true 傳送給送入訊息的 JMSReplyTo 標頭欄位所識別之佇列的回覆訊息,是否只在送入訊息有 MQRFH2 標頭時,才會有 MQRFH2 標頭。
tempTopicPrefix string   當建立暫時主題時,JMS 會產生格式為 TEMP/TEMPTOPICPREFIX/unique_id 的主題字串,如果這個內容保留預設值,就只有 TEMP/unique_id。指定不是空白的 TEMPTOPICPREFIX,會容許定義特定的模型佇列,以便建立訂閱者對於這個連線之下所建立之暫時主題的受管理佇列。
transportType
  • CLIENT
  • BINDINGS
CLIENT 佇列管理程式連線使用用戶端模式或連結模式。如果指定了 BINDINGS_THEN_CLIENT 值,資源配接器會先嘗試在連結模式之下建立連線。如果這個連線失敗,便嘗試建立用戶端模式連線。
CLIENT
CLIENT
BINDINGS
BINDINGS
userName string   建立佇列管理程式連線時,要使用的預設使用者名稱。(建議使用儲存器管理的鑑別別名,而非配置這個內容)
wildcardFormat
  • CHAR
  • TOPIC
TOPIC 要使用的萬用字元語法版本。
CHAR
CHAR
TOPIC
TOPIC
recoveryAuthData
說明:交易回復的鑑別資料。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
password 可逆的編碼密碼(字串)   連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。
user string   連接至 EIS 時要使用的使用者名稱。

指示主題類型的圖示 參照主題



「時間戳記」圖示 前次更新: 2016 年 11 月 30 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_config_jmsTopicConnectionFactory
檔名:rwlp_config_jmsTopicConnectionFactory.html