TAO/tests/Collocation_Opportunities/README

   1
   2
   3 Description:
   4
   5 A test for making sure the ORB avails all collocation opportunities it
   6 is presented with.
   7
   8 This test has three collocated objects.  The first object is
   9 collocated since the POA created this object and marked it
  10 collocated. In addition, endpoints in the object reference match the
  11 local endpoints and the servant is available.
  12
  13 The second object is collocated since the POA created this object and
  14 marked it collocated. In addition, endpoints in the object reference
  15 match the local endpoints even though the servant is not available at
  16 the time the object was created.
  17
  18 The third object is collocated even though the collocated flag set by
  19 the POA was lost when the second object was converted into a string
  20 and then back. Endpoints in the object reference match the local
  21 endpoints even though the servant is not available at the time the
  22 object was created.
  23
  24 This test checks for POA currents to see if an upcall was collocated
  25 or remote.  If remote, there will be only one POA current since the
  26 upcall will be handled by ORB Task thread.  We ensure that the main
  27 thread does not handle the upcall by setting the
  28 ORBClientConnectionHandler option to RW. If collocated, there will be
  29 a <previous> POA current since the first POA current would be setup
  30 with a call to the <base> servant.