svn commit: r485827 - /incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml

[al...@apache.org]

Author: alally
Date: Mon Dec 11 11:07:57 2006
New Revision: 485827

URL: http://svn.apache.org/viewvc?view=rev&rev=485827
Log:
Removed server-side timeout value for services.  Updated documentation and examples.
UIMA-34: https://issues.apache.org/jira/browse/UIMA-34

Modified:
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml?view=diff&rev=485827&r1=485826&r2=485827
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml Mon Dec 11 11:07:57 2006
@@ -1146,7 +1146,6 @@
            descriptors/analysis_engine/PersonTitleAnnotator.xml</emphasis></emphasis>"/&gt;
 
     &lt;parameter name="numInstances" value="3"/&gt;
-    &lt;parameter name="timeoutPeriod" value="30000"/&gt;
 
     &lt;!-- Type Mappings omitted from this document; 
           you will not need to edit them. --&gt;
@@ -1163,14 +1162,11 @@
         replace the areas indicated in bold italics (deployment name, service name, and
         resource specifier path) with values appropriate for your component.</para>
       
-      <para>The <literal>timeoutPeriod</literal> parameter only is used when there are
-        multiple clients accessing the service. When a new request comes in, if the service is
-        busy with other requests (or all instances are busy, in the case where it has multiple
-        instances), it waits for one to become available - and this parameter specifies the
-        maximum time for that wait. If it takes longer than this, the service wrapper will
-        throw an exception back to the client and abort the processing for this document on the
-        service.</para>
-      
+      <para>The <literal>numInstances</literal> parameter specifies how many instances of
+        your Analysis Engine or CAS Consumer will be created.  This allows your service to
+        support multiple clients concurrently. When a new request comes in, if all of the
+        instances are busy, the new request will wait until an instance becomes available.</para>
+            
       <para>To deploy the Person Title annotator service, issue the following command:
         
         
@@ -1229,8 +1225,6 @@
 
     &lt;parameter name="numInstances" value="1"/&gt;
 
-    &lt;parameter name="timeoutPeriod" value="30000"/&gt;
-
     &lt;parameter name="serverSocketTimeout" value="120000"/&gt;
 
   &lt;/service&gt;
@@ -1242,14 +1236,11 @@
         service name, and resource specifier path) with values appropriate for your
         component.</para>
       
-      <para>The <literal>timeoutPeriod</literal> parameter only is used when there are
-        multiple clients accessing the service. When a new request comes in, if the service is
-        busy with other requests (all instances are busy, in the case where it has multiple
-        instances), it waits for one to become available - and this parameter specifies the
-        maximum time for that wait. If it takes longer than this, the service wrapper will
-        throw an exception back to the client and abort the processing for this document on the
-        service.</para>
-      
+      <para>The <literal>numInstances</literal> parameter specifies how many instances of
+        your Analysis Engine or CAS Consumer will be created.  This allows your service to
+        support multiple clients concurrently. When a new request comes in, if all of the
+        instances are busy, the new request will wait until an instance becomes available.</para>
+            
       <para>The <literal>serverSocketTimeout</literal> parameter specifies the number
         of milliseconds (default = 5 minutes) that the service will wait between requests to
         process something. After this amount of time, the server will presume the client may