Persistent Scheduled Executor (persistentExecutor)

Schedules and runs persistent tasks.

NameTypeDefaultDescription

contextServiceRef

A reference to 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. You 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. You 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. You 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. You 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

A reference to top level databaseStore element (string).

defaultDatabaseStore

Persistent store for scheduled tasks.

contextService

Configures how context is captured and propagated to threads.

NameTypeDefaultDescription

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

A 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.

contextService > baseContext

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

NameTypeDefaultDescription

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

A 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.

contextService > baseContext > classloaderContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.

contextService > baseContext > jeeMetadataContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.

contextService > baseContext > securityContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.

contextService > classloaderContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.

contextService > jeeMetadataContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.

contextService > securityContext

A unique configuration ID.

NameTypeDefaultDescription

id

string

A unique configuration ID.