TAO/tests/Exposed_Policies/README

   1
   2
   3 This directory contains a test case used to verify that the client
   4 exposed policies get embedded correctly in the IOR and exposed to the
   5 client in the object reference.
   6
   7 The policy tested are:
   8
   9     - PriorityModelPolicy
  10     - PriorityBandedConnectionPolicy
  11     - ClientProtocolPolicy
  12
  13 The policy can be set at POA level or at object level. The policies
  14 that have to be associated with a POA or with an object are specified
  15 using a configuration file. As an example we can consider the file
  16 POA.cfg that contains the policy used to create a child POA:
  17
  18 File: POA.cfg
  19
  20         IOR_Source poa.ior
  21
  22         Priority 10
  23
  24         Priority_Bands 5
  25         Priority_Range 3 5
  26         Priority_Range 7 11
  27         Priority_Range 5 9
  28         Priority_Range 1 5
  29         Priority_Range 10 15
  30
  31
  32 The tag used to decribe the information have the following meaning:
  33
  34     - IOR_Source: Defines the name of the file that has to be used to
  35                   store the IOR of the object created.
  36
  37     - Priority: Defines a CORBA::Priority value.
  38
  39     - Priority_Bands: Defines the number of priority bands.
  40
  41     - Priority_Range: Defines the priority range associated with a
  42       priority_band.
  43
  44
  45 The policies value that are specified in the config file can be used
  46 to set the policy at POA level or to override those police on a Object
  47 level basis (beaware that the only policy that can be overridden on an
  48 Object basis is the Priority).
  49
  50 In particular the option "-POAConfigFile" let you specify the policy
  51 that have to be used when the POA is created. While the option
  52 "-ObjectConfigFile" let you set the options on a object basis
  53 overriding the policies that were set at a POA level.
  54
  55
  56 When the test is run two object are created, of this object one has
  57 the same priority that where specified when the POA was created, while
  58 the other ovverride some of them as prescribed in the config file
  59 specified with the option "-ObjectConfigFile".
  60
  61 The config file are used by the client side to verify that what is
  62 embedded in the IOR is correct.
  63
  64
  65 USAGE:
  66
  67    server -ORBSvcConf server.conf -ORBendpoint iiop://<hostaddr>:0/priority=<priority> -ORBendpoint iiop://<hostaddr>:0/priority=<priority> -POAConfigFile <config_file_name> -ObjectConfigFile <config_file_name>
  68
  69    client -POAConfigFile <config_file_name>
  70           -ObjectConfigFile <config_file_name>
  71
  72
  73 EXAMPLE:
  74
  75       $ server -POAConfigFile POA.cfg -ObjectConfigFile Object.cfg
  76
  77       $ client -POAConfigFile POA.cfg -ObjectConfigFile Object.cfg
  78
  79       $ client -POAConfigFile POA.cfg -ObjectConfigFile Object.cfg