WildFly 37 Model Reference

A managed scheduled executor service

Provided capabilities(1)

Name Dynamic Other provider points
org.wildfly.ee.concurrent.scheduled-executor true

none

Attributes (17)

  • active-thread-count The approximate number of threads that are actively executing tasks.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • completed-task-count The approximate total number of tasks that have completed execution.
    • Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • context-service The name of the context service to be used by the scheduled executor.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • core-threads The number of threads to be used by the scheduled executor, even if they are idle. If this is not defined or is set to 0, the core pool size will be calculated based on the number of available processors.
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Min 0
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • current-queue-size The current size of the executor's task queue.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • hung-task-termination-period The period, in milliseconds, for attempting hung tasks automatic termination, by cancelling such tasks, and interrupting their executing threads. If value is 0, which is the default, hung tasks are never cancelled.
    • Attribute Value
    Default Value 0
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 0
    Max -1
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • hung-task-threshold The runtime, in milliseconds, for tasks to be considered hung by the scheduled executor. If 0 tasks are never considered hung.
    • Attribute Value
    Default Value 0
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 0
    Max -1
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • hung-thread-count The number of executor threads that are hung.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • jndi-name The JNDI Name to lookup the managed scheduled executor service.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • keepalive-time When the number of threads is greater than the core, this is the maximum time, in milliseconds, that excess idle threads will wait for new tasks before terminating.
    • Attribute Value
    Default Value 60000
    Type LONG
    Nillable true
    Expressions Allowed true
    Min 0
    Max -1
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • long-running-tasks Flag which hints the duration of tasks executed by the scheduled executor.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • max-thread-count The largest number of executor threads.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • reject-policy The policy to be applied to aborted tasks.
    • Attribute Value
    Default Value ABORT
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Allowed Values ABORT
    RETRY_ABORT
    Stability default
  • task-count The approximate total number of tasks that have ever been submitted for execution.
    • Attribute Value
    Type LONG
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • thread-count The current number of executor threads.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
    Stability default
  • thread-factory The name of the thread factory to be used by the scheduled executor.
    • Deprecated Since 5.0.0
    Deprecated, the executor's thread factory should be configured using attribute named thread-priority.
    Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • thread-priority The priority applied to threads created by the executor.
    • Attribute Value
    Default Value 5
    Type INT
    Nillable true
    Expressions Allowed true
    Min 1
    Max 10
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default

Operations (3)

  • add Adds the scheduled executor
    Request Parameter Type Required Expressions Allowed Default value Description
    context-service STRING false false The name of the context service to be used by the scheduled executor.
    core-threads INT false true The number of threads to be used by the scheduled executor, even if they are idle. If this is not defined or is set to 0, the core pool size will be calculated based on the number of available processors.
    hung-task-termination-period LONG false true 0 The period, in milliseconds, for attempting hung tasks automatic termination, by cancelling such tasks, and interrupting their executing threads. If value is 0, which is the default, hung tasks are never cancelled.
    hung-task-threshold LONG false true 0 The runtime, in milliseconds, for tasks to be considered hung by the scheduled executor. If 0 tasks are never considered hung.
    jndi-name STRING true true The JNDI Name to lookup the managed scheduled executor service.
    keepalive-time LONG false true 60000 When the number of threads is greater than the core, this is the maximum time, in milliseconds, that excess idle threads will wait for new tasks before terminating.
    long-running-tasks BOOLEAN false true false Flag which hints the duration of tasks executed by the scheduled executor.
    reject-policy STRING false true ABORT The policy to be applied to aborted tasks.
    thread-factory STRING false false The name of the thread factory to be used by the scheduled executor.
    thread-priority INT false true 5 The priority applied to threads created by the executor.
  • remove Removes the scheduled executor.
  • terminate-hung-tasks Attempts to terminate the scheduled executor's hung tasks, by cancelling such tasks, and interrupting their executing threads.