Merge pull request #1844 from jrw972/monterey
[ACE_TAO.git] / TAO / tests / Explicit_Event_Loop / README
blobcf06bc507cf2477effef1a736eb199ee6f3a6b0f
3 This tests the methods work_pending() and perform_work() methods of
4 the orb.  The simple time server, instead of calling orb->run(), has
5 an loop in which work_pending() and perform_work() are called
6 explicitly.  Its usage is specified below.
8 ______________________________________________________________________________
9 This test has been adapted from code in chapter 3 of "Advanced CORBA
10 Programming with C++" by Michi Henning and Steve Vinoski. Copyright 1999.
11 Addison-Wesley, Reading, MA.  To make the examples work with TAO, some minor
12 modifications to the source code have been made, with permission, by Mike
13 Moran <mm4@cs.wustl.edu>.   All of these changes are documented in the file
14 CHANGES in this directory.
15 ______________________________________________________________________________
17 Summary:
18     This is the simple time server given in chapter 3 of the book.
19     There is a server process which holds a servant object which can return
20     the current Greenwich time, and a client process which can acess this
21     object.
23 Building:
24     This test uses the ACE_TRY macros, and does not need to use native
25     C++ exceptions.    Make sure to use TAO_FLAG Ge=1 to ensure that
26     CORBA::Environment variables are created in the IDL generated stubs
27     and skeletons.
29     With GNU make, simply type
31     % make
33     to create the executable server and client
35 server:
36     The server takes no parameters nor command line options and returns an
37     IOR to stdout.  The server then waits infinitely for clients requests.
39 client:
40     The client takes an IOR from the command line, prints out the current
41     time, and terminates.
43 run_test.pl:
44     This is currently a UNIX only script!  It starts up the server, redirecting
45     stdout to a file, then passes the file's contents to the command line of
46     the client.  After the client terminates, the server is killed.