Persistent Scheduled Executor (persistentExecutor)
Schedules and runs persistent tasks.
Attribute name | Data type | Default value | 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. |
pollInterval | A period of time with millisecond precision | -1 | Interval 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. |
pollSize | int
Minimum: 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 | 1m | The 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. |
retryLimit | short
Minimum: -1 Maximum: 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
Description: Configures how context is captured and propagated to threads.Required: falseData type: Attribute name Data type Default value Description 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. jndiName string JNDI name onError - IGNORE
- FAIL
- 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. - 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.
- contextService > baseContext
Description: Specifies a base context service from which to inherit context that is not already defined on this context service.Required: falseData type: Attribute name Data type Default value Description 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. id string A unique configuration ID. jndiName string JNDI name onError - IGNORE
- FAIL
- 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. - 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.
- contextService > baseContext > baseContext
Description: Specifies a base context service from which to inherit context that is not already defined on this context service.Required: falseData type: com.ibm.ws.context.service-factory
- contextService > baseContext > classloaderContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > baseContext > jeeMetadataContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > baseContext > securityContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > baseContext > syncToOSThreadContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > baseContext > zosWLMContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value 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 - Propagate
- PropagateOrNew
- New
Propagate Indicates 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
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > jeeMetadataContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > securityContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > syncToOSThreadContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value Description id string A unique configuration ID.
- contextService > zosWLMContext
Description: A unique configuration ID.Required: falseData type: Attribute name Data type Default value 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 - Propagate
- PropagateOrNew
- New
Propagate Indicates 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.