managedScheduledExecutorService - 受管已调度执行者 (managedScheduledExecutorService)

受管已调度执行者服务

NameTypeDefaultDescription
id字符串唯一配置标识。
concurrencyPolicyRef对顶级 concurrencyPolicy 元素的引用(字符串)。defaultConcurrencyPolicy提交至此执行者的任务的并行度策略。如果多个执行者指定同一并行度策略,那么将在指定该策略的执行者集合提交的任务间实施该策略的约束。
contextServiceRef对顶级 contextService 元素的引用(字符串)。DefaultContextService配置上下文传播至线程的方式
jndiNamestringJNDI 名称
longRunningPolicyRef对顶级 concurrencyPolicy 元素的引用(字符串)。将 LONGRUNNING_HINT 执行属性值指定为“true”的任务的并行度策略。如果多个执行者指定同一并行度策略,那么将在指定该策略的整个执行者集合提交的任务间实施该策略的约束。如果未指定,那么长时间运行的并行度策略缺省为执行者的通用并行度策略。

concurrencyPolicy

提交至此执行者的任务的并行度策略。如果多个执行者指定同一并行度策略,那么将在指定该策略的执行者集合提交的任务间实施该策略的约束。

NameTypeDefaultDescription
maxPolicy
  • loose
  • strict
loose指示是松散地还是严格地对正在任务提交者的线程上运行的任务实施最大并行度。使用不计时 invokeAll 方法或(如果仅调用单个任务)不计时 invokeAny 方法时,可在任务提交者的线程上运行任务。如果配置了“队列已满时运行”属性,那么在使用 execute 和 submit 方法时,可在任务提交者的线程上运行任务。在所有这些案例中,此属性确定在提交者的线程上运行是否计入最大并行度。
loose
松散地实施最大并行度。允许任务在任务提交者的线程上运行而不计入最大并行度。
strict
严格地实施最大并行度。在任务提交者的线程上运行的任务计入最大并行度。此策略不允许在已达到最大并行度的情况下在任务提交者的线程上运行任务。
maxWaitForEnqueue具有毫秒精度的时间段0指定等待任务入队的最长时间。如果无法在此时间间隔内使任务入队,那么任务提交将受“队列已满时运行”策略所限。更新最长等待入队时间后,更新仅应用于在该时间点后提交的任务。已在等待队列位置的任务提交继续按先前配置的值进行等待。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
runIfQueueFull布尔型false使用 <execute> 或 <submit> 方法时适用。指示在队列已满并且超过最长等待入队时间时,是否在提交者的线程上运行该任务。如果将最大值策略配置为“严格”,那么是否能够在提交者的线程上运行还取决于最大并行约束。如果该任务无法在提交者的线程上运行,那么在经过最长等待入队时间之后会拒绝提交任务。
maxint
Min: 1
指定可同时运行的最大任务数。缺省值为 Integer.MAX_VALUE。可在任务进行时更新最大并行度。如果最大并行度降低至并行运行的任务数之下,那么更新将在正在进行的任务完成时逐步生效,而不是取消任务。
maxQueueSizeint
Min: 1
指定可在队列中等待执行的最大任务数。启动、取消或中止任务时,系统会从队列中移除这些任务。队列已满时,如果提交另一任务,那么行为由最长等待入队时间和“队列已满时运行”属性确定。为确保特定数目的任务可在较短时间间隔内入队,请使用大小至少为此数目的最大队列大小。缺省最大队列大小为 Integer.MAX_VALUE。任务正在进行或排队等待执行时,可更新最大队列大小。如果最大队列大小降低至当前已入队任务数之下,那么更新将逐步生效,而不是自动取消超额的已排队任务。
startTimeout具有毫秒精度的时间段指定任务提交和任务启动之间的可能耗用的最长时间。缺省情况下,任务不会超时。如果同时启用了最长等待入队时间和启动超时,请将启动超时配置为大于最长等待入队时间。如果启动超时在使用时被更新,那么新启动超时值将应用于更新发生后提交的任务。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。

contextService

配置上下文传播至线程的方式

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARN确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。
IGNORE
服务器在发生配置错误时将不会发出警告和错误消息。
WARN
服务器在发生配置错误时将发出警告和错误消息。
FAIL
服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
baseContextRef对顶级 contextService 元素的引用(字符串)。指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
jndiNamestringJNDI 名称

contextService > baseContext

指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。

NameTypeDefaultDescription
id字符串唯一配置标识。
onError
  • IGNORE
  • WARN
  • FAIL
WARN确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。
IGNORE
服务器在发生配置错误时将不会发出警告和错误消息。
WARN
服务器在发生配置错误时将发出警告和错误消息。
FAIL
服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
baseContextRef对顶级 contextService 元素的引用(字符串)。指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。
jndiNamestringJNDI 名称

contextService > baseContext > baseContext

指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。

contextService > baseContext > classloaderContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > baseContext > jeeMetadataContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > baseContext > securityContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > baseContext > syncToOSThreadContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > baseContext > zosWLMContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。
defaultTransactionClassstringASYNCBN当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。
daemonTransactionClassstringASYNCDMN当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。
wlm
  • PropagateOrNew
  • New
  • Propagate
Propagate指示如何为非守护程序工作处理 WLM 上下文。
PropagateOrNew
使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
New
始终创建新的 WLM 上下文。
Propagate
使用相同的 WLM 上下文(如果存在一个)。

contextService > classloaderContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > jeeMetadataContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > securityContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > syncToOSThreadContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。

contextService > zosWLMContext

唯一配置标识。

NameTypeDefaultDescription
id字符串唯一配置标识。
defaultTransactionClassstringASYNCBN当为非守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。
daemonTransactionClassstringASYNCDMN当为守护程序工作创建新 WLM 上下文时,提供给 WLM 以对工作进行分类的事务类名称。
wlm
  • PropagateOrNew
  • New
  • Propagate
Propagate指示如何为非守护程序工作处理 WLM 上下文。
PropagateOrNew
使用相同的 WLM 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
New
始终创建新的 WLM 上下文。
Propagate
使用相同的 WLM 上下文(如果存在一个)。

longRunningPolicy

将 LONGRUNNING_HINT 执行属性值指定为“true”的任务的并行度策略。如果多个执行者指定同一并行度策略,那么将在指定该策略的整个执行者集合提交的任务间实施该策略的约束。如果未指定,那么长时间运行的并行度策略缺省为执行者的通用并行度策略。

NameTypeDefaultDescription
maxPolicy
  • loose
  • strict
loose指示是松散地还是严格地对正在任务提交者的线程上运行的任务实施最大并行度。使用不计时 invokeAll 方法或(如果仅调用单个任务)不计时 invokeAny 方法时,可在任务提交者的线程上运行任务。如果配置了“队列已满时运行”属性,那么在使用 execute 和 submit 方法时,可在任务提交者的线程上运行任务。在所有这些案例中,此属性确定在提交者的线程上运行是否计入最大并行度。
loose
松散地实施最大并行度。允许任务在任务提交者的线程上运行而不计入最大并行度。
strict
严格地实施最大并行度。在任务提交者的线程上运行的任务计入最大并行度。此策略不允许在已达到最大并行度的情况下在任务提交者的线程上运行任务。
maxWaitForEnqueue具有毫秒精度的时间段0指定等待任务入队的最长时间。如果无法在此时间间隔内使任务入队,那么任务提交将受“队列已满时运行”策略所限。更新最长等待入队时间后,更新仅应用于在该时间点后提交的任务。已在等待队列位置的任务提交继续按先前配置的值进行等待。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
runIfQueueFull布尔型false使用 <execute> 或 <submit> 方法时适用。指示在队列已满并且超过最长等待入队时间时,是否在提交者的线程上运行该任务。如果将最大值策略配置为“严格”,那么是否能够在提交者的线程上运行还取决于最大并行约束。如果该任务无法在提交者的线程上运行,那么在经过最长等待入队时间之后会拒绝提交任务。
maxint
Min: 1
指定可同时运行的最大任务数。缺省值为 Integer.MAX_VALUE。可在任务进行时更新最大并行度。如果最大并行度降低至并行运行的任务数之下,那么更新将在正在进行的任务完成时逐步生效,而不是取消任务。
maxQueueSizeint
Min: 1
指定可在队列中等待执行的最大任务数。启动、取消或中止任务时,系统会从队列中移除这些任务。队列已满时,如果提交另一任务,那么行为由最长等待入队时间和“队列已满时运行”属性确定。为确保特定数目的任务可在较短时间间隔内入队,请使用大小至少为此数目的最大队列大小。缺省最大队列大小为 Integer.MAX_VALUE。任务正在进行或排队等待执行时,可更新最大队列大小。如果最大队列大小降低至当前已入队任务数之下,那么更新将逐步生效,而不是自动取消超额的已排队任务。
startTimeout具有毫秒精度的时间段指定任务提交和任务启动之间的可能耗用的最长时间。缺省情况下,任务不会超时。如果同时启用了最长等待入队时间和启动超时,请将启动超时配置为大于最长等待入队时间。如果启动超时在使用时被更新,那么新启动超时值将应用于更新发生后提交的任务。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。