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 > 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 > 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 環境定義。
參照主題