Persistent Scheduled Executor (persistentExecutor)
Schedules and runs persistent tasks.
Name | Type | Default | Description |
---|---|---|---|
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 | 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 | 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.
Name | Type | Default | Description |
---|---|---|---|
jndiName | string | JNDI name | |
onError |
| 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. |
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.
Name | Type | Default | Description |
---|---|---|---|
id | string | A unique configuration ID. | |
jndiName | string | JNDI name | |
onError |
| 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. |
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.
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 > 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. |