$Id: README 94620 2011-10-06 12:11:03Z johnnyw $

This is the cubit example that does everything using DII requests.
It uses the server in IDL_Cubit. Getting a reference
to the Cubit object, making the Cubit operation calls,
and shutting down the server are all done with DII requests.

NOTES: The IDL_Cubit server used to run a Naming Service so the client
        could easily locate it.  This proved too problematic, the test
        required a complete compilation of the orbsvcs library and was
        not reliable. The preferred method is to use a file to pass
        the factory IOR between the server and the client.

To run the tests with one "button-push", execute the perl script run_test.pl
in this directory. It will start up the server and client. The client will
shut down the server when the tests are finished.

If you want to run each executable separately and manually, run the
server first (in IDL_Cubit). Then run the client with zero or more of
the following args:

        [-d]                 Increments TAO_debug_level. It's additive, up
                             to 2 levels of debugging.

        [-n <calls/loop>]    Sets the # of calls per loop (default is 250).

        [-i <factory IOR>]   For passing the IOR by hand.

        [-f <filename>]      If server is run with [-o <filename>] option,
                             it outputs its factory IOR to a file, which
                             the client can read with this option.

        [-x]                 Shuts down server when finished.

If using the -i option, you might want to run the server with the option
[-ORBobjrefstyle url]. This will cause the server to display its IOR in a
more human-readable form. The server can be run in the same window in the
background, or in a different window.

The command line options, default calls per loop, order and display
format of the stats are all similar to those in the IDL_Cubit tests.

On the Unix side, the Makefile will also build IDL_Cubit/server if
necessary (thanks to David Levine).
