TAO/docs/releasenotes/notify.html

   1 <HTML>
   2 <BODY text="#000000" bgcolor="#FFFFFF">
   3 <!--  -->
   4
   5    <title>TAO's Notification Service</title>
   6
   7 <H1><center>TAO's Notification Service</center> </H1><p>
   8 <p>
   9 <ul>
  10
  11 <li>
  12 <a href="#notify_service">Options to Notify_Service</a>
  13 </li>
  14
  15 <li>
  16 <a href="#feature_matrix">Feature Matrix</a>
  17 </li>
  18
  19
  20 <li>
  21 <a href="#test_framework">Notification Service Testing framework</a>
  22 </li>
  23 </ul>
  24
  25 <HR>
  26 <H2><center><a NAME="notify_service"></a>Options to Notify_Service</center> </H2><p>
  27 <HR>
  28
  29 The <a href="../../orbsvcs/Notify_Service"> Notify_Service </a> driver program options are: <br>
  30
  31
  32 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
  33
  34 <TR>
  35 <TH WIDTH=40%>Command</TH>
  36 <TH >Description</TH>
  37 </TR>
  38
  39 <TR>
  40 <TD> -Factory factory_name
  41 </TD>
  42
  43 <TD>
  44 Uses the <factory_name> as the default name for the Channel Factory.
  45 The default is "NotifyEventChannelFactory".
  46 </TD>
  47 </TR>
  48
  49 <TR>
  50 <TD>-Boot </TD>
  51
  52 <TD>
  53 Flag asking that the factory_name be registered
  54 in the IOR table.
  55 The option is disabled by default.
  56 See the "Using the Boot option" section in the <a href="../../orbsvcs/Notify_Service/README"> README </a> for details.
  57 </TD>
  58
  59 </TR>
  60
  61 <TR>
  62 <TD>-NameSvc </TD>
  63
  64 <TD>
  65 Registers the Factory and if specified, an Event
  66                           Channel with the Naming Service.
  67                           if this option is used, a Naming Service must
  68                           be accessible.
  69                           This option is enabled by default.
  70 </TD>
  71 </TR>
  72
  73 <TR>
  74 <TD>-NoNameSvc</TD>
  75
  76 <TD>Asks to skip any registration with the
  77                           Naming Service.
  78                           This option is disabled by default.
  79 </TD>
  80 </TR>
  81
  82 <TR>
  83
  84 <TD>-IORoutput file_name</TD>
  85
  86 <TD>The IOR is output to the file file_name.
  87                           By default, the IOR is printed out.
  88 </TD>
  89
  90 </TR>
  91
  92 <TR>
  93 <TD>-Channel </TD>
  94
  95 <TD>If this option is specified, a EventChannel is
  96                           created and registered with the Naming Service.
  97                           This option is disabled by default.
  98 </TD>
  99 </TR>
 100
 101 <TR>
 102 <TD>-ChannelName channel_name </TD>
 103 <TD>
 104  Specifes the channel_name to register with the
 105                           Naming Service.
 106                           The default is "NotifyEventChannel".
 107 </TD>
 108 </TR>
 109
 110 <TR>
 111 <TD>-ORBRunThreads threads</TD>
 112 <TD> Specifies the number of threads that will run the ORB::run method.
 113 </TD>
 114 </TR>
 115
 116 </TABLE>
 117 <p>
 118 The Notify_Service driver can be used to load the CosNotification service or it's Real-Time CORBA extension, the RT-Notification.<br>
 119 By using the svc.conf file, the appropriate service is loaded.
 120 <p>To load the CosNotification do: <br>
 121
 122 <tt>
 123 dynamic TAO_Notify_Service Service_Object * TAO_CosNotification:_make_TAO_CosNotify_Service () ""
 124 </tt>
 125 <p> or <br>
 126 <tt> static TAO_CosNotify_Service "" </tt>
 127
 128 <p>
 129 To load the RT-Notification Service, do: <br>
 130 <tt> dynamic TAO_Notify_Service Service_Object * TAO_RT_Notification:_make_TAO_RT_Notify_Service () ""
 131 </tt>
 132 <p>
 133
 134 If your application links to the RT-Notification library, you can configure the RT-Notification statically via: <br>
 135 <tt> static TAO_RT_Notify_Service "" </tt>
 136
 137 <p> The service objects also accept the following options to control concurrency in the Notification. <br>
 138 Note that the <a href="#rt_ext">Notification extensions </a> allow threads to be specified at the EventChannel, Admin and Proxy levels via QoS parameters at run-time.
 139  <br>
 140
 141 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
 142
 143 <TR>
 144 <TH WIDTH=40%>Option</TH>
 145 <TH >Description</TH>
 146 </TR>
 147
 148 <TR>
 149 <TD> -DispatchingThreads [thread_count]
 150 </TD>
 151
 152 <TD>
 153 Specifies the number of threads for dispatching.
 154 </TD>
 155 </TR>
 156
 157 <TR>
 158 <TD> -SourceThreads [thread_count]
 159 </TD>
 160
 161 <TD>
 162 Specifies the number of threads for ProxyConsumer filter evaluation.
 163 </TD>
 164 </TR>
 165
 166 <TR>
 167 <TD> -ListenerThreads [thread_count]
 168 </TD>
 169
 170 <TD>
 171 Specifies the number of threads for ProxySupplier filter evaluation.
 172 </TD>
 173 </TR>
 174
 175 <TR>
 176 <TD> -AsynchUpdates
 177 </TD>
 178
 179 <TD>
 180 Send subscription and publication updates asynchronously.
 181 </TD>
 182 </TR>
 183
 184 <TR>
 185 <TD> -NoUpdates
 186 </TD>
 187
 188 <TD>
 189 Do not send any subscription and publication updates.
 190 </TD>
 191 </TR>
 192
 193 <TR>
 194 <TD> -AllocateTaskperProxy
 195 </TD>
 196
 197 <TD>
 198 Allocate threads for the -LookupThreads and -ListenerThreads <b> per proxy </b> <br>
 199 See the README for further explaination.<br>
 200 </TD>
 201 </TR>
 202
 203 </TABLE>
 204
 205
 206
 207 <hr>
 208 <H2><center><a NAME="feature_matrix"></a>Feature matrix for the Cos Notification Service</center> </H2><p>
 209 <hr>
 210 <H4>Supported Interfaces</H4>
 211
 212 <a href="#qos_admin">CosNotification::QoSAdmin</a><br>
 213 <a href="#admin_prop_admin">CosNotification::AdminPropertiesAdmin</a><br>
 214 <a href="#notify_publish">CosNotifyComm::NotifyPublish</a><br>
 215 <a href="#notify_subscribe">CosNotifyComm::NotifySubscribe</a><br>
 216 <a href="#push_consumer">CosNotifyComm::PushConsumer</a><br>
 217 <a href="#push_supplier">CosNotifyComm::PushSupplier</a><br>
 218 <a href="#structured_push_consumer">CosNotifyComm::StructuredPushConsumer</a><br>
 219 <a href="#structured_push_supplier">CosNotifyComm::StructuredPushSupplier</a><br>
 220 <a href="#sequence_push_consumer">CosNotifyComm::SequencePushConsumer</a><br>
 221 <a href="#sequence_push_supplier">CosNotifyComm::SequencePushSupplier</a><br>
 222 <a href="#filter">CosNotifyFilter::Filter</a><br>
 223 <a href="#filter">CosNotifyFilter::MappingFilter</a><br>
 224 <a href="#filter_factory">CosNotifyFilter::FilterFactory</a><br>
 225 <a href="#filter_admin">CosNotifyFilter::FilterAdmin</a><br>
 226 <a href="#proxy_consumer">CosNotifyChannelAdmin::ProxyConsumer </a><br>
 227 <a href="#proxy_supplier">CosNotifyChannelAdmin::ProxySupplier </a><br>
 228
 229 <a href="#proxy_push_consumer">CosNotifyChannelAdmin::ProxyPushConsumer </a><br>
 230 <a href="#structured_proxy_push_consumer">CosNotifyChannelAdmin::StructuredProxyPushConsumer </a><br>
 231 <a href="#sequence_proxy_push_consumer">CosNotifyChannelAdmin::SequenceProxyPushConsumer </a><br>
 232
 233 <a href="#proxy_push_supplier">CosNotifyChannelAdmin::ProxyPushSupplier </a><br>
 234 <a href="#structured_proxy_push_supplier">CosNotifyChannelAdmin::StructuredProxyPushSupplier </a><br>
 235 <a href="#sequence_proxy_push_supplier">CosNotifyChannelAdmin::SequenceProxyPushSupplier </a><br>
 236
 237 <a href="#consumer_admin">CosNotifyChannelAdmin::ConumerAdmin </a><br>
 238 <a href="#supplier_admin">CosNotifyChannelAdmin::SupplierAdmin </a><br>
 239 <a href="#event_channel">CosNotifyChannelAdmin::EventChannel </a><br>
 240 <a href="#event_channel_factory">CosNotifyChannelAdmin::EventChannelFactory </a><br>
 241
 242 <H4>UnSupported Interfaces</H4>
 243
 244 <a href="#pull_consumer">CosNotifyComm::PullConsumer</a><br>
 245 <a href="#pull_supplier">CosNotifyComm::PullSupplier</a><br>
 246 <a href="#structured_pull_consumer">CosNotifyComm::StructuredPullConsumer</a><br>
 247 <a href="#structured_pull_supplier">CosNotifyComm::StructuredPullSupplier</a><br>
 248
 249 <a href="#sequence_pull_consumer">CosNotifyComm::SequencePullConsumer</a><br>
 250 <a href="#sequence_pull_supplier">CosNotifyComm::SequencePullSupplier</a><br>
 251
 252 <a href="#proxy_pull_supplier">CosNotifyChannelAdmin::ProxyPullSupplier </a><br>
 253 <a href="#structured_proxy_pull_supplier">CosNotifyChannelAdmin::StructuredProxyPullSupplier </a><br>
 254 <a href="#sequence_proxy_pull_supplier">CosNotifyChannelAdmin::SequenceProxyPullSupplier </a><br>
 255 <a href="#proxy_pull_consumer">CosNotifyChannelAdmin::ProxyPullConsumer </a><br>
 256 <a href="#structured_proxy_pull_consumer">CosNotifyChannelAdmin::StructuredProxyPullConsumer </a><br>
 257 <a href="#sequence_proxy_pull_consumer">CosNotifyChannelAdmin::SequenceProxyPullConsumer </a><br>
 258
 259 <a NAME="rt_ext"><H4>Interfaces Extensions for RTCORBA support</H4> </a>
 260 <a href="#ext_ecf">NotifyExt::EventChannelFactory</a><br>
 261 <a href="#ext_ca">NotifyExt::ConsumerAdmin</a><br>
 262 <a href="#ext_sa">NotifyExt::SupplierAdmin</a><br>
 263
 264 <a NAME="qos_admin"></a><HR>
 265  <B>Interface </B> : <CODE>CosNotification::QoSAdmin </CODE><br>
 266 <B>Base Interface(s) </B> : none<br>
 267
 268 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 269           <TR>
 270                 <TH>Method</TH>
 271                 <TH>Supported</TH>
 272                 <TH>Tested</TH>
 273                 <TH>Notes</TH>
 274           </TR>
 275
 276           <TR>
 277                   <TD><CODE>get_qos</CODE></TD>
 278                   <TD>Yes</TD>
 279                   <TD>No</TD>
 280                   <TD></TD>
 281           </TR>
 282
 283           <TR>
 284                   <TD><CODE>set_qos</CODE></TD>
 285                   <TD>Yes</TD>
 286                   <TD>Yes, see <a href="../../orbsvcs/tests/Notify/Ordering"> Ordering </a>
 287                    <a href="../../orbsvcs/tests/Notify/Discarding"> Discarding </a>
 288                                                                                              <br>
 289                   </TD>
 290                   <TD></TD>
 291           </TR>
 292
 293           <TR>
 294                   <TD><CODE>validate_qos</CODE></TD>
 295                   <TD>No</TD>
 296                   <TD></TD>
 297                   <TD></TD>
 298           </TR>
 299
 300 </TABLE> </P>
 301
 302 QoS Properties support on all interfaces supporting CosNotification::QoSAdmin
 303 <ul>
 304 <li> EventReliability : Not supported</li>
 305 <li> ConnectionReliability : Not supported </li>
 306 <li> Priority : Supported Per Message, Priority applied to Channel,
 307 Admin or proxy Objects are NOT applied to the events.
 308
 309 <li> StartTime : Not supported </li>
 310 <li> StopTime : Not Supported </li>
 311
 312 <li> Timeout : Supported Per Message, Timeouts applied to Channel,
 313 Admin or proxy Objects are NOT applied to the events.
 314
 315 <li> StartTimeSupported : Not Supported </li>
 316 <li> StopTimeSupported : Not Supported </li>
 317
 318 <li> MaxEventsPerConsumer : Supported (Only applies to ProxySuppliers)
 319 </li>
 320
 321 <li> OrderPolicy : Supported policies - PriorityOrder, AnyOrder, FifoOrder,
 322 LifoOrder, DeadlineOrder </li>
 323
 324 <li> DiscardPolicy : : Supported policies - PriorityOrder, AnyOrder, FifoOrder,
 325 LifoOrder, DeadlineOrder </li>
 326
 327 <li>MaximumBatchSize : Supported and applied to SequenceProxySuppliers
 328 </li>
 329
 330 <li>PacingInterval : Supported and applied to SequenceProxySuppliers
 331 </li>
 332 </ul>
 333
 334 <a NAME="admin_prop_admin"></a><HR>
 335 <B>Interface </B> : <CODE>CosNotification::AdminPropertiesAdmin </CODE><br>
 336 <B>Base Interface(s) </B> : none<br>
 337
 338
 339 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 340           <TR>
 341                 <TH>Method</TH>
 342                 <TH>Supported</TH>
 343                 <TH>Tested</TH>
 344                 <TH>Notes</TH>
 345           </TR>
 346
 347           <TR>
 348                   <TD><CODE>get_admin</CODE></TD>
 349                   <TD>Yes</TD>
 350                   <TD>No</TD>
 351                   <TD></TD>
 352           </TR>
 353
 354           <TR>
 355                   <TD><CODE>set_admin</CODE></TD>
 356                   <TD>Yes</TD>
 357                   <TD>Yes, see <a href="../../orbsvcs/tests/Notify/Basic/"> Events
 358 </a></TD>
 359                   <TD></TD>
 360           </TR>
 361
 362 </TABLE> </P>
 363
 364 <a NAME="notify_publish"></a><HR>
 365 <B>Interface </B> : <CODE>CosNotifyComm::NotifyPublish </CODE><br>
 366 <B>Base Interface(s) </B> : none<br>
 367
 368 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 369           <TR>
 370                 <TH>Method</TH>
 371                 <TH>Supported</TH>
 372                 <TH>Tested</TH>
 373                 <TH>Notes</TH>
 374           </TR>
 375
 376           <TR>
 377                   <TD><CODE>offer_change</CODE></TD>
 378                   <TD>Yes</TD>
 379                   <TD>Yes, see <a
 380 href="../../orbsvcs/tests/Notify/Basic/"> Updates </a></TD>
 381                   <TD></TD>
 382           </TR>
 383
 384 </TABLE> </P>
 385
 386 <a NAME="notify_subscribe"></a><HR><B>Interface </B> : <CODE>CosNotifyComm::NotifySubscribe </CODE><br>
 387 <B>Base Interface(s) </B> : none<br>
 388
 389
 390 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 391           <TR>
 392                 <TH>Method</TH>
 393                 <TH>Supported</TH>
 394                 <TH>Tested</TH>
 395                 <TH>Notes</TH>
 396           </TR>
 397
 398           <TR>
 399                   <TD><CODE>subscription_change</CODE></TD>
 400                   <TD>Yes</TD>
 401                   <TD> see <a
 402 href="../../orbsvcs/tests/Notify/Basic/"> Updates </a></TD>
 403                   <TD></TD>
 404           </TR>
 405 </TABLE> </P>
 406
 407
 408 <a NAME="push_consumer"></a><HR><P>
 409 <B>Interface </B> : <CODE>CosNotifyComm::PushConsumer </CODE><br>
 410 <B>Base Interface(s) </B> : <CODE><a href="#notify_publish">CosNotifyComm::NotifyPublish</a></CODE>, CosEventComm::PushConsumer <br>
 411
 412 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 413           <TR>
 414                 <TH>Method</TH>
 415                 <TH>Supported</TH>
 416                 <TH>Tested</TH>
 417                 <TH>Notes</TH>
 418           </TR>
 419
 420           <TR>
 421                   <TD><CODE> CosEventComm::PushConsumer::push</CODE></TD>
 422                   <TD>Yes</TD>
 423                   <TD>Yes, see <a
 424 href="../../orbsvcs/tests/Notify/Basic/"> MultiTypes,Simple </a></TD>
 425                   <TD></TD>
 426           </TR>
 427
 428           <TR>
 429                   <TD><CODE> CosEventComm::PushConsumer::disconnect_push_consumer</CODE></TD>
 430                   <TD>Yes</TD>
 431                   <TD>Yes, see <a
 432 href="../../orbsvcs/tests/Notify/Basic/">ConnectDisconnect </a></TD>
 433                   <TD></TD>
 434           </TR>
 435
 436 </TABLE> </P>
 437
 438 <a NAME="pull_consumer"></a><HR><P>
 439 <B>Interface </B> : <CODE>CosNotifyComm::PullConsumer </CODE><br>
 440 <B> Not Supported </B>.
 441 </P>
 442
 443 <a NAME="push_supplier"></a><HR><P>
 444 <B>Interface </B> : <CODE>CosNotifyComm::PushSupplier </CODE><br>
 445 <B>Base Interface(s) </B> : <CODE><a href="#notify_subscribe"> CosNotifyComm::NotifySubscribe</a>, CosEventComm::PushSupplier</CODE> <br>
 446 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 447           <TR>
 448                 <TH>Method</TH>
 449                 <TH>Supported</TH>
 450                 <TH>Tested</TH>
 451                 <TH>Notes</TH>
 452           </TR>
 453
 454           <TR>
 455                   <TD><CODE> CosEventComm::PushConsumer::disconnect_push_supplier</CODE></TD>
 456                   <TD>Yes</TD>
 457                   <TD>Yes, see <a
 458 href="../../orbsvcs/tests/Notify/Basic"> ConnectDisconnect </a></TD>
 459                   <TD></TD>
 460           </TR>
 461
 462 </TABLE> </P>
 463
 464
 465 <a NAME="pull_supplier"></a><HR><P>
 466 <B>Interface </B> : <CODE>CosNotifyComm::PullSupplier </CODE><br>
 467 <B> Not Supported </B>.
 468 </P>
 469
 470
 471 <a NAME="structured_push_consumer"></a><HR>
 472 <B>Interface </B> : <CODE>CosNotifyComm::StructuredPushConsumer </CODE><br>
 473 <B>Base Interface(s) </B><a href="#notify_publish"> CosNotifyComm::NotifyPublish</a> <br>
 474
 475 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 476           <TR>
 477                 <TH>Method</TH>
 478                 <TH>Supported</TH>
 479                 <TH>Tested</TH>
 480                 <TH>Notes</TH>
 481           </TR>
 482
 483           <TR>
 484                   <TD><CODE>push_structured_event</CODE></TD>
 485                   <TD>Yes</TD>
 486                   <TD>Yes, see <a
 487 href="../../orbsvcs/tests/Notify/Basic">MultiTypes </a></TD>
 488                   <TD></TD>
 489           </TR>
 490
 491           <TR>
 492                   <TD><CODE>disconnect_structured_push_consumer</CODE></TD>
 493                   <TD>Yes</TD>
 494                   <TD>Yes, see <a
 495 href="../../orbsvcs/tests/Notify/Basic">ConnectDisconnect </a></TD>
 496                   <TD></TD>
 497           </TR>
 498
 499 </TABLE> </P>
 500
 501 <a NAME="structured_pull_consumer"></a>
 502 <HR><P>
 503 <B>Interface </B> : <CODE>CosNotifyComm::StructuredPullConsumer </CODE><br>
 504 <B> Not Supported </B>.
 505 </P>
 506
 507 <a NAME="structured_pull_supplier"></a>
 508 <HR><P><B>Interface </B> : <CODE>CosNotifyComm::StructuredPullSupplier </CODE><br>
 509 <B> Not Supported </B>.
 510 </P>
 511
 512 <a NAME="structured_push_supplier"></a>
 513 <HR><B>Interface </B> : <CODE>CosNotifyComm::StructuredPushSupplier </CODE><br>
 514 <B>Base Interface(s) </B> <a href="#notify_subscribe">
 515 CosNotifyComm::NotifySubscribe </a> <br>
 516
 517 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 518           <TR>
 519                 <TH>Method</TH>
 520                 <TH>Supported</TH>
 521                 <TH>Tested</TH>
 522                 <TH>Notes</TH>
 523           </TR>
 524
 525           <TR>
 526                   <TD><CODE>disconnect_structured_push_supplier</CODE></TD>
 527                   <TD>Yes</TD>
 528                   <TD>Yes, see <a
 529 href="../../orbsvcs/tests/Notify/Basic/">ConnectDisconnect </a></TD>
 530                   <TD></TD>
 531           </TR>
 532
 533 </TABLE> </P>
 534
 535 <a NAME="sequence_push_consumer"></a><HR>
 536 <B>Interface </B> : <CODE>CosNotifyComm::SequencePushConsumer </CODE><br>
 537 <B>Base Interface(s) </B><a href="#notify_publish"> <CODE>CosNotifyComm::NotifyPublish</CODE> </a><br>
 538
 539 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 540           <TR>
 541                 <TH>Method</TH>
 542                 <TH>Supported</TH>
 543                 <TH>Tested</TH>
 544                 <TH>Notes</TH>
 545           </TR>
 546
 547           <TR>
 548                   <TD><CODE>push_structured_events</CODE></TD>
 549                   <TD>Yes</TD>
 550                   <TD>Yes, see <a
 551 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes </a></TD>
 552                   <TD></TD>
 553           </TR>
 554
 555           <TR>
 556                   <TD><CODE>disconnect_sequence_push_consumer</CODE></TD>
 557                   <TD>Yes</TD>
 558                   <TD>Yes, see <a
 559 href="../../orbsvcs/tests/Notify/Basic/">ConnectDisconnect </a></TD>
 560                   <TD></TD>
 561           </TR>
 562
 563 </TABLE> </P>
 564
 565 <a NAME="sequence_pull_consumer"></a><HR><P>
 566 <B>Interface </B> : <CODE>CosNotifyComm::SequencePullConsumer </CODE><br>
 567 <B> Not Supported </B>.
 568 </P>
 569
 570 <a NAME="sequence_pull_supplier"></a><HR><P>
 571 <B>Interface </B> : <CODE>CosNotifyComm::SequencePullSupplier </CODE><br>
 572 <B> Not Supported </B>.
 573 </P>
 574
 575 <a NAME="sequence_push_supplier"></a><HR>
 576 <B>Interface </B> : <CODE>CosNotifyComm::SequencePushSupplier </CODE><br>
 577 <B>Base Interface(s) </B> <a href="#notify_subscribe">
 578 CosNotifyComm::NotifySubscribe </a> <br>
 579
 580 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 581           <TR>
 582                 <TH>Method</TH>
 583                 <TH>Supported</TH>
 584                 <TH>Tested</TH>
 585                 <TH>Notes</TH>
 586           </TR>
 587
 588           <TR>
 589                   <TD><CODE>disconnect_sequence_push_supplier</CODE></TD>
 590                   <TD>Yes</TD>
 591                   <TD>Yes, see <a
 592 href="../../orbsvcs/tests/Notify/Basic/">ConnectDisconnect </a></TD>
 593                   <TD></TD>
 594           </TR>
 595
 596 </TABLE> </P>
 597
 598 <a NAME="filter"></a><HR><B>Interface </B> : <CODE>CosNotifyFilter::Filter </CODE><br>
 599 <B>Base Interface(s) </B> none <br>
 600
 601
 602 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 603           <TR>
 604                 <TH>Method</TH>
 605                 <TH>Supported</TH>
 606                 <TH>Tested</TH>
 607                 <TH>Notes</TH>
 608           </TR>
 609
 610           <TR>
 611                   <TD><CODE>constraint_grammar</CODE></TD>
 612                   <TD>Yes</TD>
 613                   <TD>No</TD>
 614                   <TD></TD>
 615           </TR>
 616
 617           <TR>
 618                   <TD><CODE>add_constraints</CODE></TD>
 619                   <TD>Yes</TD>
 620                   <TD>Yes, see <a
 621 href="../../orbsvcs/tests/Notify/Basic/">Filter</a></TD>
 622                   <TD></TD>
 623           </TR>
 624
 625           <TR>
 626                   <TD><CODE>modify_constraints</CODE></TD>
 627                   <TD>Yes</TD>
 628                   <TD>No</TD>
 629                   <TD></TD>
 630           </TR>
 631
 632           <TR>
 633                   <TD><CODE>get_constraints</CODE></TD>
 634                   <TD>Yes</TD>
 635                   <TD>No</TD>
 636                   <TD></TD>
 637           </TR>
 638
 639           <TR>
 640                   <TD><CODE>get_all_constraints</CODE></TD>
 641                   <TD>Yes</TD>
 642                   <TD>No</TD>
 643                   <TD></TD>
 644           </TR>
 645
 646           <TR>
 647                   <TD><CODE>remove_all_constraints</CODE></TD>
 648                   <TD>Yes</TD>
 649                   <TD>No</TD>
 650                   <TD></TD>
 651           </TR>
 652
 653           <TR>
 654                   <TD><CODE>destroy</CODE></TD>
 655                   <TD>Yes</TD>
 656                   <TD>No</TD>
 657                   <TD></TD>
 658           </TR>
 659
 660           <TR>
 661                   <TD><CODE>match</CODE></TD>
 662                   <TD>Yes</TD>
 663                   <TD>No</TD>
 664                   <TD></TD>
 665           </TR>
 666
 667           <TR>
 668                   <TD><CODE>match_structured</CODE></TD>
 669                   <TD>Yes</TD>
 670                   <TD>yes, called internally by Notification during
 671 execution of <a
 672 href="../../orbsvcs/tests/Notify/Structured_Filter/">Structured_Filter</TD>
 673                   <TD></TD>
 674           </TR>
 675
 676           <TR>
 677                   <TD><CODE>match_typed</CODE></TD>
 678                   <TD>No</TD>
 679                   <TD>No</TD>
 680                   <TD></TD>
 681           </TR>
 682
 683           <TR>
 684                   <TD><CODE>attach_callback</CODE></TD>
 685                   <TD>No</TD>
 686                   <TD>No</TD>
 687                   <TD></TD>
 688           </TR>
 689
 690           <TR>
 691                   <TD><CODE>detach_callback</CODE></TD>
 692                   <TD>No</TD>
 693                   <TD>No</TD>
 694                   <TD></TD>
 695           </TR>
 696
 697           <TR>
 698                   <TD><CODE>get_callbacks</CODE></TD>
 699                   <TD>No</TD>
 700                   <TD>No</TD>
 701                   <TD></TD>
 702           </TR>
 703
 704 </TABLE> </P>
 705
 706 <HR><P>
 707 <a NAME="mapping_filter"></a><B>Interface </B> : <CODE>CosNotifyFilter::MappingFilter </CODE><br>
 708 <B> Not Supported </B>.
 709 </P>
 710
 711 <a NAME="filter_factory"></a><HR><B>Interface </B> : <CODE>CosNotifyFilter::FilterFactory </CODE><br>
 712 <B>Base Interface(s) </B> none <br>
 713
 714
 715 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 716           <TR>
 717                 <TH>Method</TH>
 718                 <TH>Supported</TH>
 719                 <TH>Tested</TH>
 720                 <TH>Notes</TH>
 721           </TR>
 722
 723           <TR>
 724                   <TD><CODE>create_filter</CODE></TD>
 725                   <TD>Yes</TD>
 726                   <TD>Yes, see <a
 727 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
 728                   <TD></TD>
 729           </TR>
 730
 731           <TR>
 732                   <TD><CODE>create_mapping_filter</CODE></TD>
 733                   <TD>No</TD>
 734                   <TD></TD>
 735                   <TD></TD>
 736           </TR>
 737
 738 </TABLE> </P>
 739
 740
 741 <a NAME="filter_admin"></a><HR><B>Interface </B> : <CODE>CosNotifyFilter::FilterAdmin </CODE><br>
 742 <B>Base Interface(s) </B>
 743
 744
 745 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 746           <TR>
 747                 <TH>Method</TH>
 748                 <TH>Supported</TH>
 749                 <TH>Tested</TH>
 750                 <TH>Notes</TH>
 751           </TR>
 752
 753           <TR>
 754                   <TD><CODE>add_filter</CODE></TD>
 755                   <TD>Yes</TD>
 756                   <TD>Yes, see <a
 757 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
 758                   <TD></TD>
 759           </TR>
 760
 761           <TR>
 762                   <TD><CODE>remove_filter</CODE></TD>
 763                   <TD>Yes</TD>
 764                   <TD>Yes, see <a
 765 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
 766                   <TD></TD>
 767           </TR>
 768
 769           <TR>
 770                   <TD><CODE>get_filter</CODE></TD>
 771                   <TD>Yes</TD>
 772                   <TD>No</TD>
 773                   <TD></TD>
 774           </TR>
 775
 776           <TR>
 777                   <TD><CODE>get_all_filters</CODE></TD>
 778                   <TD>Yes</TD>
 779                   <TD>Yes, see <a
 780 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
 781                   <TD></TD>
 782           </TR>
 783
 784           <TR>
 785                   <TD><CODE>remove_all_filters</CODE></TD>
 786                   <TD>Yes</TD>
 787                   <TD>Yes, see <a
 788 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
 789                   <TD></TD>
 790           </TR>
 791
 792 </TABLE> </P>
 793
 794 <a NAME="proxy_consumer"></a><HR>
 795 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxyConsumer </CODE><br>
 796 <B>Base Interface(s) </B> <CODE> <a href="#qos_admin">CosNotification::QoSAdmin </a><CODE>,
 797 <CODE><a href="#filter_admin"> CosNotifyFilter::FilterAdmin </a></CODE> <br>
 798
 799
 800 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 801           <TR>
 802                 <TH>Method</TH>
 803                 <TH>Supported</TH>
 804                 <TH>Tested</TH>
 805                 <TH>Notes</TH>
 806           </TR>
 807
 808           <TR>
 809                   <TD><CODE>MyType</CODE></TD>
 810                   <TD>Yes</TD>
 811                   <TD>No</TD>
 812                   <TD></TD>
 813           </TR>
 814
 815           <TR>
 816                   <TD><CODE>MyAdmin</CODE></TD>
 817                   <TD>Yes</TD>
 818                   <TD>No</TD>
 819                   <TD></TD>
 820           </TR>
 821
 822           <TR>
 823                   <TD><CODE>obtain_subscription_types</CODE></TD>
 824                   <TD>Yes</TD>
 825                   <TD>Yes, see <a
 826 href="../../orbsvcs/tests/Notify/Basic"> Updates </a></TD>
 827                   <TD>Only CosNotifyChannelAdmin::ALL_NOW_UPDATES_ON tested</TD>
 828           </TR>
 829
 830           <TR>
 831                   <TD><CODE>validate_event_qos</CODE></TD>
 832                   <TD>No</TD>
 833                   <TD></TD>
 834                   <TD></TD>
 835           </TR>
 836
 837 </TABLE> </P>
 838
 839 <a NAME="proxy_supplier"></a><HR>
 840 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxySupplier </CODE><br>
 841 <B>Base Interface(s) </B> <CODE><a href="#qos_admin"> CosNotification::QoSAdmin </a><CODE>,
 842 <CODE> <a href="#filter_admin"> CosNotifyFilter::FilterAdmin </a> </CODE> <br>
 843
 844 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 845           <TR>
 846                 <TH>Method</TH>
 847                 <TH>Supported</TH>
 848                 <TH>Tested</TH>
 849                 <TH>Notes</TH>
 850           </TR>
 851
 852           <TR>
 853                   <TD><CODE>MyType</CODE></TD>
 854                   <TD>Yes</TD>
 855                   <TD>No</TD>
 856                   <TD></TD>
 857           </TR>
 858
 859           <TR>
 860                   <TD><CODE>MyAdmin</CODE></TD>
 861                   <TD>Yes</TD>
 862                   <TD>No</TD>
 863                   <TD></TD>
 864           </TR>
 865
 866           <TR>
 867                   <TD><CODE>priority_filter</CODE></TD>
 868                   <TD>No</TD>
 869                   <TD></TD>
 870                   <TD></TD>
 871           </TR>
 872
 873
 874           <TR>
 875                   <TD><CODE>lifetime_filter</CODE></TD>
 876                   <TD>No</TD>
 877                   <TD></TD>
 878                   <TD></TD>
 879           </TR>
 880
 881           <TR>
 882                   <TD><CODE>obtain_offered_types</CODE></TD>
 883                   <TD>Yes</TD>
 884                   <TD>Yes, see <a
 885 href="../../orbsvcs/tests/Notify/Basic/">Updates </a></TD>
 886                   <TD>Only CosNotifyChannelAdmin::ALL_NOW_UPDATES_ON tested</TD>
 887           </TR>
 888
 889           <TR>
 890                   <TD><CODE>validate_event_qos</CODE></TD>
 891                   <TD>No</TD>
 892                   <TD></TD>
 893                   <TD></TD>
 894           </TR>
 895
 896 </TABLE> </P>
 897
 898 <a NAME="proxy_push_consumer"></a><HR>
 899 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxyPushConsumer </CODE><br>
 900 <B>Base Interface(s) </B> <CODE> <a
 901 href="#proxy_consumer">CosNotification::ProxyConsumer </a>,
 902 <a href="#push_consumer"> CosNotifyComm::PushConsumer <CODE> </a><br>
 903
 904 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 905           <TR>
 906                 <TH>Method</TH>
 907                 <TH>Supported</TH>
 908                 <TH>Tested</TH>
 909                 <TH>Notes</TH>
 910           </TR>
 911
 912           <TR>
 913                   <TD><CODE>connect_any_push_supplier</CODE></TD>
 914                   <TD>Yes</TD>
 915                   <TD>Yes, see <a
 916 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes,ConnectDisconnect </a></TD>
 917                   <TD></TD>
 918           </TR>
 919
 920 </TABLE> </P>
 921
 922 <a NAME="structured_proxy_push_consumer"></a><HR>
 923 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::StructuredProxyPushConsumer </CODE><br>
 924 <B>Base Interface(s) </B> <CODE> <a href="#proxy_consumer">
 925 CosNotification::ProxyConsumer </a>,
 926 <a href="#structured_push_consumer">
 927 CosNotifyComm::StructuredPushConsumer </a> <CODE> <br>
 928
 929 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 930           <TR>
 931                 <TH>Method</TH>
 932                 <TH>Supported</TH>
 933                 <TH>Tested</TH>
 934                 <TH>Notes</TH>
 935           </TR>
 936
 937           <TR>
 938                   <TD><CODE>connect_structured_push_supplier</CODE></TD>
 939                   <TD>Yes</TD>
 940                   <TD>Yes, see <a
 941 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes,ConnectDisconnect </a></TD>
 942                   <TD></TD>
 943           </TR>
 944
 945 </TABLE> </P>
 946
 947 <a NAME="sequence_proxy_push_consumer"></a><HR>
 948 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::SequenceProxyPushConsumer </CODE><br>
 949 <B>Base Interface(s) </B> <CODE> <a href="#proxy_consumer">
 950 CosNotification::ProxyConsumer </a>,
 951 <a href="#sequence_push_consumer"> CosNotifyComm::SequencePushConsumer
 952 </a> <CODE> <br>
 953
 954 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
 955           <TR>
 956                 <TH>Method</TH>
 957                 <TH>Supported</TH>
 958                 <TH>Tested</TH>
 959                 <TH>Notes</TH>
 960           </TR>
 961
 962           <TR>
 963                   <TD><CODE>connect_sequence_push_supplier</CODE></TD>
 964                   <TD>Yes</TD>
 965                   <TD>Yes, see <a
 966 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes,ConnectDisconnect </a></TD>
 967                   <TD></TD>
 968           </TR>
 969
 970 </TABLE> </P>
 971
 972 <a NAME="proxy_pull_supplier"></a><HR><P>
 973 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxyPullSupplier</CODE><br>
 974 <B> Not Supported </B>.
 975 </P>
 976
 977 <a NAME="structured_proxy_pull_supplier"></a><HR><P>
 978 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::StructuredProxyPullSupplier</CODE><br>
 979 <B> Not Supported </B>.
 980 </P>
 981
 982 <a NAME="sequence_proxy_pull_supplier"></a><HR><P>
 983 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::SequenceProxyPullSupplier</CODE><br>
 984 <B> Not Supported </B>.
 985 </P>
 986
 987 <a NAME="proxy_pull_consumer"></a><HR><P>
 988 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxyPullConsumer</CODE><br>
 989 <B> Not Supported </B>.
 990 </P>
 991
 992 <a NAME="structured_proxy_pull_consumer"></a><HR><P>
 993 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::StructuredProxyPullConsumer</CODE><br>
 994 <B> Not Supported </B>.
 995 </P>
 996
 997 <a NAME="sequence_proxy_pull_consumer"></a><HR><P>
 998 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::SequenceProxyPullConsumer</CODE><br>
 999 <B> Not Supported </B>.
1000 </P>
1001
1002 <a NAME="proxy_push_supplier"></a><HR>
1003 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ProxyPushSupplier </CODE><br>
1004 <B>Base Interface(s) </B> <CODE> CosNotification::ProxySupplier,
1005 CosNotifyComm::PushSupplier <CODE> <br>
1006
1007 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1008           <TR>
1009                 <TH>Method</TH>
1010                 <TH>Supported</TH>
1011                 <TH>Tested</TH>
1012                 <TH>Notes</TH>
1013           </TR>
1014
1015           <TR>
1016                   <TD><CODE>connect_any_push_consumer</CODE></TD>
1017                   <TD>Yes</TD>
1018                   <TD>Yes, see <a
1019 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes,ConnectDisconnect </a></TD>
1020                   <TD></TD>
1021           </TR>
1022
1023           <TR>
1024                   <TD><CODE>suspend_connection</CODE></TD>
1025                   <TD>Yes</TD>
1026                   <TD>No</TD>
1027                   <TD></TD>
1028           </TR>
1029
1030           <TR>
1031                   <TD><CODE>resume_connection</CODE></TD>
1032                   <TD>Yes</TD>
1033                   <TD>No</TD>
1034                   <TD></TD>
1035           </TR>
1036
1037 </TABLE> </P>
1038
1039 <a NAME="structured_proxy_push_supplier"></a><HR>
1040 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::StructuredProxyPushSupplier </CODE><br>
1041 <B>Base Interface(s) </B> <CODE> CosNotification::ProxySupplier,
1042 CosNotifyComm::StructuredPushSupplier <CODE> <br>
1043
1044 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1045           <TR>
1046                 <TH>Method</TH>
1047                 <TH>Supported</TH>
1048                 <TH>Tested</TH>
1049                 <TH>Notes</TH>
1050           </TR>
1051
1052           <TR>
1053                   <TD><CODE>connect_structured_push_consumer</CODE></TD>
1054                   <TD>Yes</TD>
1055                   <TD>Yes, see <a
1056 href="../../orbsvcs/tests/Notify/Basic/"> MultiTypes,ConnectDisconnect
1057 </a></TD>
1058                   <TD></TD>
1059           </TR>
1060
1061           <TR>
1062                   <TD><CODE>suspend_connection</CODE></TD>
1063                   <TD>Yes</TD>
1064                   <TD>No</TD>
1065                   <TD></TD>
1066           </TR>
1067
1068           <TR>
1069                   <TD><CODE>resume_connection</CODE></TD>
1070                   <TD>Yes</TD>
1071                   <TD>No</TD>
1072                   <TD></TD>
1073           </TR>
1074
1075 </TABLE> </P>
1076
1077 <a NAME="sequence_proxy_push_supplier"></a><HR>
1078 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::SequenceProxyPushSupplier </CODE><br>
1079 <B>Base Interface(s) </B> <CODE> <a href="#proxy_supplier">
1080 CosNotification::ProxySupplier </a>,
1081 <a href="#sequence_push_supplier"> CosNotifyComm::SequencePushSupplier
1082 </a><CODE> <br>
1083
1084 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1085           <TR>
1086                 <TH>Method</TH>
1087                 <TH>Supported</TH>
1088                 <TH>Tested</TH>
1089                 <TH>Notes</TH>
1090           </TR>
1091
1092           <TR>
1093                   <TD><CODE>connect_sequence_push_consumer</CODE></TD>
1094                   <TD>Yes</TD>
1095                   <TD>Yes, see <a
1096 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes,ConnectDisconnect </a></TD>
1097                   <TD></TD>
1098           </TR>
1099
1100           <TR>
1101                   <TD><CODE>suspend_connection</CODE></TD>
1102                   <TD>Yes</TD>
1103                   <TD>No</TD>
1104                   <TD></TD>
1105           </TR>
1106
1107           <TR>
1108                   <TD><CODE>resume_connection</CODE></TD>
1109                   <TD>Yes</TD>
1110                   <TD>No</TD>
1111                   <TD></TD>
1112           </TR>
1113
1114 </TABLE> </P>
1115
1116 <a NAME="consumer_admin"></a><HR>
1117 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::ConsumerAdmin </CODE><br>
1118 <B>Base Interface(s) </B> <CODE> <a href="#qos_admin">
1119 CosNotification::QoSAdmin </a>
1120     , <a href="#notify_subscribe"> CosNotifyComm::NotifySubscribe </a>
1121     , <a href="#filter_admin"> CosNotifyFilter::FilterAdmin </a>
1122     , CosEventChannelAdmin::ConsumerAdmin </CODE> <br>
1123
1124 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1125           <TR>
1126                 <TH>Method</TH>
1127                 <TH>Supported</TH>
1128                 <TH>Tested</TH>
1129                 <TH>Notes</TH>
1130           </TR>
1131
1132           <TR>
1133                   <TD><CODE>CosEventChannelAdmin::ConsumerAdmin::obtain_push_supplier</CODE></TD>
1134                   <TD>Yes</TD>
1135                   <TD>No</TD>
1136                   <TD></TD>
1137           </TR>
1138
1139
1140           <TR>
1141                   <TD><CODE>CosEventChannelAdmin::ConsumerAdmin::obtain_pull_supplier</CODE></TD>
1142                   <TD>No</TD>
1143                   <TD></TD>
1144                   <TD></TD>
1145           </TR>
1146
1147           <TR>
1148                   <TD><CODE>MyID</CODE></TD>
1149                   <TD>Yes</TD>
1150                   <TD>No</TD>
1151                   <TD></TD>
1152           </TR>
1153
1154           <TR>
1155                   <TD><CODE>MyChannel</CODE></TD>
1156                   <TD>Yes</TD>
1157                   <TD>No</TD>
1158                   <TD></TD>
1159           </TR>
1160
1161           <TR>
1162                   <TD><CODE>MyOperator</CODE></TD>
1163                   <TD>Yes</TD>
1164                   <TD>No</TD>
1165                   <TD></TD>
1166           </TR>
1167
1168           <TR>
1169                   <TD><CODE>priority_filter</CODE></TD>
1170                   <TD>No</TD>
1171                   <TD></TD>
1172                   <TD></TD>
1173           </TR>
1174
1175           <TR>
1176                   <TD><CODE>lifetime_filter</CODE></TD>
1177                   <TD>No</TD>
1178                   <TD></TD>
1179                   <TD></TD>
1180           </TR>
1181
1182           <TR>
1183                   <TD><CODE>pull_suppliers</CODE></TD>
1184                   <TD>No</TD>
1185                   <TD></TD>
1186                   <TD></TD>
1187           </TR>
1188
1189           <TR>
1190                   <TD><CODE>push_suppliers</CODE></TD>
1191                   <TD>Yes</TD>
1192                   <TD>No</TD>
1193                   <TD></TD>
1194           </TR>
1195
1196           <TR>
1197                   <TD><CODE>get_proxy_supplier</CODE></TD>
1198                   <TD>Yes</TD>
1199                   <TD>Yes, see <a
1200 href="../../orbsvcs/tests/Notify/Basic/">Updates </a></TD>
1201                   <TD></TD>
1202           </TR>
1203
1204           <TR>
1205                   <TD><CODE>obtain_notification_pull_supplier</CODE></TD>
1206                   <TD>No</TD>
1207                   <TD></TD>
1208                   <TD></TD>
1209           </TR>
1210
1211           <TR>
1212                   <TD><CODE>obtain_notification_push_supplier</CODE></TD>
1213                   <TD>Yes</TD>
1214                   <TD>Yes, see
1215 <a
1216 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes, ConnectDisconnect
1217 </a></TD>
1218                   <TD></TD>
1219           </TR>
1220
1221           <TR>
1222                   <TD><CODE>destroy</CODE></TD>
1223                   <TD>Yes</TD>
1224                   <TD>Yes, see <a
1225 href="../../orbsvcs/tests/Notify/Basic/">LifeCycle, IdAssignment </a></TD>
1226                   <TD></TD>
1227           </TR>
1228
1229 </TABLE> </P>
1230
1231 <a NAME="supplier_admin"></a><HR>
1232 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::SupplierAdmin </CODE><br>
1233 <B>Base Interface(s) </B> <CODE> <a href="#qos_admin">
1234 CosNotification::QoSAdmin </a>
1235     , <a href="#notify_publish"> CosNotifyComm::NotifyPublish </a>
1236     , <a href="#filter_admin"> CosNotifyFilter::FilterAdmin </a>
1237     , CosEventChannelAdmin::SupplierAdmin </CODE> <br>
1238
1239 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1240           <TR>
1241                 <TH>Method</TH>
1242                 <TH>Supported</TH>
1243                 <TH>Tested</TH>
1244                 <TH>Notes</TH>
1245           </TR>
1246
1247           <TR>
1248                   <TD><CODE>CosEventChannelAdmin::SupplierAdmin::obtain_push_consumer</CODE></TD>
1249                   <TD>Yes</TD>
1250                   <TD>No</TD>
1251                   <TD></TD>
1252           </TR>
1253
1254           <TR>
1255                   <TD><CODE>CosEventChannelAdmin::SupplierAdmin::obtain_pull_consumer</CODE></TD>
1256                   <TD>No</TD>
1257                   <TD></TD>
1258                   <TD></TD>
1259           </TR>
1260
1261           <TR>
1262                   <TD><CODE>MyID</CODE></TD>
1263                   <TD>Yes</TD>
1264                   <TD>No</TD>
1265                   <TD></TD>
1266           </TR>
1267
1268           <TR>
1269                   <TD><CODE>MyChannel</CODE></TD>
1270                   <TD>Yes</TD>
1271                   <TD>No</TD>
1272                   <TD></TD>
1273           </TR>
1274
1275           <TR>
1276                   <TD><CODE>MyOperator</CODE></TD>
1277                   <TD>Yes</TD>
1278                   <TD>No</TD>
1279                   <TD></TD>
1280           </TR>
1281
1282           <TR>
1283                   <TD><CODE>pull_consumers</CODE></TD>
1284                   <TD>No</TD>
1285                   <TD></TD>
1286                   <TD></TD>
1287           </TR>
1288
1289           <TR>
1290                   <TD><CODE>push_consumers</CODE></TD>
1291                   <TD>Yes</TD>
1292                   <TD>No</TD>
1293                   <TD></TD>
1294           </TR>
1295
1296           <TR>
1297                   <TD><CODE>get_proxy_consumer</CODE></TD>
1298                   <TD>Yes</TD>
1299                   <TD>Yes, see <a
1300 href="../../orbsvcs/tests/Notify/Basic/">Updates </a></TD>
1301                   <TD></TD>
1302           </TR>
1303
1304           <TR>
1305                   <TD><CODE>obtain_notification_pull_supplier</CODE></TD>
1306                   <TD>No</TD>
1307                   <TD></TD>
1308                   <TD></TD>
1309           </TR>
1310
1311           <TR>
1312                   <TD><CODE>obtain_notification_push_consumer</CODE></TD>
1313                   <TD>Yes</TD>
1314                   <TD>Yes, see <a
1315 href="../../orbsvcs/tests/Notify/Basic/">MultiTypes, ConnectDisconnect
1316 </a></TD>
1317                   <TD></TD>
1318           </TR>
1319
1320           <TR>
1321                   <TD><CODE>destroy</CODE></TD>
1322                   <TD>Yes</TD>
1323                   <TD>Yes, see <a
1324 href="../../orbsvcs/tests/Notify/Basic/"> LifeCycle, IdAssignment </a></TD>
1325                   <TD></TD>
1326           </TR>
1327
1328 </TABLE> </P>
1329
1330 <a NAME="event_channel"></a><HR>
1331 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::EventChannel </CODE><br>
1332 <B>Base Interface(s) </B> <CODE> <a href="#qos_admin">
1333 CosNotification::QoSAdmin </a>
1334     , <a href="#admin_prop_admin">
1335 CosNotification::AdminPropertiesAdmin </a>
1336     , CosEventChannelAdmin::EventChannel </CODE> <br>
1337
1338 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1339           <TR>
1340                 <TH>Method</TH>
1341                 <TH>Supported</TH>
1342                 <TH>Tested</TH>
1343                 <TH>Notes</TH>
1344           </TR>
1345
1346           <TR>
1347                   <TD><CODE>CosEventChannelAdmin::EventChannel::for_consumers</CODE></TD>
1348                   <TD>Yes</TD>
1349                   <TD>No</TD>
1350                   <TD></TD>
1351           </TR>
1352
1353           <TR>
1354                   <TD><CODE>CosEventChannelAdmin::EventChannel::for_suppliers</CODE></TD>
1355                   <TD>Yes</TD>
1356                   <TD>No</TD>
1357                   <TD></TD>
1358           </TR>
1359
1360           <TR>
1361                   <TD><CODE>CosEventChannelAdmin::EventChannel::destroy</CODE></TD>
1362                   <TD>Yes</TD>
1363                   <TD>yes, see <a
1364 href="../../orbsvcs/tests/Notify/Basic/"> Events, Filter </a> </TD>
1365                   <TD></TD>
1366           </TR>
1367
1368           <TR>
1369                   <TD><CODE>MyFactory</CODE></TD>
1370                   <TD>Yes</TD>
1371                   <TD>No</TD>
1372                   <TD></TD>
1373           </TR>
1374
1375           <TR>
1376                   <TD><CODE>default_consumer_admin</CODE></TD>
1377                   <TD>Yes</TD>
1378                   <TD>Yes, see <a
1379 href="../../orbsvcs/tests/Notify/Basic/">Events </a></TD>
1380                   <TD></TD>
1381           </TR>
1382
1383           <TR>
1384                   <TD><CODE>default_supplier_admin</CODE></TD>
1385                   <TD>Yes</TD>
1386                   <TD>Yes, see <a
1387 href="../../orbsvcs/tests/Notify/Basic/">Events </a></TD>
1388                   <TD></TD>
1389           </TR>
1390
1391           <TR>
1392                   <TD><CODE>default_filter_factory</CODE></TD>
1393                   <TD>Yes</TD>
1394                   <TD>Yes, see <a
1395 href="../../orbsvcs/tests/Notify/Basic/">Filter </a></TD>
1396                   <TD></TD>
1397           </TR>
1398
1399           <TR>
1400                   <TD><CODE>new_for_consumers</CODE></TD>
1401                   <TD>Yes</TD>
1402                   <TD>Yes, see <a
1403 href="../../orbsvcs/tests/Notify/Basic/">Simple,Events </a></TD>
1404                   <TD></TD>
1405           </TR>
1406
1407           <TR>
1408                   <TD><CODE>new_for_suppliers</CODE></TD>
1409                   <TD>Yes</TD>
1410                   <TD>Yes, see <a
1411 href="../../orbsvcs/tests/Notify/Basic/">Simple,Events </a></TD>
1412                   <TD></TD>
1413           </TR>
1414
1415           <TR>
1416                   <TD><CODE>get_consumeradmin</CODE></TD>
1417                   <TD>Yes</TD>
1418                   <TD>Yes, see <a
1419 href="../../orbsvcs/tests/Notify/Basic/">IdAssignment </a></TD>
1420                   <TD></TD>
1421           </TR>
1422
1423           <TR>
1424                   <TD><CODE>get_supplieradmin</CODE></TD>
1425                   <TD>Yes</TD>
1426                   <TD>Yes, see <a
1427 href="../../orbsvcs/tests/Notify/Basic/">IdAssignment </a></TD>
1428                   <TD></TD>
1429           </TR>
1430
1431           <TR>
1432                   <TD><CODE>get_all_consumeradmins</CODE></TD>
1433                   <TD>Yes</TD>
1434                   <TD>No</TD>
1435                   <TD></TD>
1436           </TR>
1437
1438           <TR>
1439                   <TD><CODE>get_all_supplieradmins</CODE></TD>
1440                   <TD>Yes</TD>
1441                   <TD>No</TD>
1442                   <TD></TD>
1443           </TR>
1444
1445 </TABLE> </P>
1446
1447
1448 AdminProperties supported at the EventChannel are:
1449 <ul>
1450 <li>
1451 MaxQueueLength, MaxConsumers, MaxSuppliers, RejectNewEvents
1452 </li>
1453 </ul>
1454
1455 see <a href="../../orbsvcs/tests/Notify/Basic/"> AdminProperties </a>
1456
1457 <a NAME="event_channel_factory"></a><HR>
1458 <B>Interface </B> : <CODE>CosNotifyChannelAdmin::EventChannelFactory </CODE><br>
1459 <B>Base Interface(s) </B>: none  <br>
1460
1461 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1462           <TR>
1463                 <TH>Method</TH>
1464                 <TH>Supported</TH>
1465                 <TH>Tested</TH>
1466                 <TH>Notes</TH>
1467           </TR>
1468
1469           <TR>
1470                   <TD><CODE>create_channel</CODE></TD>
1471                   <TD>Yes</TD>
1472                   <TD>Yes,  see <a
1473 href="../../orbsvcs/tests/Notify/Basic/">Events,Simple</a></TD>
1474                   <TD></TD>
1475           </TR>
1476
1477           <TR>
1478                   <TD><CODE>get_all_channels</CODE></TD>
1479                   <TD>Yes</TD>
1480                   <TD>No</TD>
1481                   <TD></TD>
1482           </TR>
1483
1484           <TR>
1485                   <TD><CODE>get_event_channel</CODE></TD>
1486                   <TD>Yes</TD>
1487                   <TD>Yes, see <a
1488 href="../../orbsvcs/tests/Notify/Basic/">IdAssignment </a></TD>
1489                   <TD></TD>
1490           </TR>
1491
1492 </TABLE> </P>
1493
1494 <a NAME="ext_ecf"></a><HR>
1495  <B>Interface </B> : <CODE>NotifyExt::EventChannelFactory</CODE><br>
1496 <B>Base Interface(s) </B> : CosNotifyChannelAdmin::EventChannelFactory<br>
1497
1498 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1499           <TR>
1500                 <TH>Method</TH>
1501                 <TH>Supported</TH>
1502                 <TH>Tested</TH>
1503                 <TH>Notes</TH>
1504           </TR>
1505
1506           <TR>
1507                   <TD><CODE>destroy</CODE></TD>
1508                   <TD>Yes</TD>
1509                   <TD>Yes, see <a href="../../orbsvcs/tests/Notify/Destroy"> Destroy </a>
1510                   </TD>
1511                   <TD></TD>
1512           </TR>
1513
1514 </TABLE> </P>
1515
1516 <a NAME="ext_ca"></a><HR>
1517  <B>Interface </B> : <CODE>NotifyExt::ConsumerAdmin</CODE><br>
1518 <B>Base Interface(s) </B> : CosNotifyChannelAdmin::ConsumerAdmin<br>
1519
1520 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1521           <TR>
1522                 <TH>Method</TH>
1523                 <TH>Supported</TH>
1524                 <TH>Tested</TH>
1525                 <TH>Notes</TH>
1526           </TR>
1527
1528           <TR>
1529                   <TD><CODE>obtain_notification_push_supplier_with_qos</CODE></TD>
1530                   <TD>Yes</TD>
1531                   <TD>Yes, see <a href="../../orbsvcs/tests/Notify/Lanes"> Lanes </a>
1532                   </TD>
1533                   <TD></TD>
1534           </TR>
1535
1536 </TABLE> </P>
1537
1538 <a NAME="ext_sa"></a><HR>
1539  <B>Interface </B> : <CODE>NotifyExt::SupplierAdmin</CODE><br>
1540 <B>Base Interface(s) </B> : CosNotifyChannelAdmin::SupplierAdmin<br>
1541
1542 <P><TABLE BORDER="2" CELLSPACING="2" CELLPADDING="0">
1543           <TR>
1544                 <TH>Method</TH>
1545                 <TH>Supported</TH>
1546                 <TH>Tested</TH>
1547                 <TH>Notes</TH>
1548           </TR>
1549
1550           <TR>
1551                   <TD><CODE>obtain_notification_push_consumer_with_qos</CODE></TD>
1552                   <TD>Yes</TD>
1553                   <TD>Yes, see <a href="../../orbsvcs/tests/Notify/Lanes"> Lanes </a>
1554                   </TD>
1555                   <TD></TD>
1556           </TR>
1557
1558 </TABLE> </P>
1559
1560 The additional QoS properties supported are: <br>
1561
1562 <ul>
1563 <li>
1564 ThreadPoolParams
1565 </li>
1566
1567 <li>
1568 ThreadPoolLanesParams
1569 </li>
1570 </ul>
1571
1572 see the <a href="../../orbsvcs/orbsvcs/NotifyExt.idl"> NotifyExt.idl </a> file for the QoS definitions.
1573
1574 <P>
1575 <HR>
1576 <H2><center><a NAME="test_framework"></a>Scripting Options for Notification Service Testing framework</center> </H2><p>
1577 <HR>
1578
1579 The Notification Service Testing framework uses the Service Configurator to load various command objects. <br>
1580 The <tt>Command_Builder</tt> object is used to load the target objects. <br>
1581 To test the various Notification features we then write scripts to rapidly reproduce test cases.<br>
1582
1583 The <a href="../../orbsvcs/tests/Notify/Driver" >Notify_Test_Driver </a> program reads a svc.conf file and executes the commands specified. <br>
1584 The following options can specified to the Driver program: <p>
1585
1586
1587 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1588
1589 <TR>
1590 <TH WIDTH=40%>Command</TH>
1591 <TH>Description</TH>
1592 </TR>
1593
1594 <TR>
1595
1596 <TD>-Timeout timeout_period_in_seconds</TD>
1597
1598 <TD> Specify the timeout period for this test</TD>
1599
1600 </TR>
1601
1602 <TR>
1603
1604 <TD>-IORoutput output_file_name</TD>
1605
1606 <TD> Output the IOR of the <a href="../../orbsvcs/tests/Notify/lib/Activation_Manager.idl" >Activation Manager </a>.<br>
1607 This is used by a client to signal its peer.</TD>
1608
1609 </TR>
1610
1611 <TR>
1612
1613 <TD>-IORinput file://input_file_name</TD>
1614
1615 <TD>
1616  Input the IOR of the peer's  <a href="../../orbsvcs/tests/Notify/lib/Activation_Manager.idl" >Activation Manager </a>.<br>
1617 This is used to signal the peer.
1618 </TD>
1619
1620 </TR>
1621
1622 <TR>
1623 <TD>-Skip_Priority_Levels_Check</TD>
1624
1625 <TD>
1626 Skip the check for multiple priority levels.
1627 </TD>
1628
1629 </TR>
1630
1631 </TABLE>
1632 <p>
1633 See the *.conf files in <a href="../../orbsvcs/tests/Notify/Lanes" >Lanes </a>
1634 and
1635 <a href="../../orbsvcs/tests/Notify/ThreadPool" >ThreadPool </a>
1636 for examples of the test framework in use.
1637
1638 <p>
1639 The options that can be specified to each target object are as follows:
1640 <p>
1641
1642 <h3>Target Object : <b> EventChannel </b></h3>
1643 Loading Syntax: dynamic TAO_Notify_EventChannel_Command_Factory Service_Object *TAO_NotifyTests:_make_TAO_Notify_EventChannel_Command_Factory () ""
1644
1645 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1646
1647 <TR>
1648 <TH WIDTH=20%>Command</TH>
1649 <TH>Parameters</TH>
1650 <TH>Description</TH>
1651 </TR>
1652
1653 <TR>
1654 <TD>-Create </TD>
1655 <TD WIDTH=60%>Name_of_channel <br> Name_of_EventChannelFactory <br> [COLLOCATED]
1656 </TD>
1657 <TD>Create an Event Channel</TD>
1658 </TR>
1659 </TABLE>
1660
1661 <br><b>Example : </b> static Command_Builder "EventChannel -Create ec1 NotifyEventChannelFactory"
1662
1663 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1664
1665 <TR>
1666 <TH WIDTH=20%>Command</TH>
1667 <TH>Parameters</TH>
1668 <TH>Description</TH>
1669 </TR>
1670
1671 <TR>
1672 <TD>-Destroy</TD>
1673 <TD WIDTH=60%>Name_of_channel
1674 </TD>
1675 <TD>Destroy an Event Channel</TD>
1676 </TR>
1677 </TABLE>
1678
1679 <br><b>Example : </b> static Command_Builder "EventChannel -Destroy ec1"
1680
1681 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1682
1683 <TR>
1684 <TH WIDTH=20%>Command</TH>
1685 <TH WIDTH=60%>Parameters</TH>
1686 <TH>Description</TH>
1687 </TR>
1688
1689 <TR>
1690 <TD>-Set_QoS</TD>
1691 <TD >
1692 Name_of_channel [QoS_Options]
1693 </TD>
1694
1695 <TD>Set QoS parameters on an event channel
1696 </TD>
1697 </TR>
1698 </TABLE>
1699 <br>
1700 QoS_Options = -ThreadPool  [-Threads thread_pool_size (default= 1) ]
1701
1702 [-Priority default_priority (default=ACE_DEFAULT_THREAD_PRIORITY)]
1703 |
1704
1705 -Lanes lane_count [-Lane priority static_threads dynamic_threads]*
1706
1707 <p><b>Example : </b>: static Command_Builder "EventChannel -Set_QoS -ThreadPool Threads 2 -Priority 2"
1708 <br><b>Example : </b>: static Command_Builder "EventChannel -Set_QoS -Lanes  2 -Lane 10 1 0 -Lane 30 2 1"
1709
1710 <hr>
1711
1712 <h3>Target Object : <b> ConsumerAdmin </b></h3>
1713 Loading Syntax: dynamic TAO_Notify_ConsumerAdmin_Command_Factory Service_Object *TAO_NotifyTests:_make_TAO_Notify_ConsumerAdmin_Command_Factory () ""
1714
1715 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1716
1717 <TR>
1718 <TH WIDTH=20%>Command</TH>
1719 <TH WIDTH=60%>Parameters</TH>
1720 <TH>Description</TH>
1721 </TR>
1722
1723 <TR>
1724 <TD>-Create</TD>
1725 <TD>
1726 Name_of_Admin <br>
1727
1728 Name_of_EventChannel <br>
1729
1730 [-AND_OP | OR_OP (default = CosNotifyChannelAdmin::OR_OP)]
1731
1732 </TD>
1733 <TD>Create a ConsumerAdmin</TD>
1734 </TR>
1735 </TABLE>
1736
1737 <br><b>Example : </b>: static Command_Builder "ConsumerAdmin -Create ca1 ec1 -AND_OP"
1738
1739 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1740
1741 <TR>
1742 <TH WIDTH=20%>Command</TH>
1743 <TH WIDTH=60%>Parameters</TH>
1744 <TH>Description</TH>
1745 </TR>
1746
1747 <TR>
1748 <TD>-Subscription</TD>
1749 <TD>
1750 Name_of_Admin <br>
1751
1752 +added_type1 +added_type2 ... -removed_type3 -removed_type4 ...
1753 </TD>
1754
1755 <TD>Send subscription updates to the ConsumerAdmin. Note that domain name  is  set to "*".
1756 </TD>
1757
1758 </TR>
1759 </TABLE>
1760
1761 <br><b>Example : </b>: static Command_Builder "ConsumerAdmin -Subscription ca1 +Red +Green -Blue"
1762
1763 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1764
1765 <TR>
1766 <TH WIDTH=20%>Command</TH>
1767 <TH WIDTH=60%>Parameters</TH>
1768 <TH>Description</TH>
1769 </TR>
1770
1771 <TR>
1772 <TD>-Set_QoS</TD>
1773 <TD >
1774 Name_of_Admin [QoS_Options]
1775 </TD>
1776
1777 <TD>
1778 Set QoS options for ConsumerAdmin
1779 </TD>
1780
1781 </TR>
1782 </TABLE>
1783 <P>
1784 QoS_Options = -ThreadPool  [-Threads thread_pool_size (default= 1) ]
1785
1786 [-Priority default_priority (default=ACE_DEFAULT_THREAD_PRIORITY)]
1787 |
1788
1789 -Lanes  lane_count [-Lane priority static_threads dynamic_threads]*
1790
1791 <p><b>Example : </b>: static Command_Builder "ConsumerAdmin -Set_Qos -ThreadPool Threads 2 -Priority 2"
1792 <br><b>Example : </b>: static Command_Builder "ConsumerAdmin -Set_Qos -Lanes  2 -Lane 10 1 0 -Lane 30 2 1"
1793
1794 <hr>
1795 <h3>Target Object : <b> SupplierAdmin </b></h3>
1796 Loading Syntax: dynamic TAO_Notify_SupplierAdmin_Command_Factory Service_Object *TAO_NotifyTests:_make_TAO_Notify_SupplierAdmin_Command_Factory () ""
1797
1798 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1799
1800 <TR>
1801 <TH WIDTH=20%>Command</TH>
1802 <TH WIDTH=60%>Parameters</TH>
1803 <TH>Description</TH>
1804 </TR>
1805
1806 <TR>
1807 <TD>-Create</TD>
1808 <TD>
1809 Name_of_Admin <br>
1810
1811 Name_of_EventChannel <br>
1812
1813 [-AND_OP | OR_OP (default = CosNotifyChannelAdmin::OR_OP)]
1814
1815 </TD>
1816 <TD>Create a SupplierAdmin</TD>
1817 </TR>
1818 </TABLE>
1819
1820 <br><b>Example : </b>: static Command_Builder "SupplierAdmin -Create sa1 ec1 -AND_OP"
1821
1822 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1823
1824 <TR>
1825 <TH WIDTH=20%>Command</TH>
1826 <TH WIDTH=60%>Parameters</TH>
1827 <TH>Description</TH>
1828 </TR>
1829
1830 <TR>
1831 <TD>-Offer</TD>
1832 <TD>
1833 Name_of_Admin <br>
1834
1835 +added_type1 +added_type2 ... -removed_type3 -removed_type4 ...
1836 </TD>
1837
1838 <TD>Send offer updates to the SupplierAdmin. Note that domain name  is  set to "*".
1839 </TD>
1840
1841 </TR>
1842 </TABLE>
1843
1844 <br><b>Example : </b>: static Command_Builder "SupplierAdmin -Offer ca1 +Red +Green -Blue"
1845
1846 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1847
1848 <TR>
1849 <TH WIDTH=20%>Command</TH>
1850 <TH WIDTH=60%>Parameters</TH>
1851 <TH>Description</TH>
1852 </TR>
1853
1854 <TR>
1855 <TD>-Set_QoS</TD>
1856 <TD >
1857 Name_of_Admin [QoS_Options]
1858 </TD>
1859
1860 <TD>
1861 Set QoS options for SupplierAdmin
1862 </TD>
1863
1864 </TR>
1865 </TABLE>
1866 <P>
1867 QoS_Options = -ThreadPool  [-Threads thread_pool_size (default= 1) ]
1868
1869 [-Priority default_priority (default=ACE_DEFAULT_THREAD_PRIORITY)]
1870 |
1871
1872 -Lanes  lane_count [-Lane priority static_threads dynamic_threads]*
1873
1874 <p><b>Example : </b>: static Command_Builder "SupplierAdmin -Set_Qos -ThreadPool Threads 2 -Priority 2"
1875 <br><b>Example : </b>: static Command_Builder "SupplierAdmin -Set_Qos -Lanes  2 -Lane 10 1 0 -Lane 30 2 1"
1876
1877 <hr>
1878 <h3>Target Object : <b> PeriodicConsumer </b></h3>
1879 Loading Syntax: dynamic TAO_Notify_Periodic_Consumer_Command_Factory Service_Object* TAO_NotifyTests:_make_TAO_Notify_Periodic_Consumer_Command_Factory () ""
1880
1881 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1882
1883 <TR>
1884 <TH WIDTH=20%>Command</TH>
1885 <TH WIDTH=60%>Parameters</TH>
1886 <TH>Description</TH>
1887 </TR>
1888
1889 <TR>
1890 <TD>-Create</TD>
1891 <TD>
1892 Name_of_Consumer<br>
1893
1894 [-Relay relay_destination] <br>
1895 [-Direct] <br>
1896
1897 [-Admin Name_of_ConsumerAdmin] <br>
1898
1899 [-POA name_of_POA (default = RootPOA)]<br>
1900
1901 [-Proxy proxy_name] <br>
1902
1903 [-Set_QoS [Qos_Options]] <br>
1904
1905 [-MaxCount expected_number_of_events] <br>
1906
1907 [-Check_Priority]
1908
1909 </TD>
1910 <TD>Create a PeriodicConsumer. The consumer is activated in the POA specified.
1911 </TD>
1912 </TR>
1913 </TABLE>
1914
1915 <br><b>Example : </b>: static Command_Builder "PeriodicConsumer -Create c1 ca1 -POA myPOA -Proxy ca1_proxy -MaxCount 10"
1916
1917 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1918
1919 <TR>
1920 <TH WIDTH=20%>Command</TH>
1921 <TH WIDTH=60%>Parameters</TH>
1922 <TH>Description</TH>
1923 </TR>
1924
1925 <TR>
1926 <TD>-Subscription</TD>
1927 <TD>
1928 Name_of_Consumer <br>
1929
1930 +added_type1 +added_type2 ... -removed_type3 -removed_type4 ...
1931
1932 </TD>
1933
1934 <TD>
1935 static Command_Builder "PeriodicConsumer -Subscription  ca1 +Red +Green -Blue"
1936 </TD>
1937
1938 </TR>
1939 </TABLE>
1940
1941 <br><b>Example : </b>: Send subscription updates to its proxy. Note that domain name  is  set to "*".
1942
1943 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1944
1945 <TR>
1946 <TH WIDTH=20%>Command</TH>
1947 <TH WIDTH=60%>Parameters</TH>
1948 <TH>Description</TH>
1949 </TR>
1950
1951 <TR>
1952 <TD>-Disconnect</TD>
1953 <TD>
1954 Name_of_Consumer
1955 </TD>
1956
1957 <TD>Disconnect the Consumer from the EventChannel.
1958 </TD>
1959
1960 </TR>
1961 </TABLE>
1962
1963 <br><b>Example : </b>: static Command_Builder -PeriodicConsumer "Disconnect ca1"
1964
1965
1966 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1967
1968 <TR>
1969 <TH WIDTH=20%>Command</TH>
1970 <TH WIDTH=60%>Parameters</TH>
1971 <TH>Description</TH>
1972 </TR>
1973
1974 <TR>
1975 <TD>-Deactivate</TD>
1976 <TD>
1977 Name_of_Consumer
1978 </TD>
1979
1980 <TD>Deactivate the Consumer from its POA </TD>
1981
1982 </TR>
1983 </TABLE>
1984
1985 <br><b>Example : </b>: static Command_Builder "-PeriodicConsumer -Deactivate ca1"
1986
1987 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
1988
1989 <TR>
1990 <TH WIDTH=20%>Command</TH>
1991 <TH WIDTH=60%>Parameters</TH>
1992 <TH>Description</TH>
1993 </TR>
1994
1995 <TR>
1996 <TD>-Status</TD>
1997 <TD>
1998 Name_of_Consumer
1999 </TD>
2000 <TD>Print the status of the consumer.
2001
2002 Checks if the proxy is alive.
2003 </TD>
2004 </TR>
2005 </TABLE>
2006
2007 <br><b>Example : </b>: static Command_Builder "-PeriodicConsumer -Status ca1"
2008
2009 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2010
2011 <TR>
2012 <TH WIDTH=20%>Command</TH>
2013 <TH WIDTH=60%>Parameters</TH>
2014 <TH>Description</TH>
2015 </TR>
2016
2017 <TR>
2018 <TD>-Set_QoS</TD>
2019 <TD >
2020 Name_of_consumer [QoS_Options]
2021 </TD>
2022
2023 <TD>Set QoS parameters on a Periodic Consumer. The actual QoS settings are applied to the corresponding ProxySupplier.
2024 </TD>
2025 </TR>
2026 </TABLE>
2027 <br>
2028 QoS_Options = -ThreadPool  [-Threads thread_pool_size (default= 1) ]
2029
2030 [-Priority default_priority (default=ACE_DEFAULT_THREAD_PRIORITY)]
2031 |
2032
2033 -Laness lane_count [-Lane priority static_threads dynamic_threads]*
2034
2035 <p><b>Example : </b>: static Command_Builder "PeriodicConsumer -Set_QoS -ThreadPool Threads 2 -Priority 2"
2036 <br><b>Example : </b>: static Command_Builder "PeriodicConsumer -Set_QoS -Lanes  2 -Lane 10 1 0 -Lane 30 2 1"
2037
2038 <hr>
2039 <h3>Target Object : <b> PeriodicSupplier </b></h3>
2040 Loading Syntax: dynamic TAO_Notify_Periodic_Supplier_Command_Factory Service_Object* TAO_NotifyTests:_make_TAO_Notify_Periodic_Supplier_Command_Factory () ""
2041
2042 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2043
2044 <TR>
2045 <TH WIDTH=20%>Command</TH>
2046 <TH WIDTH=60%>Parameters</TH>
2047 <TH>Description</TH>
2048 </TR>
2049
2050 <TR>
2051 <TD>-Create</TD>
2052 <TD>
2053
2054 Name_of_Supplier <br>
2055
2056 [-Direct direct_target]<br>
2057
2058 [-Admin Name_of_ConsumerAdmin] <br>
2059
2060 [-POA name_of_POA (default = RootPOA)]<br>
2061
2062 [-Proxy proxy_name] <br>
2063
2064 [-Set_QoS [Qos_Options]] <br>
2065
2066 -EventType type_of_event <br>
2067
2068 -FilterLongData name  long_filterable_data <br>
2069
2070 -Priority supplier_thread_priority <br>
2071
2072 -Period  sending_period (in microseconds) <br>
2073
2074 -ExecTime estimated_time_per_send_operation <br>
2075
2076 -Phase supplier_thread_starting_phase <br>
2077
2078 -Iter number_of_events-to_send <br>
2079
2080 -Load hint_to_consumer <br>
2081
2082 -RunTime time_to_run_in_sec
2083 </TD>
2084
2085 <TD>
2086 Create a PeriodicSupplier.
2087
2088 The supplier is activated in the POA specified.
2089 <br>
2090 The -Create command spawns a thread that sends periodic events.
2091
2092 </TD>
2093 </TR>
2094 </TABLE>
2095
2096 <br><b>Example : </b>: static Command_Builder "PeriodicSupplier -Create s1 sa1_ec1 -Proxy s1_proxy -EventType RED -FilterLongData Temp 3 -Priority 0 -Period 10000 -ExecTime 10000 -Phase 0 -Iter 1 -Load 1 "
2097
2098
2099 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2100
2101 <TR>
2102 <TH WIDTH=20%>Command</TH>
2103 <TH WIDTH=60%>Parameters</TH>
2104 <TH>Description</TH>
2105 </TR>
2106
2107 <TR>
2108 <TD>-Offer</TD>
2109 <TD>
2110 Name_of_Supplier <br>
2111
2112 +added_type1 +added_type2 ... -removed_type3 -removed_type4 ...
2113
2114 </TD>
2115
2116 <TD>
2117 static Command_Builder "PeriodicSupplier -Offer sa1 +Red +Green -Blue"
2118 </TD>
2119
2120 </TR>
2121 </TABLE>
2122
2123 <br><b>Example : </b>: Send offer updates to its proxy. Note that domain name  is  set to "*".
2124
2125 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2126
2127 <TR>
2128 <TH WIDTH=20%>Command</TH>
2129 <TH WIDTH=60%>Parameters</TH>
2130 <TH>Description</TH>
2131 </TR>
2132
2133 <TR>
2134 <TD>-Disconnect</TD>
2135 <TD>
2136 Name_of_Supplier
2137 </TD>
2138
2139 <TD>Disconnect the Supplier from the EventChannel.
2140 </TD>
2141
2142 </TR>
2143 </TABLE>
2144
2145 <br><b>Example : </b>: static Command_Builder -PeriodicSupplier "Disconnect sa1"
2146
2147
2148 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2149
2150 <TR>
2151 <TH WIDTH=20%>Command</TH>
2152 <TH WIDTH=60%>Parameters</TH>
2153 <TH>Description</TH>
2154 </TR>
2155
2156 <TR>
2157 <TD>-Deactivate</TD>
2158 <TD>
2159 Name_of_Supplier
2160 </TD>
2161
2162 <TD>Deactivate the Supplier from its POA </TD>
2163
2164 </TR>
2165 </TABLE>
2166
2167 <br><b>Example : </b>: static Command_Builder "-PeriodicSupplier -Deactivate ca1"
2168
2169 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2170
2171 <TR>
2172 <TH WIDTH=20%>Command</TH>
2173 <TH WIDTH=60%>Parameters</TH>
2174 <TH>Description</TH>
2175 </TR>
2176
2177 <TR>
2178 <TD>Status</TD>
2179 <TD>
2180 Name_of_Supplier
2181 </TD>
2182 <TD>Print the status of the consumer.
2183
2184 Checks if the proxy is alive.
2185 </TD>
2186 </TR>
2187 </TABLE>
2188
2189 <br><b>Example : </b>: static Command_Builder "-PeriodicSupplier -Status sa1"
2190
2191 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2192
2193 <TR>
2194 <TH WIDTH=20%>Command</TH>
2195 <TH WIDTH=60%>Parameters</TH>
2196 <TH>Description</TH>
2197 </TR>
2198
2199 <TR>
2200 <TD>-Set_QoS</TD>
2201 <TD >
2202 Name_of_Supplier [QoS_Options]
2203 </TD>
2204
2205 <TD>Set QoS parameters on a Periodic Supplier. The actual QoS settings are applied to the corresponding ProxyConsumer.
2206 </TD>
2207 </TR>
2208 </TABLE>
2209 <br>
2210 QoS_Options = -ThreadPool  [-Threads thread_pool_size (default= 1) ]
2211
2212 [-Priority default_priority (default=ACE_DEFAULT_THREAD_PRIORITY)]
2213 |
2214
2215 -Laness lane_count [-Lane priority static_threads dynamic_threads]*
2216
2217 <p><b>Example : </b>: static Command_Builder "PeriodicSupplier -Set_QoS -ThreadPool Threads 2 -Priority 2"
2218 <br><b>Example : </b>: static Command_Builder "PeriodicSupplier -Set_QoS -Lanes  2 -Lane 10 1 0 -Lane 30 2 1"
2219
2220 <hr>
2221
2222 <h3>Target Object : <b> Filter </b></h3>
2223 Loading Syntax: dynamic TAO_Notify_Filter_Command_Factory Service_Object* TAO_NotifyTests:_make_TAO_Notify_Filter_Command_Factory () ""
2224
2225 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2226
2227 <TR>
2228 <TH WIDTH=20%>Command</TH>
2229 <TH WIDTH=60%>Parameters</TH>
2230 <TH>Description</TH>
2231 </TR>
2232
2233 <TR>
2234 <TD>-CreateFactory</TD>
2235
2236 <TD>
2237 Filter_Factory_Name<br>
2238
2239 Event_Channel_Name
2240 </TD>
2241
2242 <TD>Obtain the default FilterFactory  from the EventChannel.
2243 </TD>
2244 </TR>
2245 </TABLE>
2246
2247 <br><b>Example : </b>: static Command_Builder "Filter -CreateFactory ff ec1"
2248
2249 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2250
2251 <TR>
2252 <TH WIDTH=20%>Command</TH>
2253 <TH WIDTH=60%>Parameters</TH>
2254 <TH>Description</TH>
2255 </TR>
2256
2257 <TR>
2258 <TD>-CreateFilter</TD>
2259
2260 <TD>
2261 Filter_Name<br>
2262 Filter_Factory_Name
2263 </TD>
2264
2265 <TD>Create a Filter
2266 </TD>
2267 </TR>
2268 </TABLE>
2269
2270 <br><b>Example : </b>: static Command_Builder "Filter -CreateFilter f1 ff"
2271
2272 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2273
2274 <TR>
2275 <TH WIDTH=20%>Command</TH>
2276 <TH WIDTH=60%>Parameters</TH>
2277 <TH>Description</TH>
2278 </TR>
2279
2280 <TR>
2281 <TD>-Add_Constraint</TD>
2282
2283 <TD>
2284 Filter_Name
2285 <br>
2286 Constraint_Expression
2287 </TD>
2288
2289 <TD>
2290 Add a constraint to a filter.
2291
2292 </TD>
2293 </TR>
2294 </TABLE>
2295
2296 <br><b>Example : </b>: static Command_Builder "Filter -Add_Constraint f1 'Temp > 2'"
2297
2298 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2299
2300 <TR>
2301 <TH WIDTH=20%>Command</TH>
2302 <TH WIDTH=60%>Parameters</TH>
2303 <TH>Description</TH>
2304 </TR>
2305
2306 <TR>
2307 <TD>-AddFilter</TD>
2308
2309 <TD>
2310 Filter_Name
2311 <br>
2312 FilterAdmin_Name
2313 </TD>
2314
2315 <TD>
2316 Add a filter to an Admin.
2317
2318 The FilterAdmin can be the name of any Admin or Proxy objects.
2319
2320 </TD>
2321 </TR>
2322 </TABLE>
2323
2324 <br><b>Example : </b>: static Command_Builder "Filter -Add_Filter f1 sa1_ec1"
2325
2326 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2327
2328 <TR>
2329 <TH WIDTH=20%>Command</TH>
2330 <TH WIDTH=60%>Parameters</TH>
2331 <TH>Description</TH>
2332 </TR>
2333
2334 <TR>
2335 <TD>-Destroy</TD>
2336
2337 <TD>
2338 Filter_Name
2339 <br>
2340 </TD>
2341
2342 <TD>
2343 Destroy the Filter.
2344
2345 </TD>
2346 </TR>
2347 </TABLE>
2348
2349 <br><b>Example : </b>: static Command_Builder "Filter –Destroy ff "
2350
2351 <hr>
2352 <h3>Target Object : <b> Application </b></h3>
2353 Loading Syntax for RTCORBA Application: <br>
2354 dynamic TAO_Notify_RT_Application_Command_Factory Service_Object * TAO_RT_NotifyTests:_make_TAO_Notify_RT_Application_Command_Factory () "" <br>
2355 Loading Syntax for non-RTCORBA Application: <br>
2356 dynamic TAO_Notify_Application_Command_Factory Service_Object * TAO_NotifyTests:_make_TAO_Notify_Application_Command_Factory () ""
2357
2358 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2359
2360 <TR>
2361 <TH WIDTH=20%>Command</TH>
2362 <TH WIDTH=60%>Parameters</TH>
2363 <TH>Description</TH>
2364 </TR>
2365
2366 <TR>
2367 <TD>-Init</TD>
2368
2369 <TD>
2370 <br>
2371 </TD>
2372
2373 <TD>
2374 Init the Application
2375
2376 </TD>
2377 </TR>
2378 </TABLE>
2379
2380 <br><b>Example : </b>: static Command_Builder "Application -Init"
2381
2382 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2383
2384 <TR>
2385 <TH WIDTH=20%>Command</TH>
2386 <TH WIDTH=60%>Parameters</TH>
2387 <TH>Description</TH>
2388 </TR>
2389
2390 <TR>
2391 <TD>-Run</TD>
2392
2393 <TD>
2394 <br>
2395 </TD>
2396
2397 <TD>
2398 Run all the suppliers and consumers.
2399
2400 </TD>
2401 </TR>
2402 </TABLE>
2403
2404 <br><b>Example : </b>: static Command_Builder "Application -Run"
2405
2406
2407 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2408
2409 <TR>
2410 <TH WIDTH=20%>Command</TH>
2411 <TH WIDTH=60%>Parameters</TH>
2412 <TH>Description</TH>
2413 </TR>
2414
2415 <TR>
2416 <TD>-WaitForEvents</TD>
2417
2418 <TD>
2419 <br>
2420 </TD>
2421
2422 <TD>
2423 Wait till all the suppliers have send all there events and all the consumers have received the expected count of events.
2424
2425 </TD>
2426 </TR>
2427 </TABLE>
2428
2429 <br><b>Example : </b>: static Command_Builder "Application –Wait_For_Events"
2430
2431
2432 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2433
2434 <TR>
2435 <TH WIDTH=20%>Command</TH>
2436 <TH WIDTH=60%>Parameters</TH>
2437 <TH>Description</TH>
2438 </TR>
2439
2440 <TR>
2441 <TD>-Shutdown</TD>
2442
2443 <TD>
2444 <br>
2445 </TD>
2446
2447 <TD>
2448 Shutdown the ORB.
2449
2450 </TD>
2451 </TR>
2452 </TABLE>
2453
2454 <br><b>Example : </b>: static Command_Builder "Application –Shutdown"
2455
2456
2457 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2458
2459 <TR>
2460 <TH WIDTH=20%>Command</TH>
2461 <TH WIDTH=60%>Parameters</TH>
2462 <TH WIDTH=20%>Description</TH>
2463 </TR>
2464
2465 <TR>
2466 <TD>-DumpStats</TD>
2467
2468 <TD>
2469 [-Samples]
2470 <br>
2471 </TD>
2472
2473 <TD>
2474 Dump performance statistics. <br>
2475
2476 if the -Samples option is specified all the latency samples are generated. <br>
2477
2478 Data files are created in the current directory with the following names: <br>
2479
2480 Supplier_{supplier_name}.dat <br>
2481
2482 Consumer_{consumer_name}.dat <br>
2483
2484 </TD>
2485 </TR>
2486 </TABLE>
2487
2488 <br><b>Example : </b>: static Command_Builder "Application –DumpStats"
2489
2490 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2491
2492 <TR>
2493 <TH WIDTH=20%>Command</TH>
2494 <TH WIDTH=60%>Parameters</TH>
2495 <TH>Description</TH>
2496 </TR>
2497
2498 <TR>
2499 <TD>-SignalPeer</TD>
2500
2501 <TD>
2502 <br>
2503 </TD>
2504
2505 <TD>
2506 Signal another waiting instance of the test.
2507 </TD>
2508 </TR>
2509 </TABLE>
2510
2511 <br><b>Example </b>: static Command_Builder "Application –SignalPeer":
2512
2513 <hr>
2514
2515 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2516
2517 <TR>
2518 <TH WIDTH=20%>Command</TH>
2519 <TH WIDTH=60%>Parameters</TH>
2520 <TH>Description</TH>
2521 </TR>
2522
2523 <TR>
2524 <TD>-WaitToStart</TD>
2525
2526 <TD>
2527 <br>
2528 </TD>
2529
2530 <TD>
2531 Wait for another instance to signal.
2532 </TD>
2533 </TR>
2534 </TABLE>
2535
2536 <br><b>Example </b>:static Command_Builder "Application –WaitToStart"
2537
2538 <hr>
2539
2540 <hr>
2541 <h3>Target Object : <b> POA </b></h3>
2542 Loading Syntax for RTCORBA Application: <br>
2543 dynamic TAO_Notify_RT_POA_Command_Factory Service_Object* TAO_RT_NotifyTests:_make_TAO_Notify_RT_POA_Command_Factory () ""
2544
2545 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2546
2547 <TR>
2548 <TH WIDTH=20%>Command</TH>
2549 <TH WIDTH=60%>Parameters</TH>
2550 <TH>Description</TH>
2551 </TR>
2552
2553 <TR>
2554 <TD>-Create</TD>
2555
2556 <TD>
2557 POA_Name <br>
2558
2559 -PriorityModel {CLIENT|SERVER} default_priority (defaults : CLIENT_PROPAGATED, Priority = 0)<br>
2560
2561 -Lanes lane_count  [-Lane priority static_threads dynamic_threads>]* <br>
2562
2563 -Bands band_count [-Band low_priority high_priority]* <br>
2564
2565 -ThreadPool static_threads priority
2566 <br>
2567 </TD>
2568
2569 <TD>
2570 Create an RT POA with the specified name and options of
2571 </TD>
2572 </TR>
2573 </TABLE>
2574
2575 <br><b>Example : </b>: static Command_Builder "POA -Create poa_test -PriorityModel CLIENT 1 -Lanes 1 -Lane -15 1 0"
2576
2577 <P><TABLE WIDTH = 80% BORDER="1" CELLSPACING="1" CELLPADDING="1">
2578
2579 <TR>
2580 <TH WIDTH=20%>Command</TH>
2581 <TH WIDTH=60%>Parameters</TH>
2582 <TH>Description</TH>
2583 </TR>
2584
2585 <TR>
2586 <TD>-Destroy</TD>
2587
2588 <TD>
2589 POA_Name
2590 <br>
2591 </TD>
2592
2593 <TD>
2594 Destroy a POA
2595 </TD>
2596 </TR>
2597 </TABLE>
2598
2599 <br><b>Example : </b>: static Command_Builder "POA –Destroy”
2600 </BODY>
2601 </HTML>