EJB 儲存器 (ejbContainer)

定義 EJB 儲存器的行為。

屬性名稱 資料類型 預設值 說明
cacheCleanupInterval 具有秒精準度的時間量 3s 當超出大小時,將未用的 Stateful Session Bean 實例消除的間隔。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
cacheSize int

下限:1

2053 應該快取在記憶體內的 Stateful Session Bean 實例數目。
poolCleanupInterval 具有秒精準度的時間量 30s 移除未用 Bean 實例的間隔。 這個設定只適用於 Stateless Session Bean 和訊息驅動 Bean。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
startEJBsAtAppStart 布林   指定何時要起始設定 EJB 類型。如果將這個內容設為 true,則 EJB 類型會在應用程式第一次啟動時起始設定。如果將這個內容設為 false,EJB 類型會在應用程式第一次使用 EJB 類型時起始設定。如果沒有設定這個內容,則會依 Bean,根據 ibm-ejb-jar-ext.xml 檔中的 start-at-app-start 屬性,來決定其行為。這項設定不適用於訊息驅動 Bean 或啟動單態 Bean。訊息驅動 Bean 和啟動單態 Bean 一律是在應用程式啟動時起始設定。
asynchronous
說明:定義 EJB 非同步方法的行為。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
contextServiceRef 最上層 contextService 元素的參照(字串)。   用來管理將環境定義傳播至非同步 EJB 方法執行緒的環境定義服務。
maxUnclaimedRemoteResults int

下限:1

1000 對於會傳回 Future 物件的所有遠端非同步方法呼叫,伺服器保留其未取結果的數目上限。如果超過上限,伺服器會清除方法呼叫中完成最久的結果,以防記憶體洩漏。
unclaimedRemoteResultTimeout 具有秒精準度的時間量 24h 對於傳回 Future 物件的每一次遠端非同步方法呼叫,伺服器保留其結果的時間量。如果應用程式沒有在指定期間內索取該結果,伺服器會清除該方法呼叫的結果,以防記憶體洩漏。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
asynchronous > contextService
說明:用來管理將環境定義傳播至非同步 EJB 方法執行緒的環境定義服務。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
baseContextRef 最上層 contextService 元素的參照(字串)。   指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
jndiName 字串   JNDI 名稱
onError
  • IGNORE
  • FAIL
  • WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。
IGNORE
當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
FAIL
第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
WARN
當伺服器發現配置錯誤時,發出警告和錯誤訊息。
asynchronous > contextService > baseContext
說明:指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
baseContextRef 最上層 contextService 元素的參照(字串)。   指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
id 字串   唯一的配置 ID。
jndiName 字串   JNDI 名稱
onError
  • IGNORE
  • FAIL
  • WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。
IGNORE
當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
FAIL
第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
WARN
當伺服器發現配置錯誤時,發出警告和錯誤訊息。
asynchronous > contextService > baseContext > baseContext
說明:指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
必要:false
資料類型:com.ibm.ws.context.service-factory
asynchronous > contextService > baseContext > classloaderContext
說明:類別載入器環境定義傳播配置。
必要:false
資料類型:
asynchronous > contextService > baseContext > jeeMetadataContext
說明:將提交環境定義作業之應用程式元件的名稱空間提供給作業。
必要:false
資料類型:
asynchronous > contextService > baseContext > securityContext
說明:當指定時,會將工作起始器的安全環境定義傳播到工作單元。
必要:false
資料類型:
asynchronous > contextService > baseContext > syncToOSThreadContext
說明:如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。
必要:false
資料類型:
asynchronous > contextService > baseContext > zosWLMContext
說明:指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
wlm
  • Propagate
  • PropagateOrNew
  • 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(如果有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
新建
一律建立新的 WLM 環境定義。
asynchronous > contextService > classloaderContext
說明:類別載入器環境定義傳播配置。
必要:false
資料類型:
asynchronous > contextService > jeeMetadataContext
說明:將提交環境定義作業之應用程式元件的名稱空間提供給作業。
必要:false
資料類型:
asynchronous > contextService > securityContext
說明:當指定時,會將工作起始器的安全環境定義傳播到工作單元。
必要:false
資料類型:
asynchronous > contextService > syncToOSThreadContext
說明:如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。
必要:false
資料類型:
asynchronous > contextService > zosWLMContext
說明:指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
wlm
  • Propagate
  • PropagateOrNew
  • 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(如果有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
新建
一律建立新的 WLM 環境定義。
timerService
說明:定義 EJB 計時器服務的行為。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
lateTimerThreshold 具有分鐘精準度的時間量 5m 一旦過了排定的計時器有效期限幾分鐘之後,即將計時器視為延遲啟動。當計時器延遲啟動時,將記載警告訊息,指出計時器比排定時間還晚啟動。預設臨界值是 5 分鐘,值 0 分鐘則會關閉警告訊息特性。請指定一個正整數,後面接著一個時間單位,可以是時 (h) 或分 (m)。 例如,30 分指定為 30m。 單一項目可以包含多個值。比方說,1h30m 相當於 90 分。
nonPersistentMaxRetries int

下限:-1

-1 當非持續性計時器到期時,會呼叫逾時回呼方法。 這項設定用來控制 EJB 儲存器要重試計時器幾次。如果此回呼方法的交易失敗或回復,EJB 儲存器必須重試計時器至少一次。預設值為 -1,表示 EJB 儲存器無限重試,直到計時器成功為止。如果值設為 0,EJB 儲存器不會重試計時器,不過這會造成不符合 EJB 規格標準的行為。
nonPersistentRetryInterval 具有秒精準度的時間量 300s 當非持續性計時器到期時,會呼叫逾時回呼方法。 如果此回呼方法的交易失敗或回復,儲存器必須重試計時器。第一次重試會立即進行,後續的重試則延遲至指定的秒數再進行。如果值設為 0,所有重試都會立即進行。如果您沒有指定一值,則預設間隔是 300 秒。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
persistentExecutorRef 最上層 persistentExecutor 元素的參照(字串)。   排定和執行 EJB 持續性計時器作業。
timerService > persistentExecutor
說明:排定和執行 EJB 持續性計時器作業。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
contextServiceRef 最上層 contextService 元素的參照(字串)。 DefaultContextService 配置如何擷取環境定義並傳播到執行緒。
enableTaskExecution 布林 True 判斷此實例是否可能執行作業。
initialPollDelay 具有毫秒精準度的時間量 0 此實例可輪詢持續儲存庫以找出要執行的作業之前,要等待的持續時間。值 -1 表示延遲輪詢,直到以程式設計方式啟動它為止。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
pollInterval 具有毫秒精準度的時間量 -1 輪詢找出要執行的作業的間隔時間。值 -1 會在起始輪詢之後,停用所有的輪詢。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
pollSize int

下限:1

  在輪詢持續儲存庫以找出要執行的作業時,所能尋找的作業項目數上限。若未指定,則沒有限制。
retryInterval 具有毫秒精準度的時間量 1m 第二次與後續連續重試失敗作業之間必須經歷的時間量。第一次重試會立即進行,而不考慮此屬性的值。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
retryLimit short

下限:-1

上限:10000

10 連續重試失敗或回復作業的次數限制,一旦超過,即將作業視為永久失敗,而不再進一步重試。值 -1 表示容許無限重試。
taskStoreRef 最上層 databaseStore 元素的參照(字串)。 defaultDatabaseStore 所排定作業的持續儲存庫。
timerService > persistentExecutor > contextService
說明:配置如何擷取環境定義並傳播到執行緒。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
baseContextRef 最上層 contextService 元素的參照(字串)。   指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
jndiName 字串   JNDI 名稱
onError
  • IGNORE
  • FAIL
  • WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。
IGNORE
當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
FAIL
第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
WARN
當伺服器發現配置錯誤時,發出警告和錯誤訊息。
timerService > persistentExecutor > contextService > baseContext
說明:指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
baseContextRef 最上層 contextService 元素的參照(字串)。   指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
id 字串   唯一的配置 ID。
jndiName 字串   JNDI 名稱
onError
  • IGNORE
  • FAIL
  • WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。
IGNORE
當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
FAIL
第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
WARN
當伺服器發現配置錯誤時,發出警告和錯誤訊息。
timerService > persistentExecutor > contextService > baseContext > baseContext
說明:指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。
必要:false
資料類型:com.ibm.ws.context.service-factory
timerService > persistentExecutor > contextService > baseContext > classloaderContext
說明:類別載入器環境定義傳播配置。
必要:false
資料類型:
timerService > persistentExecutor > contextService > baseContext > jeeMetadataContext
說明:將提交環境定義作業之應用程式元件的名稱空間提供給作業。
必要:false
資料類型:
timerService > persistentExecutor > contextService > baseContext > securityContext
說明:當指定時,會將工作起始器的安全環境定義傳播到工作單元。
必要:false
資料類型:
timerService > persistentExecutor > contextService > baseContext > syncToOSThreadContext
說明:如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。
必要:false
資料類型:
timerService > persistentExecutor > contextService > baseContext > zosWLMContext
說明:指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
wlm
  • Propagate
  • PropagateOrNew
  • 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(如果有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
新建
一律建立新的 WLM 環境定義。
timerService > persistentExecutor > contextService > classloaderContext
說明:類別載入器環境定義傳播配置。
必要:false
資料類型:
timerService > persistentExecutor > contextService > jeeMetadataContext
說明:將提交環境定義作業之應用程式元件的名稱空間提供給作業。
必要:false
資料類型:
timerService > persistentExecutor > contextService > securityContext
說明:當指定時,會將工作起始器的安全環境定義傳播到工作單元。
必要:false
資料類型:
timerService > persistentExecutor > contextService > syncToOSThreadContext
說明:如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。
必要:false
資料類型:
timerService > persistentExecutor > contextService > zosWLMContext
說明:指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。
wlm
  • Propagate
  • PropagateOrNew
  • 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(如果有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
新建
一律建立新的 WLM 環境定義。

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



「時間戳記」圖示 前次更新: 2016 年 6 月 3 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_ejbContainer
檔名:rwlp_config_ejbContainer.html