TAO/tests/DII_AMI_Forward/README

   1 /**
   2
   3
   4
   5 @page DII_AMI_Forward Test README File
   6
   7 This test illustrates the new feature outlined in bug 3105 for
   8 supporting the detection and handling of a LOCATION FORWARD
   9 exception within a DII based asynch invocation.
  10
  11 DII Asynch reply handlers operate very close to the TAO internals,
  12 receiving raw CDR buffers as parameters rather than collections of
  13 arguments. This example is built on apriori knowledge of the nature
  14 of the call and its return type in order to work. A more general
  15 purpose handler would take a reference to the request instance in
  16 order to handle a variety of responses. As such, it is impractical
  17 to have a single instance of the reply handler supporting more than
  18 one pending invocation.
  19
  20 This test is designed around a server that, on the receipt of the
  21 first invocation raises a location forward exception. The client's
  22 DII asynch reply handler then reissues the invocation using the new
  23 object reference and finally handles the reply.
  24
  25         To run the test use the run_test.pl script:
  26
  27 $ ./run_test.pl
  28
  29         the script returns 0 if the test was successful.
  30
  31 */