訊息接聽器服務自訂內容

請利用這個畫面來檢視或變更訊息接聽器服務的自訂內容。

如果要檢視這個管理主控台頁面,請按一下 伺服器 > 伺服器類型 > WebSphere 應用程式伺服器 > server_name > [通訊] 傳訊 > 訊息接聽器服務 > 自訂內容

您可以使用自訂內容頁面來定義下列內容,供訊息接聽器服務使用。
DYNAMIC.CONFIGURATION.ENABLED

這個內容用來控制是否需要重新啟動建立接聽器埠的應用程式伺服器。 將這個內容設為 true,會啟用動態配置。

資料類型 布林
預設值 False(未選取)
MAX.RECOVERY.RETRIES

這個服務所管理的接聽器埠在放棄並停止之前,嘗試從失敗中回復的次數上限。 停止之後,相關聯的接聽器埠會改成停止狀態。 重試的間隔是使用 RECOVERY.RETRY.INTERVAL 內容來定義。

下列其中一種狀況會導致失敗:
  • 接聽器埠嘗試從 JMS 提供者取得訊息時,發生非預期的錯誤。
  • 已失去應用程式伺服器和 JMS 提供者之間的連線,通常是因為網路發生錯誤。
資料類型 整數
單位 重試次數
預設值 5
範圍 0(不重試)至 2147483647
MQJMS.POOLING.THRESHOLD

儲存區內未用連線的數目上限。

MQSimpleConnectionManager 會以最近使用為基礎來配置連線,以最近最少使用為基礎來毀損連線。 依預設,如果儲存區中有超出 10 個未用連線,就會毀損連線。

資料類型 整數
單位 連線數目
預設值 10
MQJMS.POOLING.TIMEOUT

毀損儲存區中沒有使用的連線之前所經歷的毫秒數。

MQSimpleConnectionManager 會以最近使用為基礎來配置連線,以最近最少使用為基礎來毀損連線。 依預設,如果連線沒有使用達 5 分鐘,就會將它毀損。

資料類型 整數
單位 毫秒
預設值 5 分鐘
NON.ASF.RECEIVE.TIMEOUT

在非 ASF 的作業模式中,訊息驅動 Bean 接聽器階段作業所執行的同步訊息接收逾時值(以毫秒為單位)。

註: 訊息接聽器服務有兩個作業模式: 應用程式伺服器機能 (ASF) 和非應用程式伺服器機能(非 ASF):
  • ASF 模式提供應用程式的並行和交易支援。 對於發佈/訂閱訊息驅動 Bean 而言,ASF 模式提供較好的傳輸量和並行作業,因為在非 ASF 模式中,接聽器是單執行緒作業。
  • 非 ASF 模式主要用來搭配不支援 JMS ASF的協力廠商傳訊提供者,此為 JMS 規格的選用延伸。非 ASF 模式也是交易式,不過,因為路徑長度比 ASF 模式短,效能通常比較好。

如果要針對應用程式伺服器上的所有訊息驅動 Bean 接聽器,啟用非 ASF 作業模式,請為這個內容設定一個非零的值。

[z/OS] 在 z/OS 系統上,無法選取非 ASF 模式,因此不應為這個內容設定非零的值。

資料類型 整數
單位 毫秒
預設值 ASF 模式(不建立自訂內容)
範圍 0 或以上的毫秒數
0
停用非 ASF 模式
一或多次
非 ASF 訊息驅動 Bean 接聽器同步階段作業接收的逾時值(以毫秒為單位)
建議 如果發生交易逾時,訊息就必須再循環,而帶來額外的工作。如果您要使用非 ASF 模式,請將這個內容設定為小於交易逾時值,但大於或等於訊息驅動 Bean onMessage() 方法的最長持續時間。例如,如果您的訊息驅動 Bean 的 onMessage() 方法通常最多花 10 秒,且交易逾時值設定為 120 秒,則 NON.ASF.RECEIVE.TIMEOUT 內容可以設在 110000 毫秒以內(即 110 秒)。
NON.ASF.BMT.ROLLBACK.ENABLED

如果正在使用「非應用程式伺服器機能(非 ASF)」作業模式(基於您將 NON.ASF.RECEIVE.TIMEOUT 內容設為非零的值),且使用 Bean 管理交易的訊息驅動 Bean 產生了執行時期異常狀況,NON.ASF.BMT.ROLLBACK.ENABLED 內容會決定是否要將訊息傳回到目的地。

註: 訊息接聽器服務有兩個作業模式: 應用程式伺服器機能 (ASF) 和非應用程式伺服器機能(非 ASF):
  • ASF 模式提供應用程式的並行和交易支援。 對於發佈/訂閱訊息驅動 Bean 而言,ASF 模式提供較好的傳輸量和並行作業,因為在非 ASF 模式中,接聽器是單執行緒作業。
  • 非 ASF 模式主要用來搭配不支援 JMS ASF的協力廠商傳訊提供者,此為 JMS 規格的選用延伸。非 ASF 模式也是交易式,不過,因為路徑長度比 ASF 模式短,效能通常比較好。

[z/OS] 在 z/OS 系統上,無法選取非 ASF 模式。

當內容設為 false(預設值)時,會先自動確認訊息,再將訊息傳遞至訊息驅動 Bean。

當這個內容設為 true 時,訊息接聽器服務會在順利處理訊息驅動 Bean 之後,傳送訊息確認給用戶端,且訊息接聽器服務會要求回復 Bean 產生異常狀況的任何訊息。

資料類型 布林
預設值 False
RECOVERY.RETRY.INTERVAL

接聽器埠重新嘗試從失敗中回復的間隔秒數。 重試次數上限是使用 MAX.RECOVERY.RETRIES 內容來定義。

下列其中一種狀況會導致失敗:
  • 接聽器埠嘗試從 JMS 提供者取得訊息時,發生非預期的錯誤。
  • 已失去應用程式伺服器和 JMS 提供者之間的連線,通常是因為網路發生錯誤。
資料類型 整數
單位
預設值 60
範圍 1 至 2147483647
SERVER.SESSION.POOL.REAP.TIME

伺服器階段作業儲存區檢查之間的時間(以秒為單位)。如果要啟用伺服器階段作業儲存區監視,請將這個內容設為非負值。

資料類型 整數
單位
預設值 -1(停用)
範圍 -2147483648 至 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT

預設伺服器階段作業儲存區逾時(以秒為單位)。

當這個內容設為非負值時,則會與使用伺服器階段作業以來的經歷時間相比較。如果逾時值小於已經歷的時間,會從伺服器階段作業儲存區中移除伺服器階段作業,同時其 JMS 階段作業會回到 JMS 階段作業儲存區。比方說,如果逾時值是 1 秒,而自使用特定伺服器階段作業以來所經歷的時間是 2 秒,就會從伺服器階段作業儲存區中移除這個伺服器階段作業,且其 JMS 階段作業會返回 JMS 階段作業儲存區。

資料類型 整數
單位
預設值 -1(停用)
範圍 -2147483648 至 2147483647
SERVER.SESSION.POOL.UNUSED.TIMEOUT.lpname

這個內容會將接聽器埠的預設 SERVER.SESSION.POOL.UNUSED.TIMEOUT 值,置換為所定義的 lpname 名稱。這個值會套用至所有使用指定接聽器埠的訊息驅動 Bean。

如果將這項置換設為非負值,即使 SERVER.SESSION.POOL.UNUSED.TIMEOUT 內容為負值,仍會置換 SERVER.SESSION.POOL.UNUSED.TIMEOUT 內容。

如果此置換設為負值,它會對指定的接聽器埠停用伺服器階段作業儲存區監視。

資料類型 整數
單位
預設值 未設定
範圍 -2147483648 至 2147483647



標示(線上)的鏈結表示需要存取網際網路。

相關工作
相關參考


檔名: umb_prolscp.html