summaryrefslogtreecommitdiff
path: root/TAO/tests/ForwardUponObjectNotExist/README
blob: 1893326c2170504231fb0d168762edbac92853a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
/**

@page ForwardUponObjectNotExist Test README File

$Id$

	This is test for feature of request forwarding when client receives
	OBJECT_NOT_EXIST exception. The feature is enabled and disabled by
	-ORBForwardInvocationOnObjectNotExist [0|1] option.

	The servant implementation is made to raise OBJECT_NOT_EXIST exception.
	This is	to simulate the server exception reply regardless the actual
	meaning of the OBJECT_NOT_EXIST exception. The test also takes advantage
	of the IORTable facilities in TAO to create a simple corbaloc IOR, TAO
	always responds with a LOCATION_FORWARD message when a request is
	made for an object in the IORTable. This would make the stub have the
	forward address upon receiving OBJECT_NOT_EXIST exception so it can
	perform the forwarding. If client runs with the feature disabled
	(-ORBForwardInvocationOnObjectNotExist 0) then the client should catch
	the OBJECT_NOT_EXIST exception, otherwise, the request will be looping
	between server and client and the invocation never ends. The invocation
	finally ends because of the server shutdown.

	To execute the test simply run:

$ ./run_test.pl

	the script returns 0 on success and non-zero on failures.

*/