定義 JMS 啟動規格配置。
Name | Type | Default | Description |
---|---|---|---|
id | string | 唯一的配置 ID。 | |
authDataRef | 最上層 authData 元素的參照(字串)。 | 啟動規格的預設鑑別資料。 | |
maxEndpoints | int Min: 0 | 500 | 能夠分派至的端點數目上限。 |
autoStart | boolean | true | 配置此啟動規格相關聯的訊息端點要自動啟動,還是需要使用回復指令來手動啟動。 |
啟動規格的預設鑑別資料。
Name | Type | Default | Description |
---|---|---|---|
user | string | 連接至 EIS 時要使用的使用者名稱。 | |
password | 可逆的編碼密碼(字串) | 連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。 |
JMS 啟動規格關聯於一或多個訊息驅動 Bean,負責提供它們接收訊息所需要的配置。
Name | Type | Default | Description |
---|---|---|---|
acknowledgeMode |
| Auto-acknowledge | 確認模式指出,應該確認訊息驅動 Bean 接收訊息的方式。 Auto-acknowledge Auto-acknowledge Dups-ok-acknowledge Dups-ok-acknowledge |
busName | string | defaultBus | 當連接到完整設定檔伺服器中的服務整合匯流排時,匯流排的名稱。 |
destinationType |
| javax.jms.Queue | 目的地的類型,javax.jms.Queue 或 javax.jms.Topic。 javax.jms.Queue javax.jms.Queue javax.jms.Topic javax.jms.Topic |
maxConcurrency | int Min: 1 Max: 2147483647 | 5 | 訊息並行遞送的端點數目上限。增加數目可改良效能,但是也會增加在指定時間使用中的執行緒數目。如果必須保留所有失敗遞送的訊息順序,請將並行端點上限值設為 1。 |
readAhead |
| Default | 先讀是一種事先將訊息指派給消費者的最佳化。如此可讓處理消費者要求的速度會更快。 AlwaysOn AlwaysOn AlwaysOff AlwaysOff Default Default |
retryInterval | 精準度是秒鐘的時間量 | 30s | 兩次嘗試連接至傳訊引擎之間的延遲 (以秒為單位),同時適用於起始連線及任何要建立較佳連線的後續嘗試。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
subscriptionDurability |
| NonDurable | MS 主題的訂閱類型。可以是下列任何值:Durable、DurableShared、NonDurable、NonDurableShared NonDurableShared NonDurableShared Durable Durable DurableShared DurableShared NonDurable NonDurable |
targetTransportChain |
| InboundBasicMessaging | 傳輸鏈指定與完整設定檔伺服器中的服務整合匯流排通訊時所能使用的通訊協定。 InboundBasicMessaging InboundBasicMessaging InboundSecureMessaging InboundSecureMessaging |
clientId | string | 所有連線上的可延續(和共用不可延續)主題訂閱所需要的 JMS 用戶端 ID。如果應用程式正在執行可延續(和共用不可延續)的發佈/訂閱傳訊,就需要這個 ID。 | |
connectionFactoryLookup | string | 這個內容可用來指定為了管理而定義之 javax.jms.ConnectionFactory、javax.jms.QueueConnectionFactory 或 javax.jms.TopicConnectionFactory 物件的查閱名稱,這些物件用來連接可供端點(訊息驅動 Bean)接收訊息的 JMS 提供者。 | |
destination | string | JMS 目的地的參照 | |
destinationLookup | string | 這個內容可用來指定為了管理而定義之 javax.jms.Queue 或 javax.jms.Topic 物件的查閱名稱,這些物件是定義可供端點(訊息驅動 Bean)接收訊息的 JMS 佇列或主題。 | |
destinationRef | 最上層 adminObject 元素的參照(字串)。 | JMS 目的地的參照 | |
maxBatchSize | int Min: 1 Max: 2147483647 | 在單一批次中,從傳訊引擎收到的訊息數目上限。 | |
messageSelector | string | 用來決定訊息驅動 Bean 接收哪些訊息的 JMS 訊息選取元。其值為一個字串,用來選取可用的訊息子集。 | |
remoteServerAddress | string | 用來連接引導伺服器的遠端伺服器位址,含有用逗點來區隔的 Triplet,語法是 hostName:portNumber:chainName。例如 Merlin:7276:BootstrapBasicMessaging。如果沒有指定 hostName,則預設值為 localhost。如果沒有指定 portNumber,則預設值為 7276。如果沒有指定 chainName,則預設值為 BootstrapBasicMessaging。如需相關資訊,請參閱資訊中心。 | |
shareDurableSubscription | string | 控制連線是否可以共用可延續訂閱。 | |
subscriptionName | string | 可延續(和共用不可延續)所需要的訂閱名稱。當使用可延續(和共用不可延續)主題訂閱時的必要欄位。在給定的用戶端 ID 內,這個訂閱名稱必須是唯一的。 |
WebSphere MQ JMS 啟動規格
Name | Type | Default | Description |
---|---|---|---|
destinationRef | 最上層 adminObject 元素的參照(字串)。 | 目的地 | |
CCSID | int Min: 1 | 819 | 連線的編碼字集 ID。 |
channel | string | SYSTEM.DEF.SVRCONN | 要使用的 MQI 通道的名稱。 |
cloneSupport |
| DISABLED | 是否能夠同時執行相同可延續主題訂閱者的兩個或更多實例 DISABLED DISABLED ENABLED ENABLED |
destinationType |
| javax.jms.Queue | 目的地類型 - javax.jms.Queue 或 javax.jms.Topic javax.jms.Queue javax.jms.Queue javax.jms.Topic javax.jms.Topic |
headerCompression |
| NONE | 連線上壓縮標頭資料所能使用的技術清單 SYSTEM SYSTEM NONE NONE |
hostName | string | localhost | 佇列管理程式所在系統的主機名稱或 IP 位址。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。 |
messageCompression |
| 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 秒。 |
port | int Min: 1 | 1414 | 佇列管理程式用來接聽的埠。當指定 ConnectionNameList 內容時,它會取代 hostname 和 port 內容。 |
providerVersion |
| 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 秒。 |
shareConvAllowed | boolean | true | 如果通道定義相符,從相同程序到相同佇列管理程式,用戶端連線是否能夠與其他最上層的 JMS 連線共用它的 Socket |
startTimeout | 精準度是毫秒的時間量 | 10s | 配置必須開始執行的期間(毫秒). 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
transportType |
| CLIENT | 佇列管理程式連線使用用戶端模式或連結模式。 BINDINGS BINDINGS CLIENT CLIENT |
failIfQuiesce | boolean | true | 如果佇列管理程式在靜止狀態中,某些方法呼叫是否會失敗。 |
maxMessages | int Min: 0 | 1 | 每次能夠指派給伺服器階段作業的訊息數目上限。如果啟動規格是在 XA 交易中將訊息交付給 MDB,不論這個內容設定為何,都會使用 1 值。 |
maxPoolDepth | int Min: 0 | 10 | 啟動規格上的 maxPoolDepth 內容,定義可用的 MDB(訊息驅動 Bean)實例數目。降低這個內容的值會減少可同時遞送的訊息數目。 |
messageSelection |
| CLIENT | 決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。 BROKER BROKER CLIENT CLIENT |
receiveCCSID | int Min: 0 | 0 | 設定佇列管理程式訊息轉換之目標編碼字集 ID 的目的地內容。除非 RECEIVECONVERSION 設為 WMQ_RECEIVE_CONVERSION_QMG,否則會忽略這個值 |
receiveConversion |
| CLIENT_MSG | 決定佇列管理程式是否執行資料轉換的目的地內容。 QMGR QMGR CLIENT_MSG CLIENT_MSG |
sslResetCount | int Min: 0 Max: 999999999 | 0 | 在重新協議 SSL 所用的秘密金鑰之前,SSL 連線所傳送和接收的位元組總數 |
cleanupLevel |
| SAFE | 基於分配管理系統的訂閱商店的清除層次。 NONDUR NONDUR FORCE FORCE SAFE SAFE NONE NONE STRONG STRONG |
sparseSubscriptions | boolean | false | 控制 TopicSubscriber 物件的訊息擷取原則 |
statusRefreshInterval | 精準度是毫秒的時間量 | 1m | 長時間執行且會偵測訂閱者何時遺失其佇列管理程式連線的交易的重新整理間隔(毫秒)。只有在 subscriptionStore 值是 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) 的檔案名稱和位置,同時也指定檔案的存取方式。 | |
clientId | string | 連線的用戶端 ID | |
connectionNameList | string | 用於通訊的 TCP/IP 連線名稱 (hostname(port)) 清單。ConnectionNameList 取代 hostname 和 port 內容。 | |
localAddress | string | 對於佇列管理程式連線,這個內容指定下列兩項或其中之一,(1) 要用的本端網路介面,(2) 要用的本端埠或本端埠範圍。 | |
messageBatchSize | int Min: 0 | 單一批次所處理的訊息數目上限。 | |
queueManager | string | 要連接的佇列管理程式名稱 | |
subscriptionDurability |
| 在遞送訊息給 MDB 主題訂閱時,要使用可延續或不可延續訂閱 Durable Durable NonDurable NonDurable | |
subscriptionName | string | 可延續訂閱的名稱 | |
messageRetention | boolean | 連線消費者是否要將無用的訊息保留在輸入佇列中 | |
messageSelector | string | 決定訊息選擇是由適用於 JMS 的 WebSphere MQ 類別或分配管理系統來完成。當 brokerVersion 的值是 1 時,不支援分配管理系統選擇訊息 | |
sslCertStores | string | 保存憑證撤銷清冊 (CRL) 以用於 SSL 連線的「輕量型目錄存取通訊協定 (LDAP)」伺服器 | |
sslCipherSuite | string | 用於 SSL 連線的 CipherSuite | |
sslFipsRequired | boolean | SSL 連線是否必須使用 IBM Java JSSE FIPS 提供者 (IBMJSSEFIPS) 所支援的 CipherSuite。 | |
sslPeerName | string | 對於 SSL 連線,這是用來檢查佇列管理程式提供的數位憑證其中之識別名稱的範本 | |
brokerCCDurSubQueue | string | 針對 ConnectionConsumer 而從其中擷取不可延續訂閱訊息的佇列名稱 | |
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 | 當呼叫通道傳送結束程式時,傳給通道傳送結束程式的使用者資料 |