接聽器埠設定

接聽器埠定義 Connection Factory、目的地和已部署的訊息驅動 Bean 之間的關聯性。 這項關聯會啟用與該埠相關聯的部署訊息驅動 Bean,以擷取來自目的地中的訊息。

請利用這個畫面來檢視或變更選取的接聽器埠的配置內容。

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

名稱

用來識別接聽器埠供管理使用的名稱。

資料類型 字串
預設值 空值
起始狀態

下次重新啟動應用程式伺服器時,您要接聽器埠呈現的狀態

資料類型 列舉
單位 不適用
預設值 已啟動
範圍
已啟動
下次啟動應用程式伺服器時,會自動啟動接聽器埠。
已停止
下次啟動應用程式伺服器時,不會自動啟動接聽器埠。 如果訊息驅動 Bean 要在應用程式伺服器中使用這個接聽器埠,系統管理者必須手動啟動這個埠,或選取這個內容的啟動值,再重新啟動應用程式伺服器。
說明

接聽器埠的說明,供 IBM® WebSphere® Application Server 內管理作業使用。

資料類型 字串
預設值 空值
Connection Factory JNDI 名稱

接聽器埠要用的 JMS Connection Factory 的 JNDI 名稱,比方說,jms/connFactory1

資料類型 字串
預設值 空值
目的地 JNDI 名稱

接聽器埠要用之目的地的 JNDI 名稱,比方說,jms/destn1

延遲回應不能使用暫時目的地。

資料類型 字串
預設值 空值
階段作業數目上限

接聽器可搭配 JMS 伺服器來處理訊息的並行階段作業數目上限。

每個階段作業都對應於個別的接聽器執行緒,因此,可以控制同時處理的訊息數。 當伺服器並未充分使用機器的可用容量時,如果您不需要依照特定訊息次序來處理訊息,請調整這個參數。

資料類型 整數
單位 階段作業
預設值 1
範圍 1 至 2147483647
建議
  • 如果要依照嚴格的訊息次序來處理訊息,請將值設定為 1,只讓一個執行緒處理訊息。
  • 如果是訊息並行,也就是要同時處理多則訊息,請將這個內容設成大於 1。 這個值要儘量低,以防止超載用戶端應用程式。交易時間較短的 100% JMS 工作量,好的起點是每個處理器 2-4 個階段作業。如果有執行時間較長的交易,您可能需要較多個階段作業,這應該由實驗來決定。

    所有已配置接聽器埠的「階段作業數目上限」內容中指定的階段作業數目總計,必須小於或等於對訊息接聽器服務執行緒儲存區的「大小上限」內容所指定的執行緒數目。

重試次數上限

在接聽器停止作業之前,接聽器嘗試將訊息遞送給訊息驅動 Bean 實例的次數上限,範圍是 0 至 2147483647。

註: WebSphere MQ 佇列有一個稱為 BackoutThreshold 的類似內容。 如果接聽器埠從 WebSphere MQ 佇列讀取,則重試限制和達到該限制時的行為,取決於這兩個內容中哪一個設為較低限制:
  • 如果超出 WebSphere MQ 佇列 BackoutThreshold 限制,則 WebSphere MQ 會將無法遞送的訊息移至別處(例如,移至「WebSphere MQ 退回重排佇列」的佇列,或「WebSphere MQ 無法傳送的郵件」佇列),並且接聽器埠會繼續服務佇列中的下一則訊息。在此情況下,WebSphere Application Server 可能不知道訊息尚未順利遞送。
  • 如果超出接聽器埠「重試次數上限 」限制,接聽器埠便會停止作業。 也許您可能會接著手動介入調查問題,從 WebSphere MQ 佇列中移除訊息,然後重新啟動接聽器埠。
資料類型 整數
單位 重試次數
預設值 0(不重試)
範圍 0(不重試)至 2147483647
訊息上限

接聽器在單一交易中,能夠處理的訊息數目上限。

如果佇列是空的,每個訊息到達時,接聽器都會處理它。 每個訊息都是在個別交易內處理的。

對於 WebSphere 第 5 版預設傳訊提供者或作為 JMS 提供者的 WebSphere MQ 而言,如果訊息開始累積在佇列中,接聽器便可以開始批次處理訊息。 對於協力廠商傳訊提供者而言,這個內容值會傳給 JMS 提供者,但結果會隨著 JMS 提供者而不同。

資料類型 整數
單位 訊息數目
預設值 1
範圍 1 至 2147483647
建議
對於 WebSphere 預設傳訊提供者或作為 JMS 提供者的 WebSphere MQ 而言,如果要在單一交易內處理多則訊息,請將這個值設為 1 以上。如果訊息開始累積在佇列中,大於 1 的值會以單一交易的形式批次處理多則訊息,消除 JMS 訊息許多的交易處理成本。
注意:
  • 如果批次中的某則訊息處理失敗,出現異常狀況,就會將整批訊息放回佇列中,等待處理。
  • 在整個批次作業期間,會保留個別訊息的任何交易所保留的任何資源鎖定。
  • 根據訊息所需的處理量而定,如果使用 XA 交易,將值設成大於 1,交易可能會逾時。 如果 XA 交易經常為了處理多則訊息而超出交易逾時值,因而造成逾時,請將這個內容縮減成 1(將處理程序限制成每個交易只有一則訊息)或增加交易逾時值。



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

相關概念
相關工作
相關參考


檔名: umb_prolp.html