$Id$

This is a simple CORBA example that has an object (Echo) with only two
methods, one that returns the message to be displayed and another that
shuts down the server.

run_test.pl : This is a perl script to run the server and client as :
------------
	      server -o ior_file
	      client -f ior_file

This perl script runs the server and client and shuts down the server
when it is done.

Passing the Server IOR to Clients:
---------------------------------

To keep this example simple, the server advertises its IOR in the
following manner - The server program writes its server object's IOR
to a ior_file.  Later on, the client reads this IOR from the specified
ior_file and uses the <string_to_object> method to obtain a reference
to the server object.

For this mechanism to work, the file must be readable and writable. If
it doesn't exist, a new file is created by the server.  Moreover, the
file path must be accessible to both the client and server.

If the client and server are on different machine, then there must be
a shared directory accessible by both. On UNIX system's this is
typically done via the NFS mount command.  On Windows, the 'explorer'
application provides an option to share drives.

In general if no such file sharing option is available, then using the
the Naming Service mechanism is the only alternative, as described by
the -n option below.

server:
-------

server [-d] [-o <ior_output_file>] [-n]

Options:
-------
-d    Debug flag (It is additive more -d flags will give debugging).
-o    Outputs the ior to the file
      The ior is the reference using which the client can interact with
      the target server object.
-n    Use the naming service

When the server is started, you should see as the first line of output
something that looks like

	iiop:1.0//danzon.cs.wustl.edu:10015/P35ad159600081a38/child_poa/server
	(-ORBobjrefstyle url)
or
	IOR:000000000000001649444c3a43756269745...
	(-ORBobjrefstyle ior)

Using -d turns on debugging messages.  This option is additive, i.e.,
the more -d options provided, the more debugging you can get.  At the
moment, only 2 levels of debugging are implemented, and more than 2 -d
options are ignored.

client:
-------

client [-d] [-x] [-f <Server_ior_file>] [-k ior] [-n naming service]

Options:
-------
-d    Debug flag
-x    Tells the server to shutdown at the end of the test.
-f    Reads the server ior from the file
-k    IOR or The IOR can also be given in the format like file://[file.ior]
      with the full path

-n    Use the naming service

You can either cut and paste the IOR from the server to the client
(with the -k option), have the client read the IOR from a file using
the -f option (this file is produced using the -o option of the
server), or use the naming service (with the -n option).