--- /dev/null
+<HTML>\r
+<HEAD>\r
+ <!-- Created by GNNpress -->\r
+ <!-- Changed by: Anselm Baird-Smith, 4-Feb-1997 -->\r
+ <TITLE>Socket connection properties reference manual</TITLE>\r
+</HEAD>\r
+<BODY BGCOLOR="white">\r
+<P>\r
+<A HREF="http://www.w3.org/pub/WWW/" TARGET="_top_">\r
+<IMG SRC="/icons/WWW/w3c_home.gif" ALT="W3C" BORDER="0" WIDTH="72"\r
+ HEIGHT="48"></A> <A HREF="http://www.w3.org/pub/WWW/Jigsaw/" TARGET="_top_">\r
+<IMG SRC="/icons/jigsaw" ALT="Jigsaw" BORDER="0"> </A> \r
+ <HR>\r
+<A HREF="resources.html">All Resources</A> <A HREF="filters.html">All filters\r
+</A> \r
+ <HR>\r
+<H1>\r
+ SocketConnectionProp\r
+</H1>\r
+<P>\r
+This resource provides editable access to connection properties specific\r
+to the raw socket access to <B>Jigsaw</B>. As for the other property sheets,\r
+the resource just provides a nice way of describing a set of resources, and\r
+the way they should be edited, so each attribute below, really corresponds\r
+to a property defined in the property file of <B>Jigsaw</B>.\r
+<P>\r
+Tunning these resources can be a very difficult exercise. It is recommended\r
+that you try very hard to understand these properties before playing with\r
+them.\r
+<P>\r
+ <HR>\r
+<H2>\r
+ Inherits\r
+</H2>\r
+<P>\r
+The\r
+<A HREF="../api/w3c.jigsaw.http.socket.SocketConnectionProp.html">SocketConnectionProp</A>\r
+class inherits from the following classes:\r
+<UL>\r
+ <LI>\r
+ PropertySet (aka abstract class)\r
+</UL>\r
+<P>\r
+ <HR>\r
+<H2>\r
+ Attributes description\r
+</H2>\r
+<P>\r
+The ConnectionProp defines the following attributes:\r
+<UL>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.minFree">w3c.jigsaw.http.socket.SocketClientFactory.minFree</A>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.maxFree">w3c.jigsaw.http.socket.SocketClientFactory.maxFree</A>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.maxIdle">w3c.jigsaw.http.socket.SocketClientFactory.maxIdle</A>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.maxThreads">w3c.jigsaw.http.socket.SocketClientFactory.maxThreads</A>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.maxClients">w3c.jigsaw.http.socket.SocketClientFactory.maxClients</A>\r
+ <LI>\r
+ <A HREF="#w3c.jigsaw.http.socket.SocketClientFactory.idleTimeout">w3c.jigsaw.http.socket.SocketClientFactory.idleTimeout</A>\r
+</UL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.minFree">w3c.jigsaw.http.socket.SocketClientFactory.minFree</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The number of free (not working) clients the server has to have in order\r
+ to consider itself under very light load. When the server is running under\r
+ that load, the server will keep connection opens as long as possible (with\r
+ no time out).\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attribute defaults to <STRONG>5</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.maxFree">w3c.jigsaw.http.socket.SocketClientFactory.maxFree</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The number of free (not working) clients the server has to have in order\r
+ to go from the normal load state back into the light load state. The difference\r
+ between that number and\r
+ <A HREF="#w3c.jigsaw.http.ClientPool.minFree">minFree</A> avoids having the\r
+ server yo-yoing from the light load state to the normal load state.\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attributes defaults to <STRONG>10</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.maxIdle">w3c.jigsaw.http.socket.SocketClientFactory.maxIdle</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The maximum number of idle client. An idle client thread is a thread waiting\r
+ for the next request on a persistent connection. When the maxIdle number\r
+ of idle client threads is reached, the server turns itself either into high\r
+ load (if it still has free clients), or dead load otherwise. Under normal\r
+ load, the client pool will make sure to shutdown at least one persistent\r
+ connection before accepting a new one. Under high load the server will start\r
+ adjusting thread prorities (it will lower the accepting thread's priority\r
+ under the normal client's thread priority, to give more CPU to client threads).\r
+ On dead load, the server will reject incomming connections.\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attribute defaults to <STRONG>25</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.maxThreads">w3c.jigsaw.http.socket.SocketClientFactory.maxThreads</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The maximum number of allowed threads, whatever happens.\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attribute defaults to <STRONG>30</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.idleTimeout">w3c.jigsaw.http.socket.SocketClientFactory.idleTimeout</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The timeout that will indicate that a thread is no longer usefull. A minmum\r
+ number of threads will always remain alive, even though this timeout value\r
+ is provided.\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attribute defaults to <STRONG>5000</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<A NAME="w3c.jigsaw.http.socket.SocketClientFactory.maxClients">w3c.jigsaw.http.socket.SocketClientFactory.maxClients</A>\r
+<DL>\r
+ <DT>\r
+ <I>semantics</I>\r
+ <DD>\r
+ The maximum simultaneous number of client connections the server will ever\r
+ accept.\r
+ <DT>\r
+ <I>type</I>\r
+ <DD>\r
+ This attribute is a computed\r
+ <A HREF="../api/w3c.tools.store.IntegerAttribute.html">IntegerAttribute</A>\r
+ <DT>\r
+ <I>default value</I>\r
+ <DD>\r
+ This attribute defaults to <STRONG>40</STRONG>.\r
+</DL>\r
+<P>\r
+ <HR>\r
+<P>\r
+<I><A HREF="mailto:jigsaw@w3.org">Jigsaw Team</A><BR>\r
+</I>$Id: w3c.jigsaw.http.ConnectionProp.html,v 1.1 1996/09/11 21:21:02 abaird\r
+Exp $\r
+<P>\r
+<P>\r
+<P>\r
+</BODY></HTML>\r