Merge pull request #2303 from jwillemsen/jwi-803
[ACE_TAO.git] / TAO / examples / Buffered_AMI / README
blobcd283fca6e94d4d51d877ed433bc78d2b3ce70f0
3 Description:
5 This is a simple test for buffered AMI calls.  It invokes multiple AMI
6 calls.  Due to buffering in the ORB, the calls are automatically
7 bunched together instead of being delivered to the server upon every
8 invocation.
10 Expected output:
12 The client invokes an AMI after <interval> amount of time.  Implicit
13 flushing occurs every <message count> invocations.
15 The server prints out the time and the number of the AMI request.  The
16 client prints out the time and the number of the reply.  The output
17 should show a batch of invocations received on the server.
19 How to run:
21 You can use the run_test.pl script to run it or:
23 $ server
24 $ client
26 Notes:
28 - Use TAO_HAS_CORBA_MESSAGING and TAO_HAS_AMI_CALLBACK to compile
29   TAO. This enables the AMI code in it.
31 - Use -GC on the TAO IDL compiler if you want to generate code for AMI
32   callbacks. The IDL compiler needs to be compiled with IDL_HAS_VALUETYPE
33   defined.
35 - You should also use the muxed TransportMuxStrategy since the
36   exclusive strategy will result in multiple queues, one for each
37   exclusive connection.  Since there will be many queues, the
38   buffering constraits will not be met and the queues will not get
39   flushed.
41 - Remember that the AMI callbacks are like nested upcalls.  Therefore,
42   they will not work with the RW ClientConnectionHandler strategy.