*** empty log message ***

1 files changed, 169 insertions, 0 deletions

diff --git a/TAO/performance-tests/Cubit/TAO/IDL_Cubit/README b/TAO/performance-tests/Cubit/TAO/IDL_Cubit/README
new file mode 100644
index 00000000000..ca173cc45ab
--- /dev/null
+++ b/TAO/performance-tests/Cubit/TAO/IDL_Cubit/README
@@ -0,0 +1,169 @@
+// $Id$
+
+This example uses the TAO IDL compiler to generate the SII stubs and
+skeletons.  You can either run the server in the background in the
+same window as the client or open a separate window for the client and
+server.
+
+By default, the client and server use the Naming Service.  The cubit
+server has its own NamingServer implementation.  Therefore, you don't
+have to start the NamingService before starting the client and server.
+Likewise, you can use the -s flags on both the server and client if
+you don't want to use the naming service.
+
+The collocation_test demonstrates how the performance improves when
+objects are collocated.  The test runs both server and client in
+different threads.  To run it, simply run collocation_test.  It
+accepts any command line arguments for the client side, but there is
+not way to specify command line arguments for the server side at this
+moment.  This may be changed in the future.  At this moment, the
+collocation_test must use Naming_Service to resolve object
+references.  This may be changed later, also.
+
+server:
+-------
+
+% server [-d] [-s] [-ORBhost <serverhost>] [-ORBport <portnum>]
+           [-n <number-of-cubit-objects>] [-o <ior_output_file>]
+
+Options:
+-------
+-s       Tells the server not to register the Cubit_Factory object
+         with the Naming Service.
+
+-d       Debug flag (It is additive more -d flags will increase
+         the debugging level).
+
+-o       Outputs the cubit_factory IOR to a file.
+
+-n       Number of cubit objects exported by the server.
+
+The server cubit factory maintains num_of_cubit objects (default =
+1). They are assigned keys that look like "key0", "key1", ...
+
+When the server is started and you have used the -d flag, you should
+see as the first line of output something that looks like the follow:
+
+        iiop:1.0//swarm:10015/Persistent/886013035/850128/RootPOA/RootPOA_is_BAD/factory
+        (-ORBobjrefstyle url)
+or
+        IOR:000000000000001649444c3a43756269745...
+        (-ORBobjrefstyle ior)
+
+Using -d turns on debugging messages.  It is additive, i.e., the more
+-d options provided, the more debugging you get.  At the moment, only
+2 levels of debugging are implemented, and more than 2 -d options are
+silently ignored.
+
+client:
+-------
+
+% client [-d] [-s] [-x] <-f cubit_factory_ior_file> <-k cubit_factory_ior>  -n <iterations>
+
+Options:
+-------
+-d      Debug flag
+-s      Don't Use the Naming Service
+-x      Tells the server to shutdown.
+-f      Reads the cubit factory IOR from the file
+-k      Reads the cubit factory IOR from commandline
+-n      no. of iterations
+
+The following are the three ways of giving the CubitFactory IOR to the
+client:
+
+        1. From a file using the -f option. (This file can be produced using
+                the -o option of the server.)
+
+        2. Directly on the commandline using the -k option.
+
+        3. Get it from the Naming Service (which is the default client
+           behavior).
+
+collocation_test:
+-----------------
+
+        This test demonstrates how collocation optimization improve
+performance of collocated objects.  Run the test without any argument
+to see results with collocation optimization.  Run it with
+<-ORBcollocation no> to perform the same test without the optimization.
+
+run_test.pl:
+------------
+
+        This is a perl script which simplifies the execution of the
+test.
+
+run_test [-h] [-n num] [-mcast] [-sleeptime t] [-debug] [-release]
+
+-h                  -- prints this information
+-n num              -- client uses <num> iterations
+-mcast              -- uses the multicast version of the nameservice
+-sleeptime t        -- run_test should sleep for <t> seconds between running
+                       the server and client
+-debug              -- sets the debug flag for both client and server
+-release            -- runs the Release version of the test (for NT use)
+                       (default is 3 seconds)
+
+Sample Run-Using files to communicate IOR:
+------------------------------------------
+
+1. Start the server.
+
+% server -s -ORBport 20000 -ORBobjrefstyle url -o theior
+
+        IDL_Cubit:SERVER
+
+The IOR is: <iiop:1.0//tango:20000/Persistent/887665222/647179/RootPOA/RootPOA_is_BAD/factory\00\00>
+
+2. Start the client.
+
+%client -s -ORBport 19998 -f theior
+
+         IDL_Cubit: client
+
+Factory received OK
+.
+.
+.
+
+Sample Run-Using Naming Service:
+--------------------------------
+1. Start the server
+        %server -ORBport 19999
+
+2. Start the client
+        %client -ORBport 19998
+                if you don't want the server to shutdown.
+        %client -ORBport 19998  -x
+                if you want to shutdown the server after this request.
+
+3. If Multicast is not supported the naming service can be reached by
+the  following 2 methods.
+
+        a) use the -ORBnameserviceior flag to the client to give the
+        naming service ior outputted by the server.
+
+        b)set the ENVIRONMENT variable "NameService"
+
+        This might be helpful if more than one person is running the
+        Naming service in which case Multicast might cause confusion with some
+        other Naming Service trying to answer your call.
+
+Using JAVA to access the IDL Cubit test:
+----------------------------------------
+
+install JDK1.2
+install Java to IDL compiler
+
+copy the following files:
+cp $TAO_ROOT/orbsvcs/orbsvcs/CosNaming.idl .
+cp $TAO_ROOT/orbsvcs/tests/Simulator/DOVEBrowser/NS_Resolve.java .
+
+Compile:
+javatoidl cubit.idl
+javatoidl CosNaming.idl
+javac *.java
+
+Run:
+java IDL_Cubit_Client