TAO/tests/ForwardOnceUponException/README

   1 /**
   2
   3 @page ForwardOnceOnException Test README File
   4
   5         This is test for feature of request forwarding ONCE when client
   6         receives OBJECT_NOT_EXIST, COMM_FAILURE, TRANSIENT or INV_OBJREF
   7         exceptions from server. The forward once feature defaults to be off.
   8         They can be enabled and disabled by -ORBForwardOnceOnObjectNotExist
   9         -ORBForwardOnceOnCommFailure, -ORBForwardOnceOnTransient and
  10         -ORBForwardOnceOnInvObjref options with value 0(disable) and 1(enable).
  11
  12         The servant implementation is made to raise the exceptions.
  13         This is to simulate the server exception reply regardless the actual
  14         meaning of the exceptions. The test also takes advantage of the
  15         IORTable facilities in TAO to create a simple corbaloc IOR, TAO
  16         always responds with a LOCATION_FORWARD message when a request is
  17         made for an object in the IORTable. This would make the stub have the
  18         forward address upon receiving the exceptions so it can perform the
  19         forwarding.
  20
  21         TAO defaults to forwarding request upon COMM_FAILURE and TRANSIENT
  22         exceptions. With forwarding once feature enabled, the client will
  23         catch the exceptions and servant should be called twice for each
  24         request, otherwise, the request will be looping between server and
  25         client.
  26
  27         TAO defaults to not forwarding request upon OBJECT_NOT_EXIST and
  28         INV_OBJREF exceptions from server so the client should catch the exception
  29         and servant should be called once for each request. If the forwarding
  30         once feature is on, the client should catch the exception and servant
  31         should be called twice.
  32
  33         To execute the test simply run:
  34
  35 $ ./run_test.pl
  36
  37         the script returns 0 on success and non-zero on failures.
  38
  39 */