persistentExecutor - Persistent Scheduled Executor (persistentExecutor)

Schedules and runs persistent tasks.

NameTypeDefaultDescription
idstringA unique configuration ID.
enableTaskExecutionbooleantrueDetermines whether or not this instance may run tasks.
initialPollDelayA period of time with millisecond precision0Duration of time to wait before this instance might poll the persistent store for tasks to run. A value of -1 delays polling until it is started programmatically. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
pollIntervalA period of time with millisecond precision-1Interval between polling for tasks to run. A value of -1 disables all polling after the initial poll. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
retryIntervalA period of time with millisecond precision1mThe amount of time that must pass between the second and subsequent consecutive retries of a failed task. The first retry occurs immediately, regardless of the value of this attribute. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), seconds (s), or milliseconds (ms). For example, specify 500 milliseconds as 500ms. You can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
retryLimitshort
Min: -1

Max: 10000
10Limit of consecutive retries for a task that has failed or rolled back, after which the task is considered permanently failed and does not attempt further retries. A value of -1 allows for unlimited retries.
taskStoreRefA reference to top level databaseStore element (string).defaultDatabaseStorePersistent store for scheduled tasks.
contextServiceRefA reference to top level contextService element (string).DefaultContextServiceConfigures how context is captured and propagated to threads.
pollSizeint
Min: 1
The maximum number of task entries to find when polling the persistent store for tasks to run. If unspecified, there is no limit.

contextService

Configures how context is captured and propagated to threads.

NameTypeDefaultDescription
onError
  • IGNORE
  • FAIL
  • WARN
WARNDetermines the action to take in response to configuration errors. For example, if securityContext is configured for this contextService, but the security feature is not enabled, then onError determines whether to fail, raise a warning, or ignore the parts of the configuration which are incorrect.
IGNORE
Server will not issue any warning and error messages when it incurs a configuration error.
FAIL
Server will issue a warning or error message on the first error occurrence and then stop the server.
WARN
Server will issue warning and error messages when it incurs a configuration error.
baseContextRefA reference to top level contextService element (string).Specifies a base context service from which to inherit context that is not already defined on this context service.
jndiNamestringJNDI name

contextService > baseContext

Specifies a base context service from which to inherit context that is not already defined on this context service.

NameTypeDefaultDescription
idstringA unique configuration ID.
onError
  • IGNORE
  • FAIL
  • WARN
WARNDetermines the action to take in response to configuration errors. For example, if securityContext is configured for this contextService, but the security feature is not enabled, then onError determines whether to fail, raise a warning, or ignore the parts of the configuration which are incorrect.
IGNORE
Server will not issue any warning and error messages when it incurs a configuration error.
FAIL
Server will issue a warning or error message on the first error occurrence and then stop the server.
WARN
Server will issue warning and error messages when it incurs a configuration error.
baseContextRefA reference to top level contextService element (string).Specifies a base context service from which to inherit context that is not already defined on this context service.
jndiNamestringJNDI name

contextService > baseContext > baseContext

Specifies a base context service from which to inherit context that is not already defined on this context service.

contextService > baseContext > classloaderContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > baseContext > jeeMetadataContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > baseContext > securityContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > baseContext > syncToOSThreadContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > baseContext > zosWLMContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.
defaultTransactionClassstringASYNCBNThe Transaction Class name provided to WLM to classify work when a new WLM context is being created for non-Daemon work.
daemonTransactionClassstringASYNCDMNThe Transaction Class name provided to WLM to classify work when a new WLM context is created for Daemon work.
wlm
  • Propagate
  • PropagateOrNew
  • New
PropagateIndicates how the WLM context should be handled for non-Daemon work.
Propagate
Use the same WLM Context (if one exists).
PropagateOrNew
Use the same WLM context or create a new one if no current context exists.
New
Always create a new WLM context.

contextService > classloaderContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > jeeMetadataContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > securityContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > syncToOSThreadContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.

contextService > zosWLMContext

A unique configuration ID.

NameTypeDefaultDescription
idstringA unique configuration ID.
defaultTransactionClassstringASYNCBNThe Transaction Class name provided to WLM to classify work when a new WLM context is being created for non-Daemon work.
daemonTransactionClassstringASYNCDMNThe Transaction Class name provided to WLM to classify work when a new WLM context is created for Daemon work.
wlm
  • Propagate
  • PropagateOrNew
  • New
PropagateIndicates how the WLM context should be handled for non-Daemon work.
Propagate
Use the same WLM Context (if one exists).
PropagateOrNew
Use the same WLM context or create a new one if no current context exists.
New
Always create a new WLM context.