WildFly Full 27 Model Reference

  1. home
  2. subsystem=jca
  3. distributed-workmanager
  4. long-running-threads

A thread pool executor with a bounded queue where threads submittings tasks may block. Such a thread pool has a core and maximum size and a specified queue length. When a task is submitted, if the number of running threads is less than the core size, a new thread is created. Otherwise, if there is room in the queue, the task is enqueued. Otherwise, if the number of running threads is less than the maximum size, a new thread is created. Otherwise, the caller blocks until room becomes available in the queue.

Provided capabilities(1)

Attributes (11)

  • allow-core-timeout Whether core threads may time out.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • core-threads The core thread pool size which is smaller than the maximum pool size. If undefined, the core thread pool size is the same as the maximum thread pool size.
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Min 0
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • current-thread-count The current number of threads in the pool.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
  • keepalive-time Used to specify the amount of time that pool threads should be kept running when idle; if not specified, threads will run until the executor is shut down.
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • largest-thread-count The largest number of threads that have ever simultaneously been in the pool.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
  • max-threads The maximum thread pool size.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed true
    Min 0
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • name The name of the thread pool.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-only
  • queue-length The queue length.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed true
    Min 1
    Max 2,147,483,647
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • queue-size The queue size.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
  • rejected-count The number of tasks that have been passed to the handoff-executor (if one is specified) or discarded.
    • Attribute Value
    Type INT
    Nillable false
    Expressions Allowed false
    Storage runtime
    Access Type metric
  • thread-factory Specifies the name of a specific thread factory to use to create worker threads. If not defined an appropriate default thread factory will be used.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services

Operations (2)

  • add Adds a blocking bounded queue thread pool.
    Request Parameter Type Required Expressions Allowed Default value Description
    allow-core-timeout BOOLEAN false true false Whether core threads may time out.
    core-threads INT false true The core thread pool size which is smaller than the maximum pool size. If undefined, the core thread pool size is the same as the maximum thread pool size.
    keepalive-time OBJECT false false Used to specify the amount of time that pool threads should be kept running when idle; if not specified, threads will run until the executor is shut down.
    max-threads INT true true The maximum thread pool size.
    queue-length INT true true The queue length.
    thread-factory STRING false false Specifies the name of a specific thread factory to use to create worker threads. If not defined an appropriate default thread factory will be used.
  • remove Removes a blocking bounded queue thread pool.