jmsActivationSpec - JMS 啟動規格 (jmsActivationSpec)

定義 JMS 啟動規格配置。

NameTypeDefaultDescription
idstring唯一的配置 ID。
authDataRef最上層 authData 元素的參照(字串)。啟動規格的預設鑑別資料。
maxEndpointsint
Min: 0
500能夠分派至的端點數目上限。
autoStartbooleantrue配置此啟動規格相關聯的訊息端點要自動啟動,還是需要使用回復指令來手動啟動。

authData

啟動規格的預設鑑別資料。

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

properties.wasJms

JMS 啟動規格關聯於一或多個訊息驅動 Bean,負責提供它們接收訊息所需要的配置。

NameTypeDefaultDescription
acknowledgeMode
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledge確認模式指出,應該確認訊息驅動 Bean 接收訊息的方式。
Auto-acknowledge
Auto-acknowledge
Dups-ok-acknowledge
Dups-ok-acknowledge
busNamestringdefaultBus當連接到完整設定檔伺服器中的服務整合匯流排時,匯流排的名稱。
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.Queue目的地的類型,javax.jms.Queue 或 javax.jms.Topic。
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
maxConcurrencyint
Min: 1

Max: 2147483647
5訊息並行遞送的端點數目上限。增加數目可改良效能,但是也會增加在指定時間使用中的執行緒數目。如果必須保留所有失敗遞送的訊息順序,請將並行端點上限值設為 1。
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
Default先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
retryInterval精準度是秒鐘的時間量30s兩次嘗試連接至傳訊引擎之間的延遲 (以秒為單位),同時適用於起始連線及任何要建立較佳連線的後續嘗試。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
subscriptionDurability
  • NonDurableShared
  • Durable
  • DurableShared
  • NonDurable
NonDurableMS 主題的訂閱類型。可以是下列任何值:Durable、DurableShared、NonDurable、NonDurableShared
NonDurableShared
NonDurableShared
Durable
Durable
DurableShared
DurableShared
NonDurable
NonDurable
targetTransportChain
  • InboundBasicMessaging
  • InboundSecureMessaging
InboundBasicMessaging傳輸鏈指定與完整設定檔伺服器中的服務整合匯流排通訊時所能使用的通訊協定。
InboundBasicMessaging
InboundBasicMessaging
InboundSecureMessaging
InboundSecureMessaging
clientIdstring所有連線上的可延續(和共用不可延續)主題訂閱所需要的 JMS 用戶端 ID。如果應用程式正在執行可延續(和共用不可延續)的發佈/訂閱傳訊,就需要這個 ID。
connectionFactoryLookupstring這個內容可用來指定為了管理而定義之 javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory 或 javax.jms.TopicConnectionFactory 物件的查閱名稱,這些物件用來連接可供端點(訊息驅動 Bean)接收訊息的 JMS 提供者。
destinationstringJMS 目的地的參照
destinationLookupstring這個內容可用來指定為了管理而定義之 javax.jms.Queue 或 javax.jms.Topic 物件的查閱名稱,這些物件是定義可供端點(訊息驅動 Bean)接收訊息的 JMS 佇列或主題。
destinationRef最上層 adminObject 元素的參照(字串)。JMS 目的地的參照
maxBatchSizeint
Min: 1

Max: 2147483647
在單一批次中,從傳訊引擎收到的訊息數目上限。
messageSelectorstring用來決定訊息驅動 Bean 接收哪些訊息的 JMS 訊息選取元。其值為一個字串,用來選取可用的訊息子集。
remoteServerAddressstring用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。
shareDurableSubscriptionstring控制連線是否可以共用可延續訂閱。
subscriptionNamestring可延續(和共用不可延續)所需要的訂閱名稱。當使用可延續(和共用不可延續)主題訂閱時的必要欄位。在給定的用戶端 ID 內,這個訂閱名稱必須是唯一的。

properties.wmqJms

WebSphere MQ JMS 啟動規格

NameTypeDefaultDescription
destinationRef最上層 adminObject 元素的參照(字串)。目的地
CCSIDint
Min: 1
819連線的編碼字集 ID。
channelstringSYSTEM.DEF.SVRCONN要使用的 MQI 通道的名稱。
cloneSupport
  • DISABLED
  • ENABLED
DISABLED是否能夠同時執行相同可延續主題訂閱者的兩個或更多實例
DISABLED
DISABLED
ENABLED
ENABLED
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.Queue目的地類型 - javax.jms.Queue 或 javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
headerCompression
  • SYSTEM
  • NONE
NONE連線上壓縮標頭資料所能使用的技術清單
SYSTEM
SYSTEM
NONE
NONE
hostNamestringlocalhost佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
messageCompression
  • RLE
  • NONE
NONE連線上壓縮訊息資料所能使用的技術清單
RLE
RLE
NONE
NONE
pollingInterval精準度是毫秒的時間量5s如果階段作業內每個訊息接聽器的佇列上都沒有適當的訊息,這個值便是每個訊息接聽器在重新嘗試從它的佇列取得訊息之前,所經歷的間隔上限(毫秒)。如果經常出現階段作業中任何訊息接聽器都沒有適當訊息的情況,請考慮增加這個內容的值。只有在 TRANSPORT 參數值是 BIND 或 CLIENT 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
poolTimeout精準度是毫秒的時間量5m未用的伺服器階段作業在伺服器階段作業儲存區中保持開啟狀態的時間(毫秒),之後,便因為不作用而予以關閉. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
portint
Min: 1
1414佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。
providerVersion
  • unspecified
  • 6
  • 7
unspecified應用程式準備連接的佇列管理程式的版本、版次、修正層次和修正套件。
unspecified
unspecified
6
6
7
7
rescanInterval精準度是毫秒的時間量5s當點對點網域中的訊息消費者利用訊息選取元來選取要接收的訊息時,適用於 JMS 的 WebSphere MQ 類別會依照佇列的 MsgDeliverySequence 屬性所決定的順序來搜尋 WebSphere MQ 佇列,尋找適當的訊息。當適用於 JMS 的 WebSphere MQ 類別找到適當的訊息,且將它遞送給消費者,適用於 JMS 的 WebSphere MQ 類別會從它在佇列中的現行位置,繼續搜尋下一個適當的訊息。適用於 JMS 的 WebSphere MQ 類別會依照這個方式來搜尋佇列,直到抵達佇列尾端,或這個內容值所決定的時間間隔(毫秒)到期。不論是哪個情況,適用於 JMS 的 WebSphere MQ 類別都會返回佇列開頭來繼續搜尋,這時也開始了下一輪的時間間隔。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
shareConvAllowedbooleantrue如果通道定義相符,從相同程序到相同佇列管理程式,用戶端連線是否能夠與其他最上層的 JMS 連線共用它的 Socket
startTimeout精準度是毫秒的時間量10s配置必須開始執行的期間(毫秒). 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
transportType
  • BINDINGS
  • CLIENT
CLIENT佇列管理程式連線使用用戶端模式或連結模式。
BINDINGS
BINDINGS
CLIENT
CLIENT
failIfQuiescebooleantrue如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。
maxMessagesint
Min: 0
1每次能夠指派給伺服器階段作業的訊息數目上限。如果啟動規格是在 XA 交易中將訊息交付給 MDB,不論這個內容設定為何,都會使用 1 值。
maxPoolDepthint
Min: 0
10啟動規格上的 maxPoolDepth 內容,定義可用的 MDB(訊息驅動 Bean)實例數目。降低這個內容的值會減少可同時遞送的訊息數目。
messageSelection
  • BROKER
  • CLIENT
CLIENT決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。
BROKER
BROKER
CLIENT
CLIENT
receiveCCSIDint
Min: 0
0設定佇列管理程式訊息轉換之目標編碼字集 ID 的目的地內容。除非 RECEIVECONVERSION 設為 WMQ_RECEIVE_CONVERSION_QMG,否則會忽略這個值
receiveConversion
  • QMGR
  • CLIENT_MSG
CLIENT_MSG決定佇列管理程式是否執行資料轉換的目的地內容。
QMGR
QMGR
CLIENT_MSG
CLIENT_MSG
sslResetCountint
Min: 0

Max: 999999999
0在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFE基於分配管理系統的訂閱商店的清除層次。
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
sparseSubscriptionsbooleanfalse控制 TopicSubscriber 物件的訊息擷取原則
statusRefreshInterval精準度是毫秒的時間量1m長時間執行且會偵測訂閱者何時遺失其佇列管理程式連線的交易的重新整理間隔(毫秒)。只有在 subscriptionStore 值是 QUEUE 時,這個內容才相關。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
subscriptionStore
  • BROKER
  • MIGRATE
  • QUEUE
BROKER決定適用於 JMS 的 WebSphere MQ 類別對於作用中訂閱之相關持續資料的儲存位置
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPIC要使用的萬用字元語法版本。
CHAR
CHAR
TOPIC
TOPIC
applicationNamestring應用程式向佇列管理程式登錄的名稱。
ccdtURLstring這個 URL 用來識別包含用戶端通道定義表 (CCDT) 的檔案名稱和位置,同時也指定檔案的存取方式。
clientIdstring連線的用戶端 ID
connectionNameListstring用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。
localAddressstring對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。
messageBatchSizeint
Min: 0
單一批次所處理的訊息數目上限。
queueManagerstring要連接的佇列管理程式名稱
subscriptionDurability
  • Durable
  • NonDurable
在遞送訊息給 MDB 主題訂閱時,要使用可延續或不可延續訂閱
Durable
Durable
NonDurable
NonDurable
subscriptionNamestring可延續訂閱的名稱
messageRetentionboolean連線消費者是否要將無用的訊息保留在輸入佇列中
messageSelectorstring決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。當 brokerVersion 的值是 1 時,不支援分配管理系統選擇訊息
sslCertStoresstring保存憑證撤銷清冊 (CRL) 以用於 SSL 連線的「輕量型目錄存取通訊協定 (LDAP)」伺服器
sslCipherSuitestring用於 SSL 連線的 CipherSuite
sslFipsRequiredbooleanSSL 連線是否必須使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 所支援的 CipherSuite。
sslPeerNamestring對於 SSL 連線,這是用來檢查佇列管理程式提供的數位憑證其中之識別名稱的範本
brokerCCDurSubQueuestring針對 ConnectionConsumer 而從其中擷取不可延續訂閱訊息的佇列名稱
brokerCCSubQueuestring連線消費者接收不可延續訂閱訊息的來源佇列名稱
brokerControlQueuestring分配管理系統控制佇列的名稱
brokerPubQueuestring已發佈之訊息所送往的佇列名稱(串流名稱)
brokerQueueManagerstring分配管理系統執行所在的佇列管理程式名稱
brokerSubQueuestring不可延續訊息消費者接收訊息的來源佇列名稱
brokerVersion
  • 1
  • 2
使用中的分配管理系統版本
1
1
2
2
cleanupInterval精準度是毫秒的時間量在背景執行發佈/訂閱清理公用程式的間隔(毫秒)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
receiveExitstring識別一個通道接收結束程式,或要連續執行的一系列接收結束程式。
receiveExitInitstring當呼叫通道接收結束程式時,傳給通道接收結束程式的使用者資料
securityExitstring識別通道安全結束程式
securityExitInitstring當呼叫通道安全結束程式時,傳給通道安全結束程式的使用者資料
sendExitstring識別一個通道傳送結束程式,或要連續執行的一系列傳送結束程式
sendExitInitstring當呼叫通道傳送結束程式時,傳給通道傳送結束程式的使用者資料