Persistent Scheduled Executor (persistentExecutor)

Persistent Scheduled Executor (persistentExecutor)

Schedules and runs persistent tasks.

Name Type Default Description

contextServiceRef Top level contextService element (string). DefaultContextService Configures how context is captured and propagated to threads.

enableTaskExecution boolean true Determines whether or not this instance may run tasks.

id string A unique configuration ID.

initialPollDelay A period of time with millisecond precision 0 Duration 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.

missedTaskThreshold A period of time with second precision -1 The amount of time after the expected start of a task run to reserve for running the task. Other members are prevented from running the task before the expiration of this interval. If the interval elapses without the task running successfully, or the task rolls back, then the task run is considered missed, enabling another member to attempt to run it. Missed task threshold values within the supported range of 100 seconds to 9000 seconds (2.5 hours) enable failover. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), or seconds (s). For example, specify 30 seconds as 30s. We can include multiple values in a single entry. For example, 1m30s is equivalent to 90 seconds.

pollInterval A period of time with millisecond precision Interval at which the executor looks for tasks in the persistent store to run. If unspecified and fail over is enabled, a poll interval is automatically computed. If fail over is not enabled, the default is -1, which 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.

pollSize int
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.

retryInterval A period of time with millisecond precision The amount of time that must pass between consecutive retries of a failed task. The retry interval applies only when failover is disabled. When failover is enabled, servers retry at their next poll. When failover is not enabled, the first retry occurs immediately on the same server, and at the retry interval thereafter. The default retry interval is 1 minute. 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.

retryLimit short
Min: -1
Max: 10000 10 Limit 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.

taskStoreRef Top level databaseStore element (string). defaultDatabaseStore Persistent store for scheduled tasks.

contextService
Configures how context is captured and propagated to threads.

Name Type Default Description

jndiName string JNDI name

onError

FAIL
IGNORE
WARN

WARN Determines 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.
FAIL
Server will issue a warning or error message on the first error occurrence and then stop the server.
IGNORE
Server will not issue any warning and error messages when it incurs a configuration error.
WARN
Server will issue warning and error messages when it incurs a configuration error.

Advanced Properties

baseContextRef Top level contextService element (string). Specifies a base context service from which to inherit context that is not already defined on this context service.

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

Name Type Default Description

id string A unique configuration ID.

jndiName string JNDI name

onError

FAIL
IGNORE
WARN

WARN Determines 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.
FAIL
Server will issue a warning or error message on the first error occurrence and then stop the server.
IGNORE
Server will not issue any warning and error messages when it incurs a configuration error.
WARN
Server will issue warning and error messages when it incurs a configuration error.

Advanced Properties

baseContextRef Top level contextService element (string). 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.

Name Type Default Description

id string A unique configuration ID.

contextService > baseContext > jeeMetadataContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > baseContext > securityContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > baseContext > syncToOSThreadContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > baseContext > zosWLMContext
A unique configuration ID.

Name Type Default Description

daemonTransactionClass string ASYNCDMN The Transaction Class name provided to WLM to classify work when a new WLM context is created for Daemon work.

defaultTransactionClass string ASYNCBN The Transaction Class name provided to WLM to classify work when a new WLM context is being created for non-Daemon work.

id string A unique configuration ID.

wlm

New
Propagate
PropagateOrNew

Propagate Indicates how the WLM context should be handled for non-Daemon work.
New
Always create a new WLM context.
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.

contextService > classloaderContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > jeeMetadataContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > securityContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > syncToOSThreadContext
A unique configuration ID.

Name Type Default Description

id string A unique configuration ID.

contextService > zosWLMContext
A unique configuration ID.

Name Type Default Description

daemonTransactionClass string ASYNCDMN The Transaction Class name provided to WLM to classify work when a new WLM context is created for Daemon work.

defaultTransactionClass string ASYNCBN The Transaction Class name provided to WLM to classify work when a new WLM context is being created for non-Daemon work.

id string A unique configuration ID.

wlm

New
Propagate
PropagateOrNew

Propagate Indicates how the WLM context should be handled for non-Daemon work.
New
Always create a new WLM context.
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.

Name	Type	Default	Description
contextServiceRef	Top level contextService element (string).	DefaultContextService	Configures how context is captured and propagated to threads.
enableTaskExecution	boolean	true	Determines whether or not this instance may run tasks.
id	string		A unique configuration ID.
initialPollDelay	A period of time with millisecond precision	0	Duration 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
missedTaskThreshold	A period of time with second precision	-1	The amount of time after the expected start of a task run to reserve for running the task. Other members are prevented from running the task before the expiration of this interval. If the interval elapses without the task running successfully, or the task rolls back, then the task run is considered missed, enabling another member to attempt to run it. Missed task threshold values within the supported range of 100 seconds to 9000 seconds (2.5 hours) enable failover. Specify a positive integer followed by a unit of time, which can be hours (h), minutes (m), or seconds (s). For example, specify 30 seconds as 30s. We can include multiple values in a single entry. For example, 1m30s is equivalent to 90 seconds.
pollInterval	A period of time with millisecond precision		Interval at which the executor looks for tasks in the persistent store to run. If unspecified and fail over is enabled, a poll interval is automatically computed. If fail over is not enabled, the default is -1, which 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
pollSize	int 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.
retryInterval	A period of time with millisecond precision		The amount of time that must pass between consecutive retries of a failed task. The retry interval applies only when failover is disabled. When failover is enabled, servers retry at their next poll. When failover is not enabled, the first retry occurs immediately on the same server, and at the retry interval thereafter. The default retry interval is 1 minute. 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. We can include multiple values in a single entry. For example, 1s500ms is equivalent to 1.5 seconds.
retryLimit	short Min: -1 Max: 10000	10	Limit 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.
taskStoreRef	Top level databaseStore element (string).	defaultDatabaseStore	Persistent store for scheduled tasks.

Name	Type	Default	Description
jndiName	string		JNDI name
onError	FAIL IGNORE WARN	WARN	Determines 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. FAIL Server will issue a warning or error message on the first error occurrence and then stop the server. IGNORE Server will not issue any warning and error messages when it incurs a configuration error. WARN Server will issue warning and error messages when it incurs a configuration error.
Advanced Properties
baseContextRef	Top level contextService element (string).		Specifies a base context service from which to inherit context that is not already defined on this context service.

Name	Type	Default	Description
daemonTransactionClass	string	ASYNCDMN	The Transaction Class name provided to WLM to classify work when a new WLM context is created for Daemon work.
defaultTransactionClass	string	ASYNCBN	The Transaction Class name provided to WLM to classify work when a new WLM context is being created for non-Daemon work.
id	string		A unique configuration ID.
wlm	New Propagate PropagateOrNew	Propagate	Indicates how the WLM context should be handled for non-Daemon work. New Always create a new WLM context. 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.