Bug 814142

Summary: Enable dynamic configuration of MessageAwareListener thread pool
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: kconner
Component: JBossESBAssignee: Kevin Conner <kevin.conner>
Status: VERIFIED --- QA Contact: Martin Vecera <mvecera>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.3.0 GACC: jpechane, soa-p-jira
Target Milestone: ---   
Target Release: 5.3.0 GA   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: 5.3.0 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description kconner 2012-04-19 10:05:35 UTC 
Description of problem:

Feature request is to enable the ability to dynamically configure the number of threads in the MessageAwareListener thread pool and have this exposed through the service MBean.

Expected results:

It should be possible to increase and decrease the number of threads in the MessageAwareListener thread pool through the MBean exposed via the console.
Comment 1 kconner 2012-05-24 19:02:48 UTC 
Functionality addressed through JBESB-3785
Comment 2 Filip Nguyen 2012-06-15 11:25:06 UTC 
The functionality is working in the SOA Platform and QA verifies that.

However QA would like to address the documentation because in the current state it is hard to understand.

Suggested change to the section name: "Configuration of Thread Pool for ESB Aware JMS Listener"

Suggested changes to the section content: 
For better throughoutput it is already possible to use the "maxThreads" property for ESB Aware Listeners (see Programmers guide) to statically set the maximum number of concurrent threads for processing of the ESB messages. 
This basic setting may be insufficient when the Service is under heavy load or experiences peaks of load. Therefore it is possible to also configure more sophisticated thread pool for the ESB Aware Listener. By configuring the thread pool the user can set minimum and maximum thread count and SOA Platform will dynamically create threads based on actual load.
The configuration itself is done by using MBean (configurable from JMX-Console under the MBean of the deployed Service). The  configuration methods are: setMinimumThreadPoolCount, setMaximumThreadPoolCount. By setting the thread pool the "maxThreads" properoperty will work as an initial thread count.

Another suggested changes: The maxThreads is closely related to this "thread pool" functionality. It would be nice to make references to this "thread pool" functionality in the programmers guide (beside the maxThreads descriptions).