EJB 容器 (ejbContainer)

定义 EJB 容器的行为。

属性名称 数据类型 缺省值 描述
cacheCleanupInterval 精度为秒的时间段 3s 超过大小时两次清除未使用的有状态会话 Bean 实例之间的时间间隔。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
cacheSize 整型

最小值:1

2053 应该在内存中高速缓存的有状态会话 Bean 实例数。
poolCleanupInterval 精度为秒的时间段 30s 两次移除未使用的 Bean 实例之间的时间间隔。此设置仅适用于无状态会话 Bean 和消息驱动的 Bean。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
startEJBsAtAppStart 布尔型   指定将对 EJB 类型进行初始化的时间。如果此属性设置为 true,那么将在应用程序首次启动时对 EJB 类型进行初始化。如果此属性设置为 false,那么将在应用程序首次使用 EJB 类型时对 EJB 类型进行初始化。如果未设置此属性,那么将根据 ibm-ejb-jar-ext.xml 文件中的 start-at-app-start 属性逐个 Bean 来确定行为。此设置不适用于消息驱动的 Bean 或者启动独立 Bean。消息驱动的 Bean 和启动独立 Bean 始终将在应用程序启动时进行初始化。
asynchronous
描述:定义 EJB 异步方法的行为。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
contextServiceRef 对顶级 contextService 元素的引用(字符串)。   用于管理上下文传播至异步 EJB 方法线程的过程的上下文服务。
maxUnclaimedRemoteResults 整型

最小值:1

1000 在所有将返回 Future 对象的远程异步方法调用中,服务器保留的未声明结果的最大数目。如果超过了最大数目,那么服务器将清除最早完成的方法调用的结果,以防止发生内存泄漏。
unclaimedRemoteResultTimeout 精度为秒的时间段 24h 服务器为每个将返回 Future 对象的远程异步方法调用保留结果的时间。如果应用程序在所指定的时间段内未声明结果,那么服务器将清除该方法调用的结果,以防止发生内存泄漏。 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
asynchronous > contextService
描述:用于管理上下文传播至异步 EJB 方法线程的过程的上下文服务。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
baseContextRef 对顶级 contextService 元素的引用(字符串)。   指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
jndiName string   JNDI 名称
onError
  • IGNORE
  • FAIL
  • WARN
WARN 确定用于对配置错误作出响应的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是使错误配置部分失效、针对其发出警告还是将其忽略。
IGNORE
服务器在引发配置错误时将不会发出任何警告和错误消息。
FAIL
服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
WARN
服务器在引发配置错误时将发出警告和错误消息。
asynchronous > contextService > baseContext
描述:指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
baseContextRef 对顶级 contextService 元素的引用(字符串)。   指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
id string   唯一配置标识。
jndiName string   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 string ASYNCDMN 对守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
defaultTransactionClass string ASYNCBN 对非守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
wlm
  • Propagate
  • PropagateOrNew
  • New
Propagate 指示应当如何为非守护程序工作处理 WLM 上下文。
Propagate
使用同一 WLM 上下文(如果存在 WLM 上下文)。
PropagateOrNew
使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
New
始终创建新的 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 string ASYNCDMN 对守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
defaultTransactionClass string ASYNCBN 对非守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
wlm
  • Propagate
  • PropagateOrNew
  • New
Propagate 指示应当如何为非守护程序工作处理 WLM 上下文。
Propagate
使用同一 WLM 上下文(如果存在 WLM 上下文)。
PropagateOrNew
使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
New
始终创建新的 WLM 上下文。
timerService
描述:定义 EJB 计时器服务的行为。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
lateTimerThreshold 具有分钟精度的时间段 5m 一个分钟数,在计时器的已安排到期时间过了该分钟数之后,计时器启动将视为延迟。当计时器延迟启动时,将记录一条警告消息,指示计时器的启动时间晚于安排的时间。缺省阈值为 5 分钟,值为 0 分钟时关闭警告消息功能部件。 指定后跟时间单位的正整数,时间单位可以是小时 (h) 或分钟 (m)。例如,将 30 分钟指定为 30m。可以将多个值包括在单个条目中。例如,1h30m 相当于 90 分钟。
nonPersistentMaxRetries 整型

最小值:-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 整型

最小值:1

  轮询持久性存储以获取要运行的任务时要查找的最大任务条目数。如果未指定,那么表示没有限制。
retryInterval 具有毫秒精度的时间段 1m 在第二次重试失败任务与后续连续重试失败任务之间必须经过的时间。无论此属性的值如何,都将立即进行第一次重试。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
retryLimit 短整型

最小值:-1

最大值:10000

10 对已失败或者已回滚的任务连续重试的次数限制;达到此限制之后,就会认为该任务永久失败,并且不再进一步重试。如果值为 -1,那么将允许无限制地重试。
taskStoreRef 对顶级 databaseStore 元素的引用(字符串)。 defaultDatabaseStore 计划任务的持久性存储。
timerService > persistentExecutor > contextService
描述:配置上下文捕获及传播至线程的方式。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
baseContextRef 对顶级 contextService 元素的引用(字符串)。   指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
jndiName string   JNDI 名称
onError
  • IGNORE
  • FAIL
  • WARN
WARN 确定用于对配置错误作出响应的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是使错误配置部分失效、针对其发出警告还是将其忽略。
IGNORE
服务器在引发配置错误时将不会发出任何警告和错误消息。
FAIL
服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
WARN
服务器在引发配置错误时将发出警告和错误消息。
timerService > persistentExecutor > contextService > baseContext
描述:指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
必需:False
数据类型:
属性名称 数据类型 缺省值 描述
baseContextRef 对顶级 contextService 元素的引用(字符串)。   指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
id string   唯一配置标识。
jndiName string   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 string ASYNCDMN 对守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
defaultTransactionClass string ASYNCBN 对非守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
wlm
  • Propagate
  • PropagateOrNew
  • New
Propagate 指示应当如何为非守护程序工作处理 WLM 上下文。
Propagate
使用同一 WLM 上下文(如果存在 WLM 上下文)。
PropagateOrNew
使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
New
始终创建新的 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 string ASYNCDMN 对守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
defaultTransactionClass string ASYNCBN 对非守护程序工作创建新的 WLM 上下文时,这是向 WLM 提供的事务类名,用来对工作进行分类。
wlm
  • Propagate
  • PropagateOrNew
  • New
Propagate 指示应当如何为非守护程序工作处理 WLM 上下文。
Propagate
使用同一 WLM 上下文(如果存在 WLM 上下文)。
PropagateOrNew
使用同一 WLM 上下文,或者创建新的 WLM 上下文(如果当前不存在上下文)。
New
始终创建新的 WLM 上下文。

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_ejbContainer
文件名:rwlp_config_ejbContainer.html