Thu Jul 19 10:37:55 2001 Paul Calabrese <calabrese_p@ociweb.com>

1 files changed, 94 insertions, 67 deletions

diff --git a/TAO/docs/Options.html b/TAO/docs/Options.html
index f2b3b0ae19b..95c1f920320 100644
--- a/TAO/docs/Options.html
+++ b/TAO/docs/Options.html
@@ -102,7 +102,8 @@ The following environment variables are supported by TAO:
 
 <UL>
   <LI><A HREF="#ORB"><CODE>CORBA::ORB</CODE></A>
-  <LI><A HREF="#ResourceFactory"><CODE>TAO_Resource_Factory</CODE></A>
+  <LI><A HREF="#DefaultResourceFactory"><CODE>TAO_Default_Resource_Factory</CODE></A>
+  <LI><A HREF="#AdvancedResourceFactory"><CODE>TAO_Advanced_Resource_Factory</CODE></A>
   <LI><A HREF="#DefaultServer"><CODE>TAO_Default_Server_Strategy_Factory</CODE></A>
   <LI><A HREF="#DefaultClient" TARGET="_top"><CODE>TAO_Default_Client_Strategy_Factory</CODE></A>
   <LI><A HREF="#RT_ORB_Loader"><CODE>RT_ORB_Loader</CODE></A>
@@ -115,7 +116,7 @@ options are set via the service configurator (svc.conf) file.
 </blockquote>
 
 <blockquote>
-<H3><CODE>CORBA::ORB</CODE><A NAME="ORB"></A></H3>
+<H3><A NAME="ORB"></A><CODE>CORBA::ORB</CODE></H3>
 
 <p><em>Note:</em> <code>-ORBGlobalCollocation</code> flag has been
 merged with <a href="#-ORBCollocation"><code>-ORBCollocation</code></a>.
@@ -388,10 +389,7 @@ merged with <a href="#-ORBCollocation"><code>-ORBCollocation</code></a>.
 </P>
 </blockquote>
 
-<H3><CODE>TAO_Resource_Factory</CODE><A NAME="ResourceFactory"></A></H3>
-
-<p><em>Note:</em> <code>-ORBReactorLock</code> flag has been
-superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
+<H3><A NAME="DefaultResourceFactory"></A><CODE>TAO_Default_Resource_Factory</CODE></H3>
 
 <blockquote>
 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
@@ -410,46 +408,6 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
     </TD>
   </TR>
   <TR>
-    <TD><CODE>-ORBReactorType</CODE> <EM>which</EM></TD>
-    <TD><a name="-ORBReactorType"></a>Specify what kind of reactor does the
-        ORB use, the default option is the ACE_TP_Reactor.
-        <TABLE BORDER="1" CELLSPACING="2" CELLPADDING="0">
-          <TR><TH><em>which</em></TH><TH>Reactor</TH>
-        </TR>
-        <TR>
-          <TD><CODE>select_mt</CODE></TD>
-          <TD>Use the multi-thread select-based reactor.</TD>
-        </TR>
-
-        <TR>
-          <TD><CODE>select_st</CODE></TD>
-          <TD>Use the single-thread select-based reactor.</TD>
-        </TR>
-
-        <TR>
-          <TD><CODE>fl</CODE></TD>
-          <TD>Use the FLReactor (FLTK-based).</TD>
-        </TR>
-
-        <TR>
-          <TD><CODE>wfmo</CODE></TD>
-          <TD>Use the WFMO reactor (Win32 only).</TD>
-        </TR>
-
-        <TR>
-          <TD><CODE>msg_wfmo</CODE></TD>
-          <TD>Use the MsgWFMO reactor (Win32 only).</TD>
-        </TR>
-
-        <TR>
-          <TD><CODE>tp</CODE></TD>
-          <TD>Use the <CODE>ACE_TP_Reactor</CODE>, a select based
-              thread-pool reactor.</TD>
-        </TR>
-      </TABLE>
-</TD>
-</TR>
-  <TR>
     <TD><CODE>-ORBReactorMaskSignals</CODE> <EM>0/1</EM></TD>
     <TD>ACE select reactors mask signals during upcalls to the event
         handlers.  This is only useful if the application is going to
@@ -493,24 +451,6 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
   </TD>
 </TR>
 <TR>
-  <TD><CODE>-ORBInputCDRAllocator</CODE> <EM>which</EM></TD>
-  <TD><a name="-ORBInputCDRAllocator"></a>
-      Specify whether the ORB uses locked
-      (<em>which</em> = <code>thread</code>)
-      or lock-free (<em>which</em> = <code>null</code>)
-      allocators for the incoming CDR buffers.
-      Though <CODE>null</CODE> should give the
-      optimal performance;
-      we made the default <CODE>thread</CODE>.
-      TAO optimizations for octet sequences will not work in all cases when
-      if the allocator does not have locks (for example if the
-      octet sequences are part of a return value.
-      Using locked allocators also allows the users to
-      take advantage of the TAO octet sequence
-      extensions to preserve the buffer after the upcall.
-  </TD>
-</TR>
-<TR>
   <TD><CODE>-ORBConnectionCachingStrategy</CODE> <EM>type</EM></TD>
   <TD><a name="-ORBConnectionCachingStrategy"></a>
       Opened connections are added to the transport cache so they can be
@@ -576,6 +516,93 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
       thread until all the data is sent.
   </TD>
 </TR>
+</TABLE>
+</P>
+</blockquote>
+
+<H3><A NAME="AdvancedResourceFactory"></A><CODE>TAO_Advanced_Resource_Factory</CODE></H3>
+
+<p>This factory is located in the TAO_Strategies library.
+It accepts the options below as well as those described above in the
+<A HREF="#DefaultResourceFactory"><CODE>TAO_Default_Resource_Factory</CODE></A>.
+This factory can be loaded dynamically using a service configurator
+directive of the form (all on one line):
+<p><code>dynamic Advanced_Resource_Factory Service_Object * TAO_Strategies:_make_TAO_Advanced_Resource_Factory () "-ORBReactorType select_st"</code>
+
+<p>It can also be loaded statically by doing the following:
+<UL>
+   <LI>Add a <code>#include "tao/Strategies/advanced_resource.h"</code> to the file containing <code>main()</code>
+   <LI>Link the TAO_Strategies library into the executable
+   <LI>Specify a service configurator directive of the form: <code>static Advanced_Resource_Factory "-ORBReactorType select_st"</code>
+</UL>
+<p>Once you have loaded the Advanced_Resource_Factory, then directives for the Resource_Factory have no effect.
+<p><em>Note:</em> <code>-ORBReactorLock</code> flag has been
+superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
+
+<blockquote>
+<P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
+  <TR>
+    <TH>Option</TH>
+    <TH>Description</TH>
+  </TR>
+  <TR>
+    <TD><CODE>-ORBReactorType</CODE> <EM>which</EM></TD>
+    <TD><a name="-ORBReactorType"></a>Specify what kind of reactor does the
+        ORB use, the default option is the ACE_TP_Reactor.
+        <TABLE BORDER="1" CELLSPACING="2" CELLPADDING="0">
+          <TR><TH><em>which</em></TH><TH>Reactor</TH>
+        </TR>
+        <TR>
+          <TD><CODE>select_mt</CODE></TD>
+          <TD>Use the multi-thread select-based reactor.</TD>
+        </TR>
+
+        <TR>
+          <TD><CODE>select_st</CODE></TD>
+          <TD>Use the single-thread select-based reactor.</TD>
+        </TR>
+
+        <TR>
+          <TD><CODE>fl</CODE></TD>
+          <TD>Use the FLReactor (FLTK-based).</TD>
+        </TR>
+
+        <TR>
+          <TD><CODE>wfmo</CODE></TD>
+          <TD>Use the WFMO reactor (Win32 only).</TD>
+        </TR>
+
+        <TR>
+          <TD><CODE>msg_wfmo</CODE></TD>
+          <TD>Use the MsgWFMO reactor (Win32 only).</TD>
+        </TR>
+
+        <TR>
+          <TD><CODE>tp</CODE></TD>
+          <TD>Use the <CODE>ACE_TP_Reactor</CODE>, a select based
+              thread-pool reactor.</TD>
+        </TR>
+      </TABLE>
+</TD>
+</TR>
+<TR>
+  <TD><CODE>-ORBInputCDRAllocator</CODE> <EM>which</EM></TD>
+  <TD><a name="-ORBInputCDRAllocator"></a>
+      Specify whether the ORB uses locked
+      (<em>which</em> = <code>thread</code>)
+      or lock-free (<em>which</em> = <code>null</code>)
+      allocators for the incoming CDR buffers.
+      Though <CODE>null</CODE> should give the
+      optimal performance;
+      we made the default <CODE>thread</CODE>.
+      TAO optimizations for octet sequences will not work in all cases when
+      if the allocator does not have locks (for example if the
+      octet sequences are part of a return value.
+      Using locked allocators also allows the users to
+      take advantage of the TAO octet sequence
+      extensions to preserve the buffer after the upcall.
+  </TD>
+</TR>
 <TR>
   <TD><CODE>-ORBReactorRegistry</CODE> <EM>registry_type</EM></TD>
   <TD><a name="-ORBReactorRegistry"></a>
@@ -594,7 +621,7 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
 </P>
 </blockquote>
 
-<H3><CODE>TAO_Default_Server_Strategy_Factory</CODE><A NAME="DefaultServer"></A></H3>
+<H3><A NAME="DefaultServer"></A><CODE>TAO_Default_Server_Strategy_Factory</CODE></H3>
 
 <p><em>Note:</em> <code>-ORBDemuxStrategy</code> flag has been changed to <code>-ORBSystemidPolicyDemuxStrategy</code> and <code>-ORBUseridPolicyDemuxStrategy</code>.
 <p><em>Note:</em> <code>-ORBTableSize</code> flag has been changed to <code>-ORBActiveObjectMapSize</code>.
@@ -795,7 +822,7 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
 </P>
 </blockquote>
 
-<H3><CODE>TAO_Default_Client_Strategy_Factory</CODE><A NAME="DefaultClient"></A></H3>
+<H3><A NAME="DefaultClient"></A><CODE>TAO_Default_Client_Strategy_Factory</CODE></H3>
 
 <BLOCKQUOTE>
 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" >
@@ -876,7 +903,7 @@ superseded by <code><A HREF="#-ORBReactorType">-ORBReactorType</A></code>.
 </P>
 </BLOCKQUOTE>
 
-<H3><CODE>RT_ORB_Loader</CODE><A NAME="RT_ORB_Loader"></A></H3>
+<H3><A NAME="RT_ORB_Loader"></A><CODE>RT_ORB_Loader</CODE></H3>
 
 <BLOCKQUOTE>
 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0" >