Service integration custom properties

Use custom properties to configure advanced settings for service integration objects such as messaging engines.

sib.msgstore.cachedDataBufferSize

傳訊引擎用來包含服務品質屬性在最大努力非持續性之上,且保留在資料儲存庫之資料的資料緩衝區大小(位元組)。 預設值為 320000,大約是 320 KB。

快取資料緩衝區的用途,是將傳訊引擎可能需要從資料儲存庫中讀取的資料快取在記憶體中,以便使傳訊引擎的效能最佳化。 當傳訊引擎將資料寫入資料儲存庫,以及從資料儲存庫中讀取資料時,它會試圖將資料新增到快取的資料緩衝區中。 傳訊引擎可能會捨棄已在緩衝區的資料,將空間讓出來。

資料類型 預設值
位元組 40000000

sib.msgstore.discardableDataBufferSize

傳訊引擎用來包含服務品質屬性是最大努力非持續性之資料的資料緩衝區大小(位元組)。 預設值為 320000,大約是 320 KB。

可捨棄的資料緩衝區包含所有服務品質屬性是最大努力非持續性的資料。 這個資料包含作用中的交易所涉及的資料,以及傳訊引擎既未消費,也未捨棄的任何其他最大努力非持續性資料。 傳訊引擎會將這個資料完全存放在這個記憶體緩衝區內,絕不會將資料寫入資料儲存庫中。 當傳訊引擎新增資料到可捨棄的資料緩衝區時,比方說,當傳訊引擎收到用戶端的最大努力非持續性訊息時,傳訊引擎可能會捨棄已在緩衝區中的資料來讓出空間。 傳訊引擎只能捨棄作用中的交易所未涉及的資料。 這個行為使傳訊引擎能夠捨棄最大努力非持續性訊息。

增加可捨棄的資料緩衝區大小,可在傳訊引擎開始捨棄訊息之前,處理更多的最大努力非持續性資料。

如果傳訊引擎試圖將資料新增到可捨棄的資料緩衝區,但在捨棄作用中的交易所未涉及的所有資料之後,空間仍不足,傳訊引擎會擲出 com.ibm.ws.sib.msgstore.OutOfCacheSpace 異常狀況。 用戶端應用程式可以捕捉這個異常狀況,將它包裝在特定 API 專用的異常狀況內,如 javax.jms.JMSException。

資料類型 預設值
位元組 1280000

sib.msgstore.jdbcFailoverOnDBConnectionLoss

內容可以決定萬一與資料儲存庫失去連線時,傳訊引擎及其主伺服器的行為。

內容值 失去資料儲存庫連線時的行為
true(預設值)
下次進行核心群組服務作用中檢查時,高可用性管理程式會停止傳訊引擎及其主應用程式伺服器(預設值為 120 秒)。 如果節點代理程式正在監視伺服器,而且您已在伺服器的監視原則啟用了自動重新啟動,則伺服器就會重新啟動。 一旦有適當的伺服器可以使用時,就會啟動傳訊引擎。
Note: 可靠性層次低於確定持續性的訊息,在作用中檢查間隔之間,有可能會被傳訊引擎接受,也有可能會遺失。
false

傳訊引擎會繼續執行並接受工作,並且定期與資料儲存庫重新連線。 如果工作繼續被提交到傳訊引擎,而資料儲存庫卻無法使用時,可能會發生無法預期的結果,而且當資料儲存庫連線還原時,傳訊引擎可能會呈現不一致的狀態。

Note: 如果工作繼續被提交到傳訊引擎的話,就連非持續性的傳訊都有可能失敗,因為傳訊引擎可能會用到資料儲存庫(例如,用它來配置唯一 ID 給訊息),或者將非持續性的訊息移出記憶體外。

sib.msgstore.jdbcInitialDatasourceWaitTimeout

等待資料儲存庫生效的時間(毫秒)。 這個時間包含與資料庫建立連線以及取得必要表格鎖定所需的時間。

資料類型 預設值
毫秒 900000(15 分鐘)

sib.msgstore.jdbcResAuthForConnections

在共用連線時所用的傳訊引擎資源授權機制。 預設值是「儲存器」。

資料類型 預設值
字串 儲存器

sib.msgstore.jdbcStaleConnectionRetryDelay

在嘗試連接資料儲存庫之間等待的時間(毫秒)。

比方說,如果您將 sib.msgstore.jdbcInitialDataso­urceWaitTimeout 內容設為 600000,而將 sib.msgstore.jdbcStaleConnecti­onRetryDelay 內容設為 3000,則傳訊引擎便會每隔 3 秒連線一次,並持續這樣做長達 10 分鐘。

資訊
資料類型 毫秒
預設值 2000(2 秒)

sib.meEnableInstanceOnFailure

此內容會決定在傳訊引擎與資料儲存庫失去連線時,是否必須自動重新啟用已停用的傳訊引擎。

比方說,如果您將 sib.meEnableInstanceOnFailure 內容值設為 true,則已停用的傳訊引擎會在 30 秒之後嘗試啟用本身。

資訊
資料類型 布林
預設值 True

sib.processor.maxReconstituteThreadpoolSize

指定當啟動傳訊引擎時,用來並行載入目標的執行緒數目。如果資料庫不支援多個執行緒並行執行多個讀取作業,您可以將內容值設為 1,以便可以避免執行緒之間發生競爭。

資訊
資料類型 整數
預設值 系統中存在的核心數目。

sib.msgstore.storeFullWaitForCheckPoint

This property determines the action a messaging engine takes when a file store is full and applications try to send further messages.

When a file store is full, the messaging engine carries out a checkpoint of the log file to reconcile all message sends and receives since the last checkpoint. This process might take some time to complete. Between the time when the file store becomes full and the time when the checkpoint is complete, if applications try to send a message, the messaging engine throws the exception ObjectStoreFullException and issues message CWSOM1042E.

When an application thread that is sending a message finds that the file store is full, it requests a checkpoint. The default behavior, with the property value set to false, is that the application thread then throws the exception ObjectStoreFullException to the application immediately and returns. You can select an alternative behavior by setting the property value to true. With this property value, the application thread does not throw the exception, but waits until the checkpoint has completed. If the checkpoint frees space in the file store, the application thread proceeds and sends the messages before returning. If the file store is still full after the checkpoint, the application thread throws the exception to the application.

Set the property value to true, and make application threads wait for the checkpoint to be completed, if your applications delete all the messages in the file store, and so they logically know that the file store is no longer full. Although the applications must still wait until the checkpoint is complete, they do not receive exceptions while the checkpoint is being carried out, and they do not have to retry the send.

Information Value
資料類型 Boolean
預設值 False

sib.msgstore.transactionSendLimit

傳訊引擎併入各項交易的作業數目上限。 比方說,每項 JMS 傳送或接收作業都是在交易傳送限制內計算的作業。 預設值為 100

資料類型 預設值
整數 100
[z/OS]

sib.ra.zosMessageLockTimeout

訊息在傳訊引擎中鎖定的秒數,之後,就將訊息提交給 z/OS® 的「工作量管理 (WLM)」,以便遞送到訊息驅動 Bean。

WLM 會將訊息配置給服務者區域,而服務者區域會建立一個傳訊引擎連線。 之後,服務者區域會消費訊息,將訊息傳遞給訊息區動 Bean 的 onMessage 方法。

如果服務者區域連接傳訊引擎失敗,且在訊息傳給訊息驅動 Bean 之前消費訊息,訊息就會保持鎖定,直到過了逾時值。 達到逾時值之後,訊息就會解除鎖定,且會重試遞送訊息。

在應用程式伺服器啟動期間,如果 WLM 將訊息遞送到服務者區域,但連接傳訊引擎所需要的基礎架構還無法使用,服務者區域連接傳訊引擎就可能失敗。 在服務者區域的工作日誌中,會由 CWSIV1052W 項目來指出這類型的連線失敗。 如果您在工作日誌中看到這些項目,且您已鎖定訊息,請考慮利用這個內容來縮短「訊息鎖定逾時」。

資料類型 預設值
300

sib.trm.retry

傳訊引擎至傳訊引擎的連線重試間隔(秒)。 重試間隔是嘗試聯繫彼此之間有通訊存在之鄰接傳訊引擎的間隔時間。 預設重試間隔是 30 秒。

資料類型 預設值
30

sib.wsrm.tokenLockTimeout

This property affects WS-ReliableMessaging managed qualities of service. Set this property on the messaging engine that is specified in the policy binding for the WS-ReliableMessaging application.

This property is the amount of time, in milliseconds, that a lock is held on a WS-ReliableMessaging message. If a server fails while processing a message, the lock is released at the end of this timeout period, so that other servers can continue the processing. If the original server recovers before the timeout period ends, it continues processing the message. The lock is released at the end of the timeout period even if the message is still being processed.

If your system is processing large messages, you might want to increase the value of this property. For example, if a message takes 12 minutes to process, the lock is released 2 minutes before processing is complete. To avoid this situation, change the property to a value that is greater than 12 minutes.

If your system is processing small messages, you might want to decrease the value of this property, so that if a failure occurs the lock is released more quickly, and other servers can continue the processing without delay.

[z/OS]Note:

If a servant region ends abnormally while processing a message, the control region starts a new servant region, which must wait for the message lock to be released before it can continue processing the message. If the servant region is inactive for too long, the control region ends it and starts another servant region. Also, if the servant region takes a long time to process a message, the control region might perceive the servant region to be inactive, and end it.

The amount of time that a servant region can remain inactive until the control region ends it is affected by various timeouts, such as the control_region_wlm_dispatch_timeout property. Examine the configuration of your system to determine what this period of time is for that system.

To avoid the control region ending the servant region before the message has been processed, set the value of the token lock timeout property to be less than the amount of time that the servant region can be inactive.

Information Value
資料類型 Milliseconds
預設值 600000 (10 minutes)

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



時間戳記圖示 前次更新: July 9, 2016 11:12
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_custom_props
檔名:rjj_custom_props.html