Bug 778975 (SOA-1403)

Summary: Programmer's guide does not document how to set max threads on InVM listener
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: David Le Sage <dlesage>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: 4.3 CP01CC: dlesage, ldimaggi
Target Milestone: ---   
Target Release: 4.3 CP05   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1403
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
SOA-P 4.3 CP01
Last Closed: 2011-05-09 00:06:48 UTC Type: Feature Request
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description David Le Sage 2009-07-07 07:23:27 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.)
project_key: SOA

Programmer's guide does not document how to set maxThreads for InVM listener:  http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP01/html-single/Programmers_Guide/index.html#sect-SOA_ESB_Programmers_Guide-What_is_a_Service-InVM_Transport

My understanding is that it is one of the two approaches shown below, but I'm not sure:

----------------------------------------------------------------------------------------
<service category="HelloWorld" name="Service2" description="Service 2" invmScope="GLOBAL">
         <property name="maxThreads">100</property>
         <listeners>...
         <actions>... 
----------------------------------------------------------------------------------------
<service category="HelloWorld" name="Service2" description="Service 2" invmScope="GLOBAL">
        <property name="maxThreads" value="100" />
         <listeners>...
         <actions>... 
----------------------------------------------------------------------------------------
Comment 1 David Le Sage 2009-07-07 07:24:39 UTC 
Cloned from 5.0 JIRA for inclusion in 4.3 CPO3.
Comment 2 David Le Sage 2009-07-07 07:25:23 UTC 
Affects: Added: [Documentation (Ref Guide, User Guide, etc.)]
Comment 3 David Le Sage 2009-07-07 07:26:20 UTC 
Link: Added: This issue depends SOA-1361
Comment 4 David Le Sage 2009-07-07 07:26:44 UTC 
Link: Removed: This issue depends SOA-1361
Comment 5 David Le Sage 2009-07-07 07:27:50 UTC 
Cloned from 5.0 for inclusion in 4.3 CPO3.
Comment 6 David Le Sage 2009-07-07 07:27:50 UTC 
Link: Added: This issue is related to SOA-1361
Comment 7 David Le Sage 2009-10-05 06:01:53 UTC 
Assuming that the data added to 5.0 is correct:


Page 39 of the ESB Programmer's Guide Version 5.0 now states the following:

**********************
Threading

In order to change the number of listener threads associated with an InVM transport:

<service category="HelloWorld" name="Service2" description="Service 2"
            invmScope="GLOBAL">
              <property name="maxThreads" value="100" />
               <listeners>...
               <actions>...

********************** 


We will add this to 4.3CP03
Comment 8 David Le Sage 2010-02-19 06:33:35 UTC 
This has now been added to 4.3CP03.
Comment 9 David Le Sage 2011-03-21 01:18:15 UTC 
Release Notes Docs Status: Added: Not Required
Writer: Added: dlesage
Comment 10 Jiri Pechanec 2011-04-20 13:10:15 UTC 
In version 5 docs the example is put under chapter 4.3.8.  Threading belonging logically under InVM.

In version 4 it is put under chapter 4.4. Service Contract Definition

I think it is illogically placed now.
Comment 11 David Le Sage 2011-05-03 04:07:27 UTC 
I have moved the information. Thanks for the feedback, Jiri.
Comment 12 Len DiMaggio 2011-05-03 19:14:08 UTC 
Still a problem here:

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/4.3/html-single/Programmers_Guide/index.html#sect-SOA_ESB_Programmers_Guide-What_is_a_Service-InVM_Transport
Comment 13 David Le Sage 2011-05-04 06:00:55 UTC 
Fixed - put it in exaclty the same place as the one in 5.x
Comment 14 Len DiMaggio 2011-05-05 17:54:24 UTC 
Hmm - it's not here yet:

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/4.3/html-single/Programmers_Guide/index.html#sect-SOA_ESB_Programmers_Guide-What_is_a_Service-InVM_Transport
Comment 15 David Le Sage 2011-05-05 23:15:15 UTC 
Looks like the change wasn't pushed.  Have sent it up again.
Comment 16 Len DiMaggio 2011-05-06 12:58:18 UTC 
Still not there in:  http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/4.3/html-single/Programmers_Guide/index.html#sect-SOA_ESB_Programmers_Guide-What_is_a_Service-InVM_Transport
Comment 17 David Le Sage 2011-05-08 21:45:22 UTC 
But it is!  See Section 4.3.3.4. 

(Will talk to you on IRC.)
Comment 18 Len DiMaggio 2011-05-09 00:06:48 UTC 
Verified in the book:

It's now in section 4.3.3.4:

4.3.3.4.  Threading
In order to change the number of listener threads associated with an InVM Transport, use this code:
Example 4.3. Threading

<service category="HelloWorld" name="Service2" description="Service 2" 
        invmScope="GLOBAL"> 
       		 <property name="maxThreads" value="100" /> 
         		<listeners>... 
         		<actions>...