Changes between Version 18 and Version 19 of technicalGuideAndManual
- Timestamp:
- 05/21/13 14:40:24 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
technicalGuideAndManual
v18 v19 1 1 {{{ 2 2 #!html 3 <div xml:lang="en" class="article" title="QCG Notification v. 3.0 Technical Guide and Manual"><div class="titlepage"><div><div><h2 class="title"><a id="idm1689856"/><span class="emphasis"><em>QCG Notification</em></span> v. 3.0 Technical Guide and 4 Manual</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Bartosz</span> <span class="surname">Bosak</span></h3><code class="email"><<a class="email" href="mailto:bbosak@man.poznan.pl">bbosak@man.poznan.pl</a>></code></div><div class="author"><h3 class="author"><span class="firstname">Krzysztof</span> <span class="surname">Kurowski</span></h3><code class="email"><<a class="email" href="mailto:krzysztof.kurowski@man.poznan.pl">krzysztof.kurowski@man.poznan.pl</a>></code></div></div></div><div><p class="releaseinfo">3.0.3</p></div><div><p class="copyright">Copyright Š 2008-2013 Poznan Supercomputing and Networking Center</p></div></div><hr/></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#idp32656">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp35296">Motivations</a></span></dt><dt><span class="sect2"><a href="#idp8624">Purpose of the Document</a></span></dt><dt><span class="sect2"><a href="#idp38448">Status</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp39728">Terminology and WS-Notification Concept</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp41568">WS-Notification Concept</a></span></dt><dt><span class="sect2"><a href="#idp135856">UML-style Diagrams</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp167424">User Guide for a Publisher, Subscriber and 5 NotificationConsumer<span class="emphasis"><em> </em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp168496">Prefixes and Namespaces</a></span></dt><dt><span class="sect2"><a href="#idp188128">Interaction with <span class="emphasis"><em>QCG Notification</em></span></a></span></dt><dt><span class="sect2"><a href="#ted">Topics, TopicExpressions and Dialects</a></span></dt><dt><span class="sect2"><a href="#idp217360">Extensions</a></span></dt><dt><span class="sect2"><a href="#idp237760">Methods Description</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp653040">Administration Guide of <span class="emphasis"><em>QCG 6 Notification</em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp656032">Prerequisites</a></span></dt><dt><span class="sect2"><a href="#idp661776">Building</a></span></dt><dt><span class="sect2"><a href="#idp677424">Creating database for <span class="emphasis"><em>QCG Notification</em></span> - the 7 PostgreSQL example</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp698528">Configuration of <span class="emphasis"><em>QCG Notification</em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp699840">Configuration File: <code class="filename">qcg-ntfd.xml</code></a></span></dt><dt><span class="sect2"><a href="#moduleoptions">Module configuration</a></span></dt><dt><span class="sect2"><a href="#idp866480">WS-Topics management</a></span></dt><dt><span class="sect2"><a href="#idp872368">Starting <span class="emphasis"><em>QCG Notification</em></span></a></span></dt><dt><span class="sect2"><a href="#idp877840">Stopping <span class="emphasis"><em>QCG Notification</em></span></a></span></dt></dl></dd></dl></div><div class="sect1" title="Introduction"><div class="titlepage"><div><div><h2 class="title"><a id="idp32656"/>Introduction</h2></div></div></div><p><span class="bold"><strong>QCG Notification</strong></span> is a reference 8 implementation of a set of industry Web Service specifications (<a class="link" href="#WS-Notification"><a class="ulink" href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsn">WS-Notification 9 OASIS standard)</a></a> for message push/pull-style notification, 3 <div xml:lang="en" class="article" title="QCG Notification v. 3.0 Technical Guide and Manual"> 4 <div class="titlepage"> 5 <div> 6 <div> 7 <h2 class="title"> 8 <a id="idp192"/> 9 <span class="emphasis"> 10 <em>QCG Notification 11 </em> 12 </span> v. 3.0 Technical Guide and 13 Manual 14 </h2> 15 </div> 16 <div> 17 <div class="authorgroup"> 18 <div class="author"> 19 <h3 class="author"> 20 <span class="firstname">Bartosz 21 </span> 22 <span class="surname">Bosak 23 </span> 24 </h3> 25 <code class="email">< 26 <a class="email" href="mailto:bbosak@man.poznan.pl">bbosak@man.poznan.pl 27 </a>> 28 </code> 29 </div> 30 <div class="author"> 31 <h3 class="author"> 32 <span class="firstname">Krzysztof 33 </span> 34 <span class="surname">Kurowski 35 </span> 36 </h3> 37 <code class="email">< 38 <a class="email" href="mailto:krzysztof.kurowski@man.poznan.pl">krzysztof.kurowski@man.poznan.pl 39 </a>> 40 </code> 41 </div> 42 </div> 43 </div> 44 <div> 45 <p xml:lang="en" class="releaseinfo">3.0.3 46 </p> 47 </div> 48 <div> 49 <p class="copyright">Copyright Š 2008-2013 Poznan Supercomputing and Networking Center 50 </p> 51 </div> 52 </div> 53 <hr/> 54 </div> 55 <div class="toc"> 56 <p> 57 <strong>Table of Contents 58 </strong> 59 </p> 60 <dl> 61 <dt> 62 <span class="sect1"> 63 <a href="#idp33040">Introduction 64 </a> 65 </span> 66 </dt> 67 <dd> 68 <dl> 69 <dt> 70 <span class="sect2"> 71 <a href="#idp35632">Motivations 72 </a> 73 </span> 74 </dt> 75 <dt> 76 <span class="sect2"> 77 <a href="#idp8624">Purpose of the Document 78 </a> 79 </span> 80 </dt> 81 <dt> 82 <span class="sect2"> 83 <a href="#idp38768">Status 84 </a> 85 </span> 86 </dt> 87 </dl> 88 </dd> 89 <dt> 90 <span class="sect1"> 91 <a href="#idp39744">Terminology and WS-Notification Concept 92 </a> 93 </span> 94 </dt> 95 <dd> 96 <dl> 97 <dt> 98 <span class="sect2"> 99 <a href="#idp41920">WS-Notification Concept 100 </a> 101 </span> 102 </dt> 103 <dt> 104 <span class="sect2"> 105 <a href="#idp135872">UML-style Diagrams 106 </a> 107 </span> 108 </dt> 109 </dl> 110 </dd> 111 <dt> 112 <span class="sect1"> 113 <a href="#idp166288">User Guide for a Publisher, Subscriber and 114 NotificationConsumer 115 <span class="emphasis"> 116 <em> 117 </em> 118 </span> 119 </a> 120 </span> 121 </dt> 122 <dd> 123 <dl> 124 <dt> 125 <span class="sect2"> 126 <a href="#idp168384">Prefixes and Namespaces 127 </a> 128 </span> 129 </dt> 130 <dt> 131 <span class="sect2"> 132 <a href="#idp188144">Interaction with 133 <span class="emphasis"> 134 <em>QCG Notification 135 </em> 136 </span> 137 </a> 138 </span> 139 </dt> 140 <dt> 141 <span class="sect2"> 142 <a href="#ted">Topics, TopicExpressions and Dialects 143 </a> 144 </span> 145 </dt> 146 <dt> 147 <span class="sect2"> 148 <a href="#idp217376">Extensions 149 </a> 150 </span> 151 </dt> 152 <dt> 153 <span class="sect2"> 154 <a href="#idp237776">Methods Description 155 </a> 156 </span> 157 </dt> 158 </dl> 159 </dd> 160 <dt> 161 <span class="sect1"> 162 <a href="#idp238096">Administration Guide of 163 <span class="emphasis"> 164 <em>QCG 165 Notification 166 </em> 167 </span> 168 </a> 169 </span> 170 </dt> 171 <dd> 172 <dl> 173 <dt> 174 <span class="sect2"> 175 <a href="#idp660768">Prerequisites 176 </a> 177 </span> 178 </dt> 179 <dt> 180 <span class="sect2"> 181 <a href="#idp666256">Building 182 </a> 183 </span> 184 </dt> 185 <dt> 186 <span class="sect2"> 187 <a href="#idp681984">Creating database for 188 <span class="emphasis"> 189 <em>QCG Notification 190 </em> 191 </span> - the 192 PostgreSQL example 193 </a> 194 </span> 195 </dt> 196 </dl> 197 </dd> 198 <dt> 199 <span class="sect1"> 200 <a href="#idp703040">Configuration of 201 <span class="emphasis"> 202 <em>QCG Notification 203 </em> 204 </span> 205 </a> 206 </span> 207 </dt> 208 <dd> 209 <dl> 210 <dt> 211 <span class="sect2"> 212 <a href="#idp704272">Configuration File: 213 <code class="filename">qcg-ntfd.xml 214 </code> 215 </a> 216 </span> 217 </dt> 218 <dt> 219 <span class="sect2"> 220 <a href="#moduleoptions">Module configuration 221 </a> 222 </span> 223 </dt> 224 <dt> 225 <span class="sect2"> 226 <a href="#idp871104">WS-Topics management 227 </a> 228 </span> 229 </dt> 230 <dt> 231 <span class="sect2"> 232 <a href="#idp877072">Starting 233 <span class="emphasis"> 234 <em>QCG Notification 235 </em> 236 </span> 237 </a> 238 </span> 239 </dt> 240 <dt> 241 <span class="sect2"> 242 <a href="#idp882544">Stopping 243 <span class="emphasis"> 244 <em>QCG Notification 245 </em> 246 </span> 247 </a> 248 </span> 249 </dt> 250 </dl> 251 </dd> 252 </dl> 253 </div> 254 <div class="sect1" title="Introduction"> 255 <div class="titlepage"> 256 <div> 257 <div> 258 <h2 class="title"> 259 <a id="idp33040"/>Introduction 260 </h2> 261 </div> 262 </div> 263 </div> 264 <p> 265 <span class="bold"> 266 <strong>QCG Notification 267 </strong> 268 </span> is a reference 269 implementation of a set of industry Web Service specifications ( 270 <a class="link" href="#WS-Notification"> 271 <a class="ulink" href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsn">WS-Notification 272 OASIS standard) 273 </a> 274 </a> for message push/pull-style notification, 10 275 using a topic-based publish/subscribe pattern. It supports standard 11 276 message exchanges to be implemented by any Web Service providers … … 16 281 service providers and requesters that participate in notifications, and an 17 282 XML model that describes topics (i.e., items of interest for 18 subscriptions.).</p><div class="sect2" title="Motivations"><div class="titlepage"><div><div><h3 class="title"><a id="idp35296"/>Motivations</h3></div></div></div><p>Reliable notification and messaging services are key components in 283 subscriptions.). 284 </p> 285 <div class="sect2" title="Motivations"> 286 <div class="titlepage"> 287 <div> 288 <div> 289 <h3 class="title"> 290 <a id="idp35632"/>Motivations 291 </h3> 292 </div> 293 </div> 294 </div> 295 <p>Reliable notification and messaging services are key components in 19 296 service-oriented architectures (SOA) and distributed computing. However, 20 297 early Web Services, such as those for getting stock or whether daily … … 32 309 standardization body, either implement only partially notification 33 310 standards or do not meet high performance requirements. Therefore, our 34 main motivation was to design and implement <span class="emphasis"><em>QCG 35 Notification</em></span> to offer more advanced push/pull 311 main motivation was to design and implement 312 <span class="emphasis"> 313 <em>QCG 314 Notification 315 </em> 316 </span> to offer more advanced push/pull 36 317 (synchronous/asynchronous) standard notification routines for QCG 37 Service Bus services as well as any third party Web Services.</p></div><div class="sect2" title="Purpose of the Document"><div class="titlepage"><div><div><h3 class="title"><a id="idp8624"/>Purpose of the Document</h3></div></div></div><p>The main goal of this document is to define a set of initial use 38 cases, scenarios and specify software requirements for <span class="emphasis"><em>QCG 39 Notification</em></span>, its programming application interface, 318 Service Bus services as well as any third party Web Services. 319 </p> 320 </div> 321 <div class="sect2" title="Purpose of the Document"> 322 <div class="titlepage"> 323 <div> 324 <div> 325 <h3 class="title"> 326 <a id="idp8624"/>Purpose of the Document 327 </h3> 328 </div> 329 </div> 330 </div> 331 <p>The main goal of this document is to define a set of initial use 332 cases, scenarios and specify software requirements for 333 <span class="emphasis"> 334 <em>QCG 335 Notification 336 </em> 337 </span>, its programming application interface, 40 338 functional units and the integration with both internal and external 41 modules.</p><p>The document is aimed at software architects and programmers who 339 modules. 340 </p> 341 <p>The document is aimed at software architects and programmers who 42 342 will be developing software components based on this document. Many 43 requirements and <span class="emphasis"><em>QCG Notification </em></span>concept itself 343 requirements and 344 <span class="emphasis"> 345 <em>QCG Notification 346 </em> 347 </span>concept itself 44 348 might be interesting for developers and end users of any Web 45 Services.</p><p>This document assumes that the reader has at least a basic 46 background in Web Service and SOA technologies.</p></div><div class="sect2" title="Status"><div class="titlepage"><div><div><h3 class="title"><a id="idp38448"/>Status</h3></div></div></div><p>This document is updated periodically on no particular 47 schedule.</p></div></div><div class="sect1" title="Terminology and WS-Notification Concept"><div class="titlepage"><div><div><h2 class="title"><a id="idp39728"/>Terminology and WS-Notification Concept</h2></div></div></div><p>The aim of this section is to capture high-level functionality of 48 <span class="emphasis"><em>QCG Notification</em></span> and/or interaction without providing 49 excessive implementation or technical details of the system.</p><div class="sect2" title="WS-Notification Concept"><div class="titlepage"><div><div><h3 class="title"><a id="idp41568"/>WS-Notification Concept</h3></div></div></div><div class="sect3" title="WS-Notification Fundamentals"><div class="titlepage"><div><div><h4 class="title"><a id="idp42512"/>WS-Notification Fundamentals</h4></div></div></div><p>Notification-based pattern is commonly used for 349 Services. 350 </p> 351 <p>This document assumes that the reader has at least a basic 352 background in Web Service and SOA technologies. 353 </p> 354 </div> 355 <div class="sect2" title="Status"> 356 <div class="titlepage"> 357 <div> 358 <div> 359 <h3 class="title"> 360 <a id="idp38768"/>Status 361 </h3> 362 </div> 363 </div> 364 </div> 365 <p>This document is updated periodically on no particular 366 schedule. 367 </p> 368 </div> 369 </div> 370 <div class="sect1" title="Terminology and WS-Notification Concept"> 371 <div class="titlepage"> 372 <div> 373 <div> 374 <h2 class="title"> 375 <a id="idp39744"/>Terminology and WS-Notification Concept 376 </h2> 377 </div> 378 </div> 379 </div> 380 <p>The aim of this section is to capture high-level functionality of 381 382 <span class="emphasis"> 383 <em>QCG Notification 384 </em> 385 </span> and/or interaction without providing 386 excessive implementation or technical details of the system. 387 </p> 388 <div class="sect2" title="WS-Notification Concept"> 389 <div class="titlepage"> 390 <div> 391 <div> 392 <h3 class="title"> 393 <a id="idp41920"/>WS-Notification Concept 394 </h3> 395 </div> 396 </div> 397 </div> 398 <div class="sect3" title="WS-Notification Fundamentals"> 399 <div class="titlepage"> 400 <div> 401 <div> 402 <h4 class="title"> 403 <a id="idp42864"/>WS-Notification Fundamentals 404 </h4> 405 </div> 406 </div> 407 </div> 408 <p>Notification-based pattern is commonly used for 50 409 interaction between distributed objects. WS-Notification is a family 51 410 of related specifications that standardizes notification concept and 52 411 topic-based information distribution in SOA and Web Service based 53 412 systems. There are three normative OASIS specifications: 54 WS-BaseNotification, WS-BrokeredNotification and WS-Topics.</p><div class="variablelist"><dl><dt><span class="term">WS-BaseNotification</span></dt><dd><p>Standardizes the terminology, concepts, operations, WSDL 413 WS-BaseNotification, WS-BrokeredNotification and WS-Topics. 414 </p> 415 <div class="variablelist"> 416 <dl> 417 <dt> 418 <span class="term">WS-BaseNotification 419 </span> 420 </dt> 421 <dd> 422 <p>Standardizes the terminology, concepts, operations, WSDL 55 423 and XML needed to express the basic roles involved in Web 56 424 services publish and subscribe for notification message 57 exchange.</p><p>Specification URL:</p><p><a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-os.pdf</a></p></dd></dl></div><div class="variablelist"><dl><dt><span class="term">WS-BrokeredNotification</span></dt><dd><p>Describes specific objectives for expanded version of 425 exchange. 426 </p> 427 <p>Specification URL: 428 </p> 429 <p> 430 <a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-os.pdf 431 </a> 432 </p> 433 </dd> 434 </dl> 435 </div> 436 <div class="variablelist"> 437 <dl> 438 <dt> 439 <span class="term">WS-BrokeredNotification 440 </span> 441 </dt> 442 <dd> 443 <p>Describes specific objectives for expanded version of 58 444 notification messages exchange with indirect NotificationBroker 59 service.</p><p>Specification URL:</p><p><a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_brokered_notification-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_brokered_notification-1.3-spec-os.pdf</a></p></dd></dl></div><div class="variablelist"><dl><dt><span class="term"><a id="WS-topics"/>WS-Topics</span></dt><dd><p>Defines mechanism to organize and categorize items of 60 interest for subscriptions known as "topics".</p><p>Specification URL:</p><p><a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf</a></p></dd></dl></div><p>The next subsections will present main notification concepts 61 defined in the mentioned specifications.</p></div><div class="sect3" title="WS-BaseNotification"><div class="titlepage"><div><div><h4 class="title"><a id="idp54288"/>WS-BaseNotification</h4></div></div></div><p>The WS-BaseNotification document is a basic reference on which 445 service. 446 </p> 447 <p>Specification URL: 448 </p> 449 <p> 450 <a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_brokered_notification-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_brokered_notification-1.3-spec-os.pdf 451 </a> 452 </p> 453 </dd> 454 </dl> 455 </div> 456 <div class="variablelist"> 457 <dl> 458 <dt> 459 <span class="term"> 460 <a id="WS-topics"/>WS-Topics 461 </span> 462 </dt> 463 <dd> 464 <p>Defines mechanism to organize and categorize items of 465 interest for subscriptions known as "topics". 466 </p> 467 <p>Specification URL: 468 </p> 469 <p> 470 <a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf 471 </a> 472 </p> 473 </dd> 474 </dl> 475 </div> 476 <p>The next subsections will present main notification concepts 477 defined in the mentioned specifications. 478 </p> 479 </div> 480 <div class="sect3" title="WS-BaseNotification"> 481 <div class="titlepage"> 482 <div> 483 <div> 484 <h4 class="title"> 485 <a id="idp54640"/>WS-BaseNotification 486 </h4> 487 </div> 488 </div> 489 </div> 490 <p>The WS-BaseNotification document is a basic reference on which 62 491 all the other specifications in the standard WS-Notification family 63 492 depend. In fact, it defines precisely two important notification 64 493 roles/actors called respectively NotificationProducer and 65 494 NotificationConsumer. An example system architecture based on 66 WS-BaseNotification is presented below.</p><div class="figure"><a id="BaseEntities"/><p class="title"><strong>Figure 1. Web Services BaseNotification entities</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_baseentities.png" style="text-align: middle" width="324" alt="Web Services BaseNotification entities"/></div></div></div><p><br class="figure-break"/>The basic terminology related to the WS-BaseNotification is 67 following:</p><div class="variablelist"><dl><dt><span class="term">Situation</span></dt><dd><p>Some occurrence known by a NotificationProducer. A 68 Situation is a reason of dispatching a Notification.</p></dd><dt><span class="term">Notification</span></dt><dd><p><a id="a"/>An artifact of a Situation containing information 495 WS-BaseNotification is presented below. 496 </p> 497 <div class="figure"> 498 <a id="BaseEntities"/> 499 <p class="title"> 500 <strong>Figure 1. Web Services BaseNotification entities 501 </strong> 502 </p> 503 <div class="figure-contents"> 504 <div class="mediaobject" style="text-align: center"> 505 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_baseentities.png" style="text-align: middle" width="324" alt="Web Services BaseNotification entities"/> 506 </div> 507 </div> 508 </div> 509 <p> 510 <br class="figure-break"/>The basic terminology related to the WS-BaseNotification is 511 following: 512 </p> 513 <div class="variablelist"> 514 <dl> 515 <dt> 516 <span class="term">Situation 517 </span> 518 </dt> 519 <dd> 520 <p>Some occurrence known by a NotificationProducer. A 521 Situation is a reason of dispatching a Notification. 522 </p> 523 </dd> 524 <dt> 525 <span class="term">Notification 526 </span> 527 </dt> 528 <dd> 529 <p> 530 <a id="a"/>An artifact of a Situation containing information 69 531 about that Situation. A Notification is represented as an XML 70 element and dispatched by a NotificationProducer.</p></dd><dt><span class="term">Subscription</span></dt><dd><p>Represents relations between a NotificationProducer and 532 element and dispatched by a NotificationProducer. 533 </p> 534 </dd> 535 <dt> 536 <span class="term">Subscription 537 </span> 538 </dt> 539 <dd> 540 <p>Represents relations between a NotificationProducer and 71 541 a NotificationConsumer. A Subscription is created by a 72 542 Subscriber and is consisted with filtering parameters such as 73 a Topic, policies or context information.</p></dd><dt><span class="term">Subscriber</span></dt><dd><p>An unit that creates Subscriptions. It sends the 543 a Topic, policies or context information. 544 </p> 545 </dd> 546 <dt> 547 <span class="term">Subscriber 548 </span> 549 </dt> 550 <dd> 551 <p>An unit that creates Subscriptions. It sends the 74 552 SubscribeRequest message to a NotificationProducer 75 service.</p></dd><dt><span class="term">NotificationProducer</span></dt><dd><p>Produces Notifications. In other words 553 service. 554 </p> 555 </dd> 556 <dt> 557 <span class="term">NotificationProducer 558 </span> 559 </dt> 560 <dd> 561 <p>Produces Notifications. In other words 76 562 NotificationProducer detects Situation(s) and translates it to 77 563 Notification message(s). It is also a Web Service responsible 78 564 for creating Subscriptions by the SubscribeRequest 79 message.</p></dd><dt><span class="term">NotificationConsumer</span></dt><dd><p>An endpoint designated to receive Notifications produced 565 message. 566 </p> 567 </dd> 568 <dt> 569 <span class="term">NotificationConsumer 570 </span> 571 </dt> 572 <dd> 573 <p>An endpoint designated to receive Notifications produced 80 574 by a NotificationProducer as a result of a 81 Subscription.</p></dd><dt><span class="term">PullPoint</span></dt><dd><p>The purpose of PullPoints is enabling pull-style 575 Subscription. 576 </p> 577 </dd> 578 <dt> 579 <span class="term">PullPoint 580 </span> 581 </dt> 582 <dd> 583 <p>The purpose of PullPoints is enabling pull-style 82 584 notifications. In general, PullPoints accumulate notifications 83 585 and offer an interface for retrieving these notifications by 84 586 remote consumers. Since a PullPoint implements a 85 587 NotificationConsumer interface it can be selected in a 86 Subscription as a receiver of notifications.</p></dd><dt><span class="term">CurrentMessages</span></dt><dd><p>CurrentMessages is a buffer that keeps the latest 588 Subscription as a receiver of notifications. 589 </p> 590 </dd> 591 <dt> 592 <span class="term">CurrentMessages 593 </span> 594 </dt> 595 <dd> 596 <p>CurrentMessages is a buffer that keeps the latest 87 597 messages produced on each topic. A new notification replaces 88 598 the previous related to the same topic and currently buffered 89 in CurrentMessages.</p></dd></dl></div></div><div class="sect3" title="WS-BrokeredNotification"><div class="titlepage"><div><div><h4 class="title"><a id="idp73392"/>WS-BrokeredNotification</h4></div></div></div><p>In a nutshell, the WS-BrokeredNotification specification is an 599 in CurrentMessages. 600 </p> 601 </dd> 602 </dl> 603 </div> 604 </div> 605 <div class="sect3" title="WS-BrokeredNotification"> 606 <div class="titlepage"> 607 <div> 608 <div> 609 <h4 class="title"> 610 <a id="idp73520"/>WS-BrokeredNotification 611 </h4> 612 </div> 613 </div> 614 </div> 615 <p>In a nutshell, the WS-BrokeredNotification specification is an 90 616 extension of described above the WS-BaseNotification concept. However, 91 617 it introduces a new important notification role called 92 618 NotificationBroker and defines more advanced notification scenarios. 93 619 The figure below shows an example scenario and notification message 94 flow where NotificationBroker is present.</p><div class="figure"><a id="idp75376"/><p class="title"><strong>Figure 2. Web Services BrokeredNotification entities - QCG 95 Notification entities</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_brokeredentities.png" style="text-align: middle" width="324" alt="Web Services BrokeredNotification entities - QCG Notification entities"/></div></div></div><p><br class="figure-break"/>Note, that there are some important enlargements and 620 flow where NotificationBroker is present. 621 </p> 622 <div class="figure"> 623 <a id="idp75392"/> 624 <p class="title"> 625 <strong>Figure 2. Web Services BrokeredNotification entities - QCG 626 Notification entities 627 </strong> 628 </p> 629 <div class="figure-contents"> 630 <div class="mediaobject" style="text-align: center"> 631 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_brokeredentities.png" style="text-align: middle" width="324" alt="Web Services BrokeredNotification entities - QCG Notification entities"/> 632 </div> 633 </div> 634 </div> 635 <p> 636 <br class="figure-break"/>Note, that there are some important enlargements and 96 637 modifications in the WS-BrokeredNotificatison terminology. Below the 97 most relevant definitions are presented.</p><div class="variablelist"><dl><dt><span class="term">Situation</span></dt><dd><p>Some occurrence, known by a Publisher. A Situation is a 98 reason of dispatching a Notification.</p></dd><dt><span class="term">Notification</span></dt><dd><p>An artifact of a Situation containing information about 638 most relevant definitions are presented. 639 </p> 640 <div class="variablelist"> 641 <dl> 642 <dt> 643 <span class="term">Situation 644 </span> 645 </dt> 646 <dd> 647 <p>Some occurrence, known by a Publisher. A Situation is a 648 reason of dispatching a Notification. 649 </p> 650 </dd> 651 <dt> 652 <span class="term">Notification 653 </span> 654 </dt> 655 <dd> 656 <p>An artifact of a Situation containing information about 99 657 that Situation. A Notification is represented as an XML element, 100 658 dispatched by a Publisher and redistributed by a 101 NotificationBroker.</p></dd><dt><span class="term">Publisher</span></dt><dd><p>An unit that creates Notification(s) - detects 659 NotificationBroker. 660 </p> 661 </dd> 662 <dt> 663 <span class="term">Publisher 664 </span> 665 </dt> 666 <dd> 667 <p>An unit that creates Notification(s) - detects 102 668 Situation(s) and translates it to Notification message(s). It 103 doesn't have to be a Web Service.</p></dd><dt><span class="term">Subscription</span></dt><dd><p>Represents relations between a Publisher and a 669 doesn't have to be a Web Service. 670 </p> 671 </dd> 672 <dt> 673 <span class="term">Subscription 674 </span> 675 </dt> 676 <dd> 677 <p>Represents relations between a Publisher and a 104 678 NotificationConsumer. A Subscription is created by a Subscriber 105 679 and is consisted with filtering parameters such as a Topic, 106 policies or a context information.</p></dd><dt><span class="term">Subscriber</span></dt><dd><p>An unit that creates Subscriptions. It sends the 680 policies or a context information. 681 </p> 682 </dd> 683 <dt> 684 <span class="term">Subscriber 685 </span> 686 </dt> 687 <dd> 688 <p>An unit that creates Subscriptions. It sends the 107 689 SubscribeRequest message to a SubscriptionManager 108 interface.</p></dd><dt><span class="term">NotificationBroker</span></dt><dd><p>An intermediary Web service that decouples Publishers and 690 interface. 691 </p> 692 </dd> 693 <dt> 694 <span class="term">NotificationBroker 695 </span> 696 </dt> 697 <dd> 698 <p>An intermediary Web service that decouples Publishers and 109 699 NotificationConsumers. It redistributes Notifications received 110 700 from Publishers to NotificationConsumers on the basis of 111 Subscriptions' parameters.</p></dd><dt><span class="term">NotificationConsumer</span></dt><dd><p>An endpoint designated to receive Notifications produced 701 Subscriptions' parameters. 702 </p> 703 </dd> 704 <dt> 705 <span class="term">NotificationConsumer 706 </span> 707 </dt> 708 <dd> 709 <p>An endpoint designated to receive Notifications produced 112 710 by a Publisher and later redistributed by a NotificationBroker 113 as a result of a Subscription.</p></dd><dt><span class="term">PullPoint</span></dt><dd><p>The purpose of PullPoints is enabling pull-style 711 as a result of a Subscription. 712 </p> 713 </dd> 714 <dt> 715 <span class="term">PullPoint 716 </span> 717 </dt> 718 <dd> 719 <p>The purpose of PullPoints is enabling pull-style 114 720 notifications. In general, PullPoints accumulate notifications 115 721 and offer an interface for retrieving these notifications by 116 722 remote consumers. Since a PullPoint implements a 117 723 NotificationConsumer interface it can be selected in a 118 Subscription as a receiver of notifications.</p></dd><dt><span class="term">CurrentMessages</span></dt><dd><p>CurrentMessages is a buffer that keeps the latest messages 724 Subscription as a receiver of notifications. 725 </p> 726 </dd> 727 <dt> 728 <span class="term">CurrentMessages 729 </span> 730 </dt> 731 <dd> 732 <p>CurrentMessages is a buffer that keeps the latest messages 119 733 published on each topic. A new notification replaces the 120 734 previous related to the same topic and currently buffered in 121 CurrentMessages.</p></dd></dl></div><p>The main difference between WS-Base and WS-Brokered Notification 735 CurrentMessages. 736 </p> 737 </dd> 738 </dl> 739 </div> 740 <p>The main difference between WS-Base and WS-Brokered Notification 122 741 specifications is that in the second case NotificationProducers do not 123 742 have to be implemented as a Web Services. Publishers do not have to … … 126 745 different actors in a notification flow, NotificationConsumers are 127 746 fully separated and do not have to know details about 128 NotificationProducers.</p><p>Depending on distributed system requirements and use cases 747 NotificationProducers. 748 </p> 749 <p>Depending on distributed system requirements and use cases 129 750 various notification routines, objects, and roles are usually 130 751 involved. For instance, in the simplest case where an asynchronous … … 132 753 mechanisms defined by WS-BrokeredNotification and basic notification 133 754 routines defined by WS-BaseNotification are good enough to satisfy 134 distributed system needs. The example scenario is presented on <a class="link" href="#BaseEntities" title="Figure 1. Web Services BaseNotification entities">Figure 1</a>. For more advanced notification 755 distributed system needs. The example scenario is presented on 756 <a class="link" href="#BaseEntities" title="Figure 1. Web Services BaseNotification entities">Figure 1 757 </a>. For more advanced notification 135 758 scenarios in service oriented systems we recommend to use notification 136 759 capabilities defined in WS-BrokeredNotification. One of the main 137 scenario defined by WS-BrokeredNotification is presented on <a class="link" href="#BrokeredEntities">Figure 2</a> .</p></div><div class="sect3" title="WS-Topics"><div class="titlepage"><div><div><h4 class="title"><a id="idp98368"/>WS-Topics</h4></div></div></div><p>The third important notification specification document called 760 scenario defined by WS-BrokeredNotification is presented on 761 <a class="link" href="#BrokeredEntities">Figure 2 762 </a> . 763 </p> 764 </div> 765 <div class="sect3" title="WS-Topics"> 766 <div class="titlepage"> 767 <div> 768 <div> 769 <h4 class="title"> 770 <a id="idp98384"/>WS-Topics 771 </h4> 772 </div> 773 </div> 774 </div> 775 <p>The third important notification specification document called 138 776 WS-Topics is strictly associated with WS-BaseNotification and 139 777 precisely defines a "topics" mechanism. Important definitions used in 140 the WS-Topics specification are presented below:</p><div class="variablelist"><dl><dt><span class="term">Topic</span></dt><dd><p>A concept used to categorize Notifications and their 778 the WS-Topics specification are presented below: 779 </p> 780 <div class="variablelist"> 781 <dl> 782 <dt> 783 <span class="term">Topic 784 </span> 785 </dt> 786 <dd> 787 <p>A concept used to categorize Notifications and their 141 788 related Notification schemes. Topics are used to determine which 142 789 subscribing NotificationConsumers should receive a specific 143 Notification.</p></dd><dt><span class="term">Topic Tree</span></dt><dd><p>A hierarchical group of Topics.</p></dd><dt><span class="term">Topic Namespace</span></dt><dd><p>A forest of Topic Trees grouped into one namespace</p></dd><dt><span class="term">TopicExpression</span></dt><dd><p>An expression that identifies Topics from a Topic 144 Namespace</p></dd><dt><span class="term">Dialect</span></dt><dd><p>Identifies the type of a grammar used in a 790 Notification. 791 </p> 792 </dd> 793 <dt> 794 <span class="term">Topic Tree 795 </span> 796 </dt> 797 <dd> 798 <p>A hierarchical group of Topics. 799 </p> 800 </dd> 801 <dt> 802 <span class="term">Topic Namespace 803 </span> 804 </dt> 805 <dd> 806 <p>A forest of Topic Trees grouped into one namespace 807 </p> 808 </dd> 809 <dt> 810 <span class="term">TopicExpression 811 </span> 812 </dt> 813 <dd> 814 <p>An expression that identifies Topics from a Topic 815 Namespace 816 </p> 817 </dd> 818 <dt> 819 <span class="term">Dialect 820 </span> 821 </dt> 822 <dd> 823 <p>Identifies the type of a grammar used in a 145 824 TopicExpression. The specification defines four Dialects: 146 <span class="emphasis"><em>Simple</em></span>, <span class="emphasis"><em>Concrete</em></span>, 147 <span class="emphasis"><em>Full</em></span> and <span class="emphasis"><em>XPath</em></span>.</p></dd></dl></div><div class="figure"><a id="idp109728"/><p class="title"><strong>Figure 3. Example Topic Namespace</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_topicnamespace.png" style="text-align: middle" width="324" alt="Example Topic Namespace"/></div></div></div><br class="figure-break"/></div><div class="sect3" title="Base of QCG Notification"><div class="titlepage"><div><div><h4 class="title"><a id="idp112608"/>Base of <span class="emphasis"><em>QCG Notification</em></span></h4></div></div></div><p><span class="emphasis"><em>QCG Notification</em></span> is a reference 825 826 <span class="emphasis"> 827 <em>Simple 828 </em> 829 </span>, 830 <span class="emphasis"> 831 <em>Concrete 832 </em> 833 </span>, 834 835 <span class="emphasis"> 836 <em>Full 837 </em> 838 </span> and 839 <span class="emphasis"> 840 <em>XPath 841 </em> 842 </span>. 843 </p> 844 </dd> 845 </dl> 846 </div> 847 <div class="figure"> 848 <a id="idp109744"/> 849 <p class="title"> 850 <strong>Figure 3. Example Topic Namespace 851 </strong> 852 </p> 853 <div class="figure-contents"> 854 <div class="mediaobject" style="text-align: center"> 855 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_topicnamespace.png" style="text-align: middle" width="324" alt="Example Topic Namespace"/> 856 </div> 857 </div> 858 </div> 859 <br class="figure-break"/> 860 </div> 861 <div class="sect3" title="Base of QCG Notification"> 862 <div class="titlepage"> 863 <div> 864 <div> 865 <h4 class="title"> 866 <a id="idp112624"/>Base of 867 <span class="emphasis"> 868 <em>QCG Notification 869 </em> 870 </span> 871 </h4> 872 </div> 873 </div> 874 </div> 875 <p> 876 <span class="emphasis"> 877 <em>QCG Notification 878 </em> 879 </span> is a reference 148 880 implementation of WS-BaseNotification, WS-BrokeredNotification and 149 881 WS-Topics OASIS industry standards. As a consistent and highly 150 882 efficient notification system it supports advanced brokered Web 151 Service notification push/pull scenarios described in the <a class="link" href="#brokerednotifications">Section 2.1.3</a>. It has been 883 Service notification push/pull scenarios described in the 884 <a class="link" href="#brokerednotifications">Section 2.1.3 885 </a>. It has been 152 886 designed to satisfy notification requirements and demands of large 153 887 scale Web Service based systems, SOA environments and it acts as a 154 888 core component in QCG Service Bus. To meet security requirements, 155 <span class="emphasis"><em>QCG Notification</em></span> (or <span class="emphasis"><em>QCG Notification 156 Provider</em></span>) exposes well defined Web Service and programming 889 890 <span class="emphasis"> 891 <em>QCG Notification 892 </em> 893 </span> (or 894 <span class="emphasis"> 895 <em>QCG Notification 896 Provider 897 </em> 898 </span>) exposes well defined Web Service and programming 157 899 interfaces over QCG security mechanisms for dynamic notification, 158 900 subscription, registration, forwarding, etc. As it was explained in 159 901 the previous sections it can be used and integrated with various 160 902 external third party Web Services playing roles of a notification 161 Publisher, Subscriber or Consumer.</p><p>A flexible plug-in architecture of <span class="emphasis"><em>QCG Notification 162 </em></span>enables using different communication protocols for 903 Publisher, Subscriber or Consumer. 904 </p> 905 <p>A flexible plug-in architecture of 906 <span class="emphasis"> 907 <em>QCG Notification 908 909 </em> 910 </span>enables using different communication protocols for 163 911 messages transmission. Currently messages can be transported between 164 <span class="emphasis"><em>QCG Notification</em></span> and third party entities not 912 913 <span class="emphasis"> 914 <em>QCG Notification 915 </em> 916 </span> and third party entities not 165 917 only through HTTP protocol, but also through XMPP (jabber) as well as 166 918 SMTP (e-mail) protocols. It is possible to variously mix channels of 167 919 communication, for example a notification sent by a Publisher being 168 920 WS-Client as a HTTP message can be distributed over XMPP to jabber 169 consumers.</p><p>Below we present a set of Web Service notification use cases 170 demonstrating capabilities offered by <span class="emphasis"><em>QCG 171 Notification</em></span>.</p><div class="figure"><a id="notificationConsumers"/><p class="title"><strong>Figure 4. Notification with multiple Publishers and multiple 172 NotificationConsumers</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_example1.png" style="text-align: middle" width="324" alt="Notification with multiple Publishers and multiple NotificationConsumers"/></div></div></div><br class="figure-break"/><p>The <a class="link" href="#notificationConsumers" title="Figure 4. Notification with multiple Publishers and multiple NotificationConsumers">diagram 4</a> shows 173 one of the basic notification flows supported by <span class="emphasis"><em>QCG 174 Notification</em></span>. Depending on records, Notifications produced 175 by a Publisher and received by the <span class="emphasis"><em>QCG 176 Notification</em></span> may or may not be dispatched to concrete 921 consumers. 922 </p> 923 <p>Below we present a set of Web Service notification use cases 924 demonstrating capabilities offered by 925 <span class="emphasis"> 926 <em>QCG 927 Notification 928 </em> 929 </span>. 930 </p> 931 <div class="figure"> 932 <a id="notificationConsumers"/> 933 <p class="title"> 934 <strong>Figure 4. Notification with multiple Publishers and multiple 935 NotificationConsumers 936 </strong> 937 </p> 938 <div class="figure-contents"> 939 <div class="mediaobject" style="text-align: center"> 940 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_example1.png" style="text-align: middle" width="324" alt="Notification with multiple Publishers and multiple NotificationConsumers"/> 941 </div> 942 </div> 943 </div> 944 <br class="figure-break"/> 945 <p>The 946 <a class="link" href="#notificationConsumers" title="Figure 4. Notification with multiple Publishers and multiple NotificationConsumers">diagram 4 947 </a> shows 948 one of the basic notification flows supported by 949 <span class="emphasis"> 950 <em>QCG 951 Notification 952 </em> 953 </span>. Depending on records, Notifications produced 954 by a Publisher and received by the 955 <span class="emphasis"> 956 <em>QCG 957 Notification 958 </em> 959 </span> may or may not be dispatched to concrete 177 960 NotificationConsumer. Note, that Subscriptions represent relationships 178 961 between Topics and NotificationConsumers in this scenario. Before any 179 962 Notification is delivered to a NotificationConsumer, a Subscriber has 180 to send first a SubscribeRequest message to <span class="emphasis"><em>QCG 181 Notification</em></span> in which all parameters of a Subscription are 963 to send first a SubscribeRequest message to 964 <span class="emphasis"> 965 <em>QCG 966 Notification 967 </em> 968 </span> in which all parameters of a Subscription are 182 969 specified. Main parameters of a SubscribeRequest message are 183 970 ConsumerReference and TopicExpression defined according to the 184 971 specific Dialect type. On the other hand, before a Publisher starts 185 972 sending Notifications it may be obligated to register himself in 186 <span class="emphasis"><em>QCG Notification</em></span>. The diagram below shows a 973 974 <span class="emphasis"> 975 <em>QCG Notification 976 </em> 977 </span>. The diagram below shows a 187 978 sequence of events in order to initialize an asynchronous process of 188 notifications between a Publisher and a NotificationConsumer.</p><div class="figure"><a id="idp125872"/><p class="title"><strong>Figure 5. Message flows: creating a Subscription, notifying 189 NotificationConsumers</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_example2.png" style="text-align: middle" width="324" alt="Message flows: creating a Subscription, notifying NotificationConsumers"/></div></div></div><br class="figure-break"/><div class="orderedlist"><ol class="orderedlist"><li class="listitem"><p>A Subscriber sends the SubscribeRequest message with a 979 notifications between a Publisher and a NotificationConsumer. 980 </p> 981 <div class="figure"> 982 <a id="idp125888"/> 983 <p class="title"> 984 <strong>Figure 5. Message flows: creating a Subscription, notifying 985 NotificationConsumers 986 </strong> 987 </p> 988 <div class="figure-contents"> 989 <div class="mediaobject" style="text-align: center"> 990 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/smn_example2.png" style="text-align: middle" width="324" alt="Message flows: creating a Subscription, notifying NotificationConsumers"/> 991 </div> 992 </div> 993 </div> 994 <br class="figure-break"/> 995 <div class="orderedlist"> 996 <ol class="orderedlist"> 997 <li class="listitem"> 998 <p>A Subscriber sends the SubscribeRequest message with a 190 999 NotificationConsumer location and TopicExpression parameters to 191 <span class="emphasis"><em>QCG Notification</em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>QCG Notification</em></span> prepares appropriate 192 records for a Subscription.</p></li><li class="listitem"><p>A Publisher register himself in <span class="emphasis"><em>QCG 193 Notification</em></span> by sending the RegisterPublisher 194 message.</p></li><li class="listitem"><p>A registered Publisher sends the Notify message on a 195 specified Topic to a <span class="emphasis"><em>QCG Notification 196 </em></span>service.</p></li><li class="listitem"><p><span class="emphasis"><em>QCG Notification</em></span> checks if there are 1000 1001 <span class="emphasis"> 1002 <em>QCG Notification 1003 </em> 1004 </span>. 1005 </p> 1006 </li> 1007 <li class="listitem"> 1008 <p> 1009 <span class="emphasis"> 1010 <em>QCG Notification 1011 </em> 1012 </span> prepares appropriate 1013 records for a Subscription. 1014 </p> 1015 </li> 1016 <li class="listitem"> 1017 <p>A Publisher register himself in 1018 <span class="emphasis"> 1019 <em>QCG 1020 Notification 1021 </em> 1022 </span> by sending the RegisterPublisher 1023 message. 1024 </p> 1025 </li> 1026 <li class="listitem"> 1027 <p>A registered Publisher sends the Notify message on a 1028 specified Topic to a 1029 <span class="emphasis"> 1030 <em>QCG Notification 1031 1032 </em> 1033 </span>service. 1034 </p> 1035 </li> 1036 <li class="listitem"> 1037 <p> 1038 <span class="emphasis"> 1039 <em>QCG Notification 1040 </em> 1041 </span> checks if there are 197 1042 NotificationConsumers subscribed on a specified Topic. If so, 198 <span class="emphasis"><em>QCG Notification</em></span> sends asynchronous 199 Notifications to these NotifcationConsumers.</p></li></ol></div></div></div><div class="sect2" title="UML-style Diagrams"><div class="titlepage"><div><div><h3 class="title"><a id="idp135856"/>UML-style Diagrams</h3></div></div></div><p>The document uses UML-style use-case diagrams to illustrate 1043 1044 <span class="emphasis"> 1045 <em>QCG Notification 1046 </em> 1047 </span> sends asynchronous 1048 Notifications to these NotifcationConsumers. 1049 </p> 1050 </li> 1051 </ol> 1052 </div> 1053 </div> 1054 </div> 1055 <div class="sect2" title="UML-style Diagrams"> 1056 <div class="titlepage"> 1057 <div> 1058 <div> 1059 <h3 class="title"> 1060 <a id="idp135872"/>UML-style Diagrams 1061 </h3> 1062 </div> 1063 </div> 1064 </div> 1065 <p>The document uses UML-style use-case diagrams to illustrate 200 1066 high-level use cases. The following list is probably sufficient for this 201 version of the document:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>Stick figures represents actors or roles in a scenario. These 202 can be human beings or software systems.</p></li><li class="listitem"><p>Ellipses represent use cases, i.e. actions or units of 203 functionality in a system.</p></li><li class="listitem"><p>Lines between actors and use cases indicate a participation of 1067 version of the document: 1068 </p> 1069 <div class="itemizedlist"> 1070 <ul class="itemizedlist"> 1071 <li class="listitem"> 1072 <p>Stick figures represents actors or roles in a scenario. These 1073 can be human beings or software systems. 1074 </p> 1075 </li> 1076 <li class="listitem"> 1077 <p>Ellipses represent use cases, i.e. actions or units of 1078 functionality in a system. 1079 </p> 1080 </li> 1081 <li class="listitem"> 1082 <p>Lines between actors and use cases indicate a participation of 204 1083 the actor in the use case. At this level, no direction or payload of 205 1084 data flow is expressed by the lines between actors and use 206 cases.</p></li></ul></div><p>The document uses UML-style sequence diagrams to illustrate 1085 cases. 1086 </p> 1087 </li> 1088 </ul> 1089 </div> 1090 <p>The document uses UML-style sequence diagrams to illustrate 207 1091 detailed use case scenarios and later in the next sections. Meanings of 208 graphics in these diagrams are as follows:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>Boxes at the top of the diagram represent an actor in the 209 scenario.</p></li><li class="listitem"><p>Arrows with a solid head represent a message sent from one 210 actor to another. The arrow points from sender to receiver.</p></li><li class="listitem"><p>Arrows with a line head represent the return value of a 1092 graphics in these diagrams are as follows: 1093 </p> 1094 <div class="itemizedlist"> 1095 <ul class="itemizedlist"> 1096 <li class="listitem"> 1097 <p>Boxes at the top of the diagram represent an actor in the 1098 scenario. 1099 </p> 1100 </li> 1101 <li class="listitem"> 1102 <p>Arrows with a solid head represent a message sent from one 1103 actor to another. The arrow points from sender to receiver. 1104 </p> 1105 </li> 1106 <li class="listitem"> 1107 <p>Arrows with a line head represent the return value of a 211 1108 message. The arrow points from the receiver of the earlier message 212 to the sender.</p></li><li class="listitem"><p>A dotted line running down the diagram from a box indicates 1109 to the sender. 1110 </p> 1111 </li> 1112 <li class="listitem"> 1113 <p>A dotted line running down the diagram from a box indicates 213 1114 that arrows whose endpoints (tail or head) is on the line apply to 214 that actor.</p></li><li class="listitem"><p>Intersections between arrows and dotted lines are 215 meaningless.</p></li><li class="listitem"><p>Vertical layout represents time. Messages (arrows) farther 216 down on the page happen after messages higher on the page.</p></li><li class="listitem"><p>Horizontal layout has no formal meaning. Since right-pointing 1115 that actor. 1116 </p> 1117 </li> 1118 <li class="listitem"> 1119 <p>Intersections between arrows and dotted lines are 1120 meaningless. 1121 </p> 1122 </li> 1123 <li class="listitem"> 1124 <p>Vertical layout represents time. Messages (arrows) farther 1125 down on the page happen after messages higher on the page. 1126 </p> 1127 </li> 1128 <li class="listitem"> 1129 <p>Horizontal layout has no formal meaning. Since right-pointing 217 1130 arrows look better, actors that initiate a scenario tend to appear 218 leftward of actors they send messages to.</p></li></ul></div><p>Sequence diagrams are used in this document for more concrete 1131 leftward of actors they send messages to. 1132 </p> 1133 </li> 1134 </ul> 1135 </div> 1136 <p>Sequence diagrams are used in this document for more concrete 219 1137 design, and that actors and messages are often objects and object 220 1138 methods. They provide value for this document in that they give a 221 1139 clearly ordered message layout and connections among functional units. 222 1140 The actors and messages in the sequence diagrams are more properly roles 223 in a scenario and actions associated with that scenario.</p><div class="sect3" title="`Main Use Cases"><div class="titlepage"><div><div><h4 class="title"><a id="idp148672"/>`Main Use Cases</h4></div></div></div><div class="figure"><a id="idp149488"/><p class="title"><strong>Figure 6. Use case diagram for a Publisher</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_publisher.png" style="text-align: middle" width="432" alt="Use case diagram for a Publisher"/></div></div></div><br class="figure-break"/><div class="figure"><a id="idp151328"/><p class="title"><strong>Figure 7. Use case diagram for a Subscriber</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_subscriber.png" style="text-align: middle" width="432" alt="Use case diagram for a Subscriber"/></div></div></div><br class="figure-break"/><div class="figure"><a id="idp155376"/><p class="title"><strong>Figure 8. Use case diagram for a NotificationConsumer</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_consumer.png" style="text-align: middle" width="432" alt="Use case diagram for a NotificationConsumer"/></div></div></div><br class="figure-break"/><div class="figure"><a id="idp158128"/><p class="title"><strong>Figure 9. Use case diagram for QCG Notification</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_qcgnotification.png" style="text-align: middle" width="432" alt="Use case diagram for QCG Notification"/></div></div></div><br class="figure-break"/><div class="figure"><a id="idp160880"/><p class="title"><strong>Figure 10. Use case diagram for a QCG Notification Administrator</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_administrator.png" style="text-align: middle" width="432" alt="Use case diagram for a QCG Notification Administrator"/></div></div></div><br class="figure-break"/></div><div class="sect3" title="Main Sequence Diagrams"><div class="titlepage"><div><div><h4 class="title"><a id="idp163632"/>Main Sequence Diagrams</h4></div></div></div><div class="figure"><a id="idp164272"/><p class="title"><strong>Figure 11. General sequence diagram</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_all.png" style="text-align: middle" width="327" alt="General sequence diagram"/></div></div></div><br class="figure-break"/></div></div></div><div class="sect1" title="User Guide for a Publisher, Subscriber and NotificationConsumer"><div class="titlepage"><div><div><h2 class="title"><a id="idp167424"/>User Guide for a Publisher, Subscriber and 224 NotificationConsumer<span class="emphasis"><em> </em></span></h2></div></div></div><div class="sect2" title="Prefixes and Namespaces"><div class="titlepage"><div><div><h3 class="title"><a id="idp168496"/>Prefixes and Namespaces</h3></div></div></div><p>The following table presents namespaces tied with prefixes. The 1141 in a scenario and actions associated with that scenario. 1142 </p> 1143 <div class="sect3" title="`Main Use Cases"> 1144 <div class="titlepage"> 1145 <div> 1146 <div> 1147 <h4 class="title"> 1148 <a id="idp148688"/>`Main Use Cases 1149 </h4> 1150 </div> 1151 </div> 1152 </div> 1153 <div class="figure"> 1154 <a id="idp149504"/> 1155 <p class="title"> 1156 <strong>Figure 6. Use case diagram for a Publisher 1157 </strong> 1158 </p> 1159 <div class="figure-contents"> 1160 <div class="mediaobject" style="text-align: center"> 1161 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_publisher.png" style="text-align: middle" width="432" alt="Use case diagram for a Publisher"/> 1162 </div> 1163 </div> 1164 </div> 1165 <br class="figure-break"/> 1166 <div class="figure"> 1167 <a id="idp151344"/> 1168 <p class="title"> 1169 <strong>Figure 7. Use case diagram for a Subscriber 1170 </strong> 1171 </p> 1172 <div class="figure-contents"> 1173 <div class="mediaobject" style="text-align: center"> 1174 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_subscriber.png" style="text-align: middle" width="432" alt="Use case diagram for a Subscriber"/> 1175 </div> 1176 </div> 1177 </div> 1178 <br class="figure-break"/> 1179 <div class="figure"> 1180 <a id="idp155392"/> 1181 <p class="title"> 1182 <strong>Figure 8. Use case diagram for a NotificationConsumer 1183 </strong> 1184 </p> 1185 <div class="figure-contents"> 1186 <div class="mediaobject" style="text-align: center"> 1187 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_consumer.png" style="text-align: middle" width="432" alt="Use case diagram for a NotificationConsumer"/> 1188 </div> 1189 </div> 1190 </div> 1191 <br class="figure-break"/> 1192 <div class="figure"> 1193 <a id="idp158144"/> 1194 <p class="title"> 1195 <strong>Figure 9. Use case diagram for QCG Notification 1196 </strong> 1197 </p> 1198 <div class="figure-contents"> 1199 <div class="mediaobject" style="text-align: center"> 1200 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_qcgnotification.png" style="text-align: middle" width="432" alt="Use case diagram for QCG Notification"/> 1201 </div> 1202 </div> 1203 </div> 1204 <br class="figure-break"/> 1205 <div class="figure"> 1206 <a id="idp160896"/> 1207 <p class="title"> 1208 <strong>Figure 10. Use case diagram for a QCG Notification Administrator 1209 </strong> 1210 </p> 1211 <div class="figure-contents"> 1212 <div class="mediaobject" style="text-align: center"> 1213 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/use_administrator.png" style="text-align: middle" width="432" alt="Use case diagram for a QCG Notification Administrator"/> 1214 </div> 1215 </div> 1216 </div> 1217 <br class="figure-break"/> 1218 </div> 1219 <div class="sect3" title="Main Sequence Diagrams"> 1220 <div class="titlepage"> 1221 <div> 1222 <div> 1223 <h4 class="title"> 1224 <a id="idp163648"/>Main Sequence Diagrams 1225 </h4> 1226 </div> 1227 </div> 1228 </div> 1229 <div class="figure"> 1230 <a id="idp164288"/> 1231 <p class="title"> 1232 <strong>Figure 11. General sequence diagram 1233 </strong> 1234 </p> 1235 <div class="figure-contents"> 1236 <div class="mediaobject" style="text-align: center"> 1237 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_all.png" style="text-align: middle" width="327" alt="General sequence diagram"/> 1238 </div> 1239 </div> 1240 </div> 1241 <br class="figure-break"/> 1242 </div> 1243 </div> 1244 </div> 1245 <div class="sect1" title="User Guide for a Publisher, Subscriber and NotificationConsumer"> 1246 <div class="titlepage"> 1247 <div> 1248 <div> 1249 <h2 class="title"> 1250 <a id="idp166288"/>User Guide for a Publisher, Subscriber and 1251 NotificationConsumer 1252 <span class="emphasis"> 1253 <em> 1254 </em> 1255 </span> 1256 </h2> 1257 </div> 1258 </div> 1259 </div> 1260 <div class="sect2" title="Prefixes and Namespaces"> 1261 <div class="titlepage"> 1262 <div> 1263 <div> 1264 <h3 class="title"> 1265 <a id="idp168384"/>Prefixes and Namespaces 1266 </h3> 1267 </div> 1268 </div> 1269 </div> 1270 <p>The following table presents namespaces tied with prefixes. The 225 1271 prefixes are used in example SOAP messages presented in the further 226 sections.</p><div class="table"><a id="idp169696"/><p class="title"><strong>Table 1. Prefixes and Namespaces</strong></p><div class="table-contents"><table summary="Prefixes and Namespaces" border="1"><colgroup><col width="70" style="text-align: left"/><col/></colgroup><tbody><tr><td style="text-align: left"><span class="bold"><strong>Prefix</strong></span></td><td><span class="bold"><strong>Namespace</strong></span></td></tr><tr><td style="text-align: left">SOAP-ENV</td><td>http://schemas.xmlsoap.org/soap/envelope/</td></tr><tr><td style="text-align: left">SOAP-ENC</td><td>http://schemas.xmlsoap.org/soap/encoding/</td></tr><tr><td style="text-align: left">xsi</td><td>http://www.w3.org/2001/XMLSchema-instance</td></tr><tr><td style="text-align: left">xsd</td><td>http://www.w3.org/2001/XMLSchema</td></tr><tr><td style="text-align: left">wsa</td><td>http://www.w3.org/2005/08/addressing</td></tr><tr><td style="text-align: left">wsbf</td><td>http://docs.oasis-open.org/wsrf/bf-2</td></tr><tr><td style="text-align: left">wstop</td><td>http://docs.oasis-open.org/wsn/t-1</td></tr><tr><td style="text-align: left">wsr</td><td>http://docs.oasis-open.org/wsrf/r-2</td></tr><tr><td style="text-align: left">wsnt</td><td>http://docs.oasis-open.org/wsn/b-2</td></tr><tr><td style="text-align: left">wsntw</td><td>http://docs.oasis-open.org/wsn/bw-2</td></tr><tr><td style="text-align: left">wsnbr</td><td>http://docs.oasis-open.org/wsn/br-2</td></tr><tr><td style="text-align: left">smn-ext</td><td>http://schemas.qoscosgrid.org/ntf/2011/04/extensions</td></tr></tbody></table></div></div><br class="table-break"/></div><div class="sect2" title="Interaction with QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp188128"/>Interaction with <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div><p>In the next subsections an issue of cooperation with <span class="emphasis"><em>QCG 227 Notification</em></span> is presented independently for a Publisher, 1272 sections. 1273 </p> 1274 <div class="table"> 1275 <a id="idp169584"/> 1276 <p class="title"> 1277 <strong>Table 1. Prefixes and Namespaces 1278 </strong> 1279 </p> 1280 <div class="table-contents"> 1281 <table summary="Prefixes and Namespaces" border="1"> 1282 <colgroup> 1283 <col width="70" style="text-align: left"/> 1284 <col/> 1285 </colgroup> 1286 <tbody> 1287 <tr> 1288 <td style="text-align: left"> 1289 <span class="bold"> 1290 <strong>Prefix 1291 </strong> 1292 </span> 1293 </td> 1294 <td> 1295 <span class="bold"> 1296 <strong>Namespace 1297 </strong> 1298 </span> 1299 </td> 1300 </tr> 1301 <tr> 1302 <td style="text-align: left">SOAP-ENV 1303 </td> 1304 <td>http://schemas.xmlsoap.org/soap/envelope/ 1305 </td> 1306 </tr> 1307 <tr> 1308 <td style="text-align: left">SOAP-ENC 1309 </td> 1310 <td>http://schemas.xmlsoap.org/soap/encoding/ 1311 </td> 1312 </tr> 1313 <tr> 1314 <td style="text-align: left">xsi 1315 </td> 1316 <td>http://www.w3.org/2001/XMLSchema-instance 1317 </td> 1318 </tr> 1319 <tr> 1320 <td style="text-align: left">xsd 1321 </td> 1322 <td>http://www.w3.org/2001/XMLSchema 1323 </td> 1324 </tr> 1325 <tr> 1326 <td style="text-align: left">wsa 1327 </td> 1328 <td>http://www.w3.org/2005/08/addressing 1329 </td> 1330 </tr> 1331 <tr> 1332 <td style="text-align: left">wsbf 1333 </td> 1334 <td>http://docs.oasis-open.org/wsrf/bf-2 1335 </td> 1336 </tr> 1337 <tr> 1338 <td style="text-align: left">wstop 1339 </td> 1340 <td>http://docs.oasis-open.org/wsn/t-1 1341 </td> 1342 </tr> 1343 <tr> 1344 <td style="text-align: left">wsr 1345 </td> 1346 <td>http://docs.oasis-open.org/wsrf/r-2 1347 </td> 1348 </tr> 1349 <tr> 1350 <td style="text-align: left">wsnt 1351 </td> 1352 <td>http://docs.oasis-open.org/wsn/b-2 1353 </td> 1354 </tr> 1355 <tr> 1356 <td style="text-align: left">wsntw 1357 </td> 1358 <td>http://docs.oasis-open.org/wsn/bw-2 1359 </td> 1360 </tr> 1361 <tr> 1362 <td style="text-align: left">wsnbr 1363 </td> 1364 <td>http://docs.oasis-open.org/wsn/br-2 1365 </td> 1366 </tr> 1367 <tr> 1368 <td style="text-align: left">smn-ext 1369 </td> 1370 <td>http://schemas.qoscosgrid.org/ntf/2011/04/extensions 1371 </td> 1372 </tr> 1373 </tbody> 1374 </table> 1375 </div> 1376 </div> 1377 <br class="table-break"/> 1378 </div> 1379 <div class="sect2" title="Interaction with QCG Notification"> 1380 <div class="titlepage"> 1381 <div> 1382 <div> 1383 <h3 class="title"> 1384 <a id="idp188144"/>Interaction with 1385 <span class="emphasis"> 1386 <em>QCG Notification 1387 </em> 1388 </span> 1389 </h3> 1390 </div> 1391 </div> 1392 </div> 1393 <p>In the next subsections an issue of cooperation with 1394 <span class="emphasis"> 1395 <em>QCG 1396 Notification 1397 </em> 1398 </span> is presented independently for a Publisher, 228 1399 Subscriber and NotificationConsumer. Although a conceptual style of 229 1400 interaction is described here in details, technical particularities of 230 constructing messages are presented later.</p><div class="sect3" title="Publisher Interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp190224"/>Publisher Interaction</h4></div></div></div><div class="figure"><a id="idp190864"/><p class="title"><strong>Figure 12. Publisher interaction sequence diagram</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_publisher.png" style="text-align: middle" width="445" alt="Publisher interaction sequence diagram"/></div></div></div><br class="figure-break"/><p>In the most general configuration of the service, a Publisher 1401 constructing messages are presented later. 1402 </p> 1403 <div class="sect3" title="Publisher Interaction"> 1404 <div class="titlepage"> 1405 <div> 1406 <div> 1407 <h4 class="title"> 1408 <a id="idp190240"/>Publisher Interaction 1409 </h4> 1410 </div> 1411 </div> 1412 </div> 1413 <div class="figure"> 1414 <a id="idp190880"/> 1415 <p class="title"> 1416 <strong>Figure 12. Publisher interaction sequence diagram 1417 </strong> 1418 </p> 1419 <div class="figure-contents"> 1420 <div class="mediaobject" style="text-align: center"> 1421 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_publisher.png" style="text-align: middle" width="445" alt="Publisher interaction sequence diagram"/> 1422 </div> 1423 </div> 1424 </div> 1425 <br class="figure-break"/> 1426 <p>In the most general configuration of the service, a Publisher 231 1427 has to be registered before it starts sending Notifications. In this 232 1428 situation, a Publisher sends the RegisterPublisherRequest message to 233 <span class="emphasis"><em>QCG Notification</em></span>. If everything goes well it 1429 1430 <span class="emphasis"> 1431 <em>QCG Notification 1432 </em> 1433 </span>. If everything goes well it 234 1434 receives the RegisterPublisherResponse message with a session ID. From 235 1435 this time a Publisher is entitled for sending Notify messages - the … … 239 1439 replaces the old one in CurrentMessages. After work, a Publisher 240 1440 should unregister himself by sending DestroyRegistration. This message 241 has to include a session ID likewise.</p></div><div class="sect3" title="Subscriber interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp195376"/>Subscriber interaction</h4></div></div></div><div class="figure"><a id="idp196016"/><p class="title"><strong>Figure 13. Subscriber interaction sequence diagram</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_subscriber.png" style="text-align: middle" width="478" alt="Subscriber interaction sequence diagram"/></div></div></div><br class="figure-break"/><p>When a Subscriber wants to create a Subscription, it sends the 242 SubscribeRequest message to <span class="emphasis"><em>QCG Notification</em></span>. 1441 has to include a session ID likewise. 1442 </p> 1443 </div> 1444 <div class="sect3" title="Subscriber interaction"> 1445 <div class="titlepage"> 1446 <div> 1447 <div> 1448 <h4 class="title"> 1449 <a id="idp195392"/>Subscriber interaction 1450 </h4> 1451 </div> 1452 </div> 1453 </div> 1454 <div class="figure"> 1455 <a id="idp196032"/> 1456 <p class="title"> 1457 <strong>Figure 13. Subscriber interaction sequence diagram 1458 </strong> 1459 </p> 1460 <div class="figure-contents"> 1461 <div class="mediaobject" style="text-align: center"> 1462 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_subscriber.png" style="text-align: middle" width="478" alt="Subscriber interaction sequence diagram"/> 1463 </div> 1464 </div> 1465 </div> 1466 <br class="figure-break"/> 1467 <p>When a Subscriber wants to create a Subscription, it sends the 1468 SubscribeRequest message to 1469 <span class="emphasis"> 1470 <em>QCG Notification 1471 </em> 1472 </span>. 243 1473 This message should contain an address of NotificationConsumer and a 244 1474 TopicExpression that specifies a Topic or a set of Topics on which … … 248 1478 From the version 2.5.0 of the system, the Subscriber may specify XSLT 249 1479 document that will be used to transform message content by certain 250 publishing modules. After creation of a Subscription <span class="emphasis"><em>QCG 251 Notification</em></span> sends the SubscribeResponse message with a 1480 publishing modules. After creation of a Subscription 1481 <span class="emphasis"> 1482 <em>QCG 1483 Notification 1484 </em> 1485 </span> sends the SubscribeResponse message with a 252 1486 created Subscription ID. This ID should be attached to the 253 1487 UnsubscribeRequest message when a Subscription is not wanted and the 254 1488 Renew message when a Subscription should be refreshed. A Subscriber is 255 allowed to create many equal Subscriptions.</p><p>If a scenario requires pull-style of notifications, a Subscriber 1489 allowed to create many equal Subscriptions. 1490 </p> 1491 <p>If a scenario requires pull-style of notifications, a Subscriber 256 1492 can create a set of PullPoints. In a such situation, it has to invoke 257 the CreatePullPoint method offered by <span class="emphasis"><em>QCG Notification. 258 <span class="emphasis"><em>The response parameter of this method will be an address to 259 the newly created <span class="emphasis"><em>PullPoint resource (Subscribers can assign 1493 the CreatePullPoint method offered by 1494 <span class="emphasis"> 1495 <em>QCG Notification. 1496 1497 <span class="emphasis"> 1498 <em>The response parameter of this method will be an address to 1499 the newly created 1500 <span class="emphasis"> 1501 <em>PullPoint resource (Subscribers can assign 260 1502 this resources as NotificationConsumers in theirs Subscriptions). A 261 1503 PullPoint resource can be destroyed by the DestroyPullPoint message 262 1504 sent directly to this resource. 263 </em></span></em></span></em></span></p></div><div class="sect3" title="NotificationConsumer Interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp202720"/>NotificationConsumer Interaction</h4></div></div></div><div class="figure"><a id="idp203488"/><p class="title"><strong>Figure 14. NotificationConsumer interaction sequence diagram</strong></p><div class="figure-contents"><div class="mediaobject" style="text-align: center"><img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_consumer.png" style="text-align: middle" width="473" alt="NotificationConsumer interaction sequence diagram"/></div></div></div><p><br class="figure-break"/>The main capability of a NotificationConsumer is a 1505 1506 </em> 1507 </span> 1508 </em> 1509 </span> 1510 </em> 1511 </span> 1512 </p> 1513 </div> 1514 <div class="sect3" title="NotificationConsumer Interaction"> 1515 <div class="titlepage"> 1516 <div> 1517 <div> 1518 <h4 class="title"> 1519 <a id="idp202736"/>NotificationConsumer Interaction 1520 </h4> 1521 </div> 1522 </div> 1523 </div> 1524 <div class="figure"> 1525 <a id="idp203504"/> 1526 <p class="title"> 1527 <strong>Figure 14. NotificationConsumer interaction sequence diagram 1528 </strong> 1529 </p> 1530 <div class="figure-contents"> 1531 <div class="mediaobject" style="text-align: center"> 1532 <img src="http://apps.man.poznan.pl/trac/qcg-notification/raw-attachment/wiki/technicalGuideAndManual/seq_consumer.png" style="text-align: middle" width="473" alt="NotificationConsumer interaction sequence diagram"/> 1533 </div> 1534 </div> 1535 </div> 1536 <p> 1537 <br class="figure-break"/>The main capability of a NotificationConsumer is a 264 1538 receiving of Notify messages. A NotificationConsumer can implement an 265 interface for receiving Notify messages sending by <span class="emphasis"><em>QCG 266 Notification</em></span> or can be a client of a PullPoint. In the 1539 interface for receiving Notify messages sending by 1540 <span class="emphasis"> 1541 <em>QCG 1542 Notification 1543 </em> 1544 </span> or can be a client of a PullPoint. In the 267 1545 second case, a NotificationConsumer can invoke GetMessages method 268 1546 offered by a certain PullPoint. Messages buffered in the PullPoint 269 1547 will be removed from the buffer and delivered in GetMessagesResponse 270 to the consumer.</p><p>On the other hand, when a NotificationConsumer wants to receive 1548 to the consumer. 1549 </p> 1550 <p>On the other hand, when a NotificationConsumer wants to receive 271 1551 the last Notification message sent on a specific Topic, it can do this 272 by sending GetCurrentMessageRequest to <span class="emphasis"><em>QCG 273 Notification</em></span>. Requested Notification will be supplied in 274 the GetCurrentMessageResponse message.</p></div></div><div xml:lang="" class="sect2" title="Topics, TopicExpressions and Dialects"><div class="titlepage"><div><div><h3 class="title"><a id="ted"/>Topics, TopicExpressions and Dialects</h3></div></div></div><p>Before start-up of a <span class="emphasis"><em>QCG Notification</em></span> 1552 by sending GetCurrentMessageRequest to 1553 <span class="emphasis"> 1554 <em>QCG 1555 Notification 1556 </em> 1557 </span>. Requested Notification will be supplied in 1558 the GetCurrentMessageResponse message. 1559 </p> 1560 </div> 1561 </div> 1562 <div xml:lang="" class="sect2" title="Topics, TopicExpressions and Dialects"> 1563 <div class="titlepage"> 1564 <div> 1565 <div> 1566 <h3 class="title"> 1567 <a id="ted"/>Topics, TopicExpressions and Dialects 1568 </h3> 1569 </div> 1570 </div> 1571 </div> 1572 <p>Before start-up of a 1573 <span class="emphasis"> 1574 <em>QCG Notification 1575 </em> 1576 </span> 275 1577 service, there should be defined Topic Namespaces in a system. Topic 276 1578 Namespaces should be created (usually by Publishers) and delivered to 277 a<span class="emphasis"><em> QCG Notification</em></span> administrator in a form of XML 1579 a 1580 <span class="emphasis"> 1581 <em> QCG Notification 1582 </em> 1583 </span> administrator in a form of XML 278 1584 documents. A following record presents a sample Topic Namespace 279 1585 identified by 280 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics.</em></span></p><pre class="programlisting"><wstop:TopicNamespace 1586 1587 <span class="emphasis"> 1588 <em>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics. 1589 </em> 1590 </span> 1591 </p> 1592 <pre class="programlisting"><wstop:TopicNamespace 281 1593 xmlns:wstop="http://docs.oasis-open.org/wsn/t-1" 282 1594 targetNamespace="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"> … … 297 1609 </wstop:Topic> 298 1610 </wstop:Topic> 299 </wstop:TopicNamespace></pre><p><span class="emphasis"><em>QCG Notification </em></span>supports three types of 300 dialects: <span class="emphasis"><em>Simple</em></span>, <span class="emphasis"><em>Concrete</em></span> and 301 <span class="emphasis"><em>Full</em></span>. If a message refer to Topics, it has to 1611 </wstop:TopicNamespace> 1612 </pre> 1613 <p> 1614 <span class="emphasis"> 1615 <em>QCG Notification 1616 </em> 1617 </span>supports three types of 1618 dialects: 1619 <span class="emphasis"> 1620 <em>Simple 1621 </em> 1622 </span>, 1623 <span class="emphasis"> 1624 <em>Concrete 1625 </em> 1626 </span> and 1627 1628 <span class="emphasis"> 1629 <em>Full 1630 </em> 1631 </span>. If a message refer to Topics, it has to 302 1632 define TopicExpression that identifies one or more Topics (note there 303 1633 are situations when TopicExpression has to refer to exactly one Topic). … … 306 1636 select an appropriate Topic Namespace, the first part of TopicExpression 307 1637 should be presented in a form of a prefix that refers to this 308 namespace.</p><p>For more details see: <a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf</a> 309 and check out examples of methods in the <a class="link" href="#methodsdescription">section 3.4.</a></p></div><div class="sect2" title="Extensions"><div class="titlepage"><div><div><h3 class="title"><a id="idp217360"/>Extensions</h3></div></div></div><p>The Oasis standard for notifications doesn't define details for 1638 namespace. 1639 </p> 1640 <p>For more details see: 1641 <a class="ulink" href="http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-pr-0.2.pdf">http://docs.oasis-open.org/wsn/wsn-ws_topics-1.3-spec-os.pdf 1642 </a> 1643 and check out examples of methods in the 1644 <a class="link" href="#methodsdescription">section 3.4. 1645 </a> 1646 </p> 1647 </div> 1648 <div class="sect2" title="Extensions"> 1649 <div class="titlepage"> 1650 <div> 1651 <div> 1652 <h3 class="title"> 1653 <a id="idp217376"/>Extensions 1654 </h3> 1655 </div> 1656 </div> 1657 </div> 1658 <p>The Oasis standard for notifications doesn't define details for 310 1659 lower Levels of functionality so an architect of system is obligated to 311 introduce some extensions and clarifications. In the <span class="emphasis"><em>QCG 312 Notification </em></span>scenario there are several messages that have to 1660 introduce some extensions and clarifications. In the 1661 <span class="emphasis"> 1662 <em>QCG 1663 Notification 1664 </em> 1665 </span>scenario there are several messages that have to 313 1666 be expanded with additional information written as embedded XML. Some of 314 1667 these extensions are related with other Oasis standards but some are 315 1668 quite new. Technical details are described in the successive 316 subsections.</p><div class="sect3" title="TopicExpression"><div class="titlepage"><div><div><h4 class="title"><a id="idp219296"/>TopicExpression</h4></div></div></div><p><span class="emphasis"><em>QCG Notification </em></span>remote peers have to use 1669 subsections. 1670 </p> 1671 <div class="sect3" title="TopicExpression"> 1672 <div class="titlepage"> 1673 <div> 1674 <div> 1675 <h4 class="title"> 1676 <a id="idp219312"/>TopicExpression 1677 </h4> 1678 </div> 1679 </div> 1680 </div> 1681 <p> 1682 <span class="emphasis"> 1683 <em>QCG Notification 1684 </em> 1685 </span>remote peers have to use 317 1686 an appropriate TopicExpression XML element. The schema of this element 318 is defined according to Oasis standard in<a class="ulink" href="http://docs.oasis-open.org/wsn/b-2.xsd"><a class="ulink" href="http://docs.oasis-open.org/wsn/b-2.xsd"> 319 http://docs.oasis-open.org/wsn/b-2.xsd</a></a>. Please note 1687 is defined according to Oasis standard in 1688 <a class="ulink" href="http://docs.oasis-open.org/wsn/b-2.xsd"> 1689 <a class="ulink" href="http://docs.oasis-open.org/wsn/b-2.xsd"> 1690 http://docs.oasis-open.org/wsn/b-2.xsd 1691 </a> 1692 </a>. Please note 320 1693 here that the Nofity and GetCurrentMessageRequest messages contain a 321 1694 Topic element which contains a required @Dialect attribute. Also … … 323 1696 with the WSDL document, a @Dialect from the Topic element is 324 1697 significant. It is not necessary but preferred to attach the same 325 @Dialect in the TopicExpression element against.</p></div><div class="sect3" title="QCG Notification Extensions"><div class="titlepage"><div><div><h4 class="title"><a id="idp222320"/><span class="emphasis"><em>QCG Notification</em></span> Extensions</h4></div></div></div><p><span class="emphasis"><em>QCG Notification</em></span> introduces some extensions 1698 @Dialect in the TopicExpression element against. 1699 </p> 1700 </div> 1701 <div class="sect3" title="QCG Notification Extensions"> 1702 <div class="titlepage"> 1703 <div> 1704 <div> 1705 <h4 class="title"> 1706 <a id="idp222336"/> 1707 <span class="emphasis"> 1708 <em>QCG Notification 1709 </em> 1710 </span> Extensions 1711 </h4> 1712 </div> 1713 </div> 1714 </div> 1715 <p> 1716 <span class="emphasis"> 1717 <em>QCG Notification 1718 </em> 1719 </span> introduces some extensions 326 1720 to WSDL as well as schema documents related to the Oasis standard. The 327 1721 following schema defines these extensions. The first three elements … … 332 1726 managing methods, the elements are used in order to: listing 333 1727 Subscriptions, listing PublisherRegistrations and listing 334 PullPoints.</p><pre class="programlisting"><?xml version="1.0" encoding="UTF-8"?> 1728 PullPoints. 1729 </p> 1730 <pre class="programlisting"><?xml version="1.0" encoding="UTF-8"?> 335 1731 <xsd:schema 336 1732 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions" … … 639 2035 </xsd:element> 640 2036 641 </xsd:schema></pre></div></div><div class="sect2" title="Methods Description"><div class="titlepage"><div><div><h3 class="title"><a id="idp237760"/>Methods Description</h3></div></div></div><p>The main idea of this chapter is to present the types of messages 642 used in the <span class="emphasis"><em>QCG Notification</em></span> scenario as well as 2037 </xsd:schema> 2038 </pre> 2039 </div> 2040 </div> 2041 <div class="sect2" title="Methods Description"> 2042 <div class="titlepage"> 2043 <div> 2044 <div> 2045 <h3 class="title"> 2046 <a id="idp237776"/>Methods Description 2047 </h3> 2048 </div> 2049 </div> 2050 </div> 2051 <p>The main idea of this chapter is to present the types of messages 2052 used in the 2053 <span class="emphasis"> 2054 <em>QCG Notification 2055 </em> 2056 </span> scenario as well as 643 2057 introduce how to construct and interpret these messages. The majority of 644 them is two-way style and initiated by <span class="emphasis"><em>QCG 645 Notification</em></span> clients. Exception is the Notify message that is 2058 them is two-way style and initiated by 2059 <span class="emphasis"> 2060 <em>QCG 2061 Notification 2062 </em> 2063 </span> clients. Exception is the Notify message that is 646 2064 one-way style. In the first phase it is transported from a Publisher to 647 <span class="emphasis"><em>QCG Notification</em></span> and in the second it is 648 transported from <span class="emphasis"><em>QCG Notification</em></span> to subscribed 649 NotificationConsumers.</p><p>All supported by <span class="emphasis"><em>QCG Notification</em></span> message 650 types are presented and explained below.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>The key information are thick;</p></li><li class="listitem"><p>A base of the messages structure is a delivered WSDL file, 651 however there are also extensions;</p></li><li class="listitem"><p>For all messages it is important to set a correct 2065 2066 <span class="emphasis"> 2067 <em>QCG Notification 2068 </em> 2069 </span> and in the second it is 2070 transported from 2071 <span class="emphasis"> 2072 <em>QCG Notification 2073 </em> 2074 </span> to subscribed 2075 NotificationConsumers. 2076 </p> 2077 <p>All supported by 2078 <span class="emphasis"> 2079 <em>QCG Notification 2080 </em> 2081 </span> message 2082 types are presented and explained below. 2083 </p> 2084 <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> 2085 <h3 class="title">Note 2086 </h3> 2087 <div class="itemizedlist"> 2088 <ul class="itemizedlist"> 2089 <li class="listitem"> 2090 <p>The key information are thick; 2091 </p> 2092 </li> 2093 <li class="listitem"> 2094 <p>A base of the messages structure is a delivered WSDL file, 2095 however there are also extensions; 2096 </p> 2097 </li> 2098 <li class="listitem"> 2099 <p>For all messages it is important to set a correct 652 2100 WS-Addressing Action property which should be the same as SOAP 653 Action.</p></li></ul></div></div><div class="sect3" title="SubscribeRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp245776"/>SubscribeRequest</h4></div></div></div><p>SubscribeRequest is sent by a Subscriber to <span class="emphasis"><em>QCG 654 Notification</em></span>. The message should contain information about 2101 Action. 2102 </p> 2103 </li> 2104 </ul> 2105 </div> 2106 </div> 2107 <div class="sect3" title="SubscribeRequest"> 2108 <div class="titlepage"> 2109 <div> 2110 <div> 2111 <h4 class="title"> 2112 <a id="idp245792"/>SubscribeRequest 2113 </h4> 2114 </div> 2115 </div> 2116 </div> 2117 <p>SubscribeRequest is sent by a Subscriber to 2118 <span class="emphasis"> 2119 <em>QCG 2120 Notification 2121 </em> 2122 </span>. The message should contain information about 655 2123 a NotificationConsumer and an expression defining Topic or Topics that 656 2124 the Subscription will affect. If a message processing is successful, a 657 2125 Subscription is created. It is possible to create many equal 658 2126 Subscriptions by sending numerously the same SubscribeRequest 659 message.</p><pre class="programlisting">SOAP-ENV:Envelope ... > 2127 message. 2128 </p> 2129 <pre class="programlisting">SOAP-ENV:Envelope ... > 660 2130 <SOAP-ENV:Header> 661 2131 <wsa:Action SOAP-ENV:mustUnderstand="1"> 662 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 663 NotificationProducer/SubscribeRequest</strong></span> 2132 2133 <span class="bold"> 2134 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2135 NotificationProducer/SubscribeRequest 2136 </strong> 2137 </span> 664 2138 </wsa:Action> 665 2139 ... … … 669 2143 <wsnt:ConsumerReference> 670 2144 <wsa:Address> 671 <span class="bold"><strong>https://localhost:2233</strong></span> 2145 2146 <span class="bold"> 2147 <strong>https://localhost:2233 2148 </strong> 2149 </span> 672 2150 </wsa:Address> 673 2151 </wsnt:ConsumerReference> 674 2152 <wsnt:Filter> 675 2153 <wsnt:TopicExpression 676 <span class="bold"><strong>xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"</strong></span> 677 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 678 <span class="bold"><strong>tns://*</strong></span> 2154 2155 <span class="bold"> 2156 <strong>xmlns:tns=" 2157 <span class="bold"> 2158 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 2159 </strong> 2160 </span>" 2161 </strong> 2162 </span> 2163 Dialect= 2164 <span class="bold"> 2165 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 2166 </strong> 2167 </span>> 2168 2169 <span class="bold"> 2170 <strong>tns://* 2171 </strong> 2172 </span> 679 2173 </wsnt:TopicExpression> 680 2174 <wsnt:MessageContent 681 <span class="bold"><strong>xmlns:smnex=http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage</strong></span> 2175 2176 <span class="bold"> 2177 <strong>xmlns:smnex=http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage 2178 </strong> 2179 </span> 682 2180 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 683 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 2181 2182 <span class="bold"> 2183 <strong>boolean(//smnex:State[text()="on"]) 2184 </strong> 2185 </span> 684 2186 </wsnt:MessageContent> 685 2187 </wsnt:Filter> 686 2188 <wsnt:InitialTerminationTime> 687 <span class="bold"><strong>2007-07-23T10:24:14+02:00</strong></span> 2189 2190 <span class="bold"> 2191 <strong>2007-07-23T10:24:14+02:00 2192 </strong> 2193 </span> 688 2194 </wsnt:InitialTerminationTime> 689 2195 <smn-ext:XSLTTranslation> 690 <![[CDATA<span class="bold"><strong> 2196 <![[CDATA 2197 <span class="bold"> 2198 <strong> 691 2199 <?xml version="1.0" encoding="ISO-8859-1"?> 692 2200 <xsl:stylesheet version 1.0" … … 701 2209 Value of State is: <xsl:value-of select="."/> 702 2210 </xsl:template> 703 </xsl:stylesheet></strong></span> 2211 </xsl:stylesheet> 2212 </strong> 2213 </span> 704 2214 ]]> 705 2215 </smn-ext:XSLTTranslation> 706 2216 </wsnt:Subscribe> 707 2217 </SOAP-ENV:Body> 708 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 709 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 710 NotificationProducer/SubscribeRequest. <span class="emphasis"><em>If differ, a 711 fault will be returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:ConsumerReference/wsa:Address</em></span></p><p>A Consumer address. It is significant to specify a correct 2218 </SOAP-ENV:Envelope> 2219 </pre> 2220 <div class="itemizedlist"> 2221 <ul class="itemizedlist"> 2222 <li class="listitem"> 2223 <p> 2224 <span class="emphasis"> 2225 <em>//SOAP-ENV:Header/wsa:Action 2226 </em> 2227 </span> 2228 </p> 2229 <p>For this message should always be: 2230 2231 <span class="emphasis"> 2232 <em>http://docs.oasis-open.org/wsn/bw-2/ 2233 NotificationProducer/SubscribeRequest. 2234 <span class="emphasis"> 2235 <em>If differ, a 2236 fault will be returned. 2237 </em> 2238 </span> 2239 </em> 2240 </span> 2241 </p> 2242 </li> 2243 <li class="listitem"> 2244 <p> 2245 <span class="emphasis"> 2246 <em>//wsnt:Subscribe/wsnt:ConsumerReference/wsa:Address 2247 </em> 2248 </span> 2249 </p> 2250 <p>A Consumer address. It is significant to specify a correct 712 2251 prefix (http, https, xmpp). The prefix should be adequate to the 713 expected type of connection between <span class="emphasis"><em>QCG 714 Notification</em></span> and NotificationConsumer(s): http for 2252 expected type of connection between 2253 <span class="emphasis"> 2254 <em>QCG 2255 Notification 2256 </em> 2257 </span> and NotificationConsumer(s): http for 715 2258 anonymous, https for ssl-based and xmpp for sending notifications 716 to jabber clients.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter</em></span></p><p>In this element, a Subscriber defines filtering parameters 2259 to jabber clients. 2260 </p> 2261 </li> 2262 <li class="listitem"> 2263 <p> 2264 <span class="emphasis"> 2265 <em>//wsnt:Subscribe/wsnt:Filter 2266 </em> 2267 </span> 2268 </p> 2269 <p>In this element, a Subscriber defines filtering parameters 717 2270 to the Subscription being created. In other words, it identifies a 718 2271 type of Notifications that should be forwarded to the selected 719 Notification Consumer.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>This element defines Topic or Topics 2272 Notification Consumer. 2273 </p> 2274 </li> 2275 <li class="listitem"> 2276 <p> 2277 <span class="emphasis"> 2278 <em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression 2279 </em> 2280 </span> 2281 </p> 2282 <p> 2283 <span class="emphasis"> 2284 <em> 2285 <span class="emphasis"> 2286 <em>This element defines Topic or Topics 720 2287 that Subscription should affect. Topics should come from supported 721 2288 Topic Namespaces that are also defined for the element. … … 724 2291 TopicExpression element and assigned to some prefix (e.g. tns) or 725 2292 (2) using inline form (e.g. 726 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}//*).</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression/@Dialect</em></span></p><p>URI that specifies a TopicExpression Dialect type. Allowed 2293 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}//*). 2294 </em> 2295 </span> 2296 </em> 2297 </span> 2298 </p> 2299 </li> 2300 <li class="listitem"> 2301 <p> 2302 <span class="emphasis"> 2303 <em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression/@Dialect 2304 </em> 2305 </span> 2306 </p> 2307 <p>URI that specifies a TopicExpression Dialect type. Allowed 727 2308 Dialects types are as follows: 728 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 2309 2310 <span class="emphasis"> 2311 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 729 2312 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 730 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:MessageContent</em></span></p><p>An optional element. If present, the MessageContent should 2313 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 2314 </em> 2315 </span> 2316 </p> 2317 </li> 2318 <li class="listitem"> 2319 <p> 2320 <span class="emphasis"> 2321 <em>//wsnt:Subscribe/wsnt:Filter/wsnt:MessageContent 2322 </em> 2323 </span> 2324 </p> 2325 <p>An optional element. If present, the MessageContent should 731 2326 define an XPath boolean expression that will be evaluated over 732 2327 redistributed Notification Messages to true or false. If such an … … 737 2332 boolean(//{http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage}State[text()="on"].The 738 2333 Dialect should always be: 739 <span class="emphasis"><em>http://www.w3.org/TR/1999/REC-xpath-19991116</em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:InitialTerminationTime</em></span></p><p>An optional element. If present, must contain a Subscriber 2334 2335 <span class="emphasis"> 2336 <em>http://www.w3.org/TR/1999/REC-xpath-19991116 2337 </em> 2338 </span> 2339 </p> 2340 </li> 2341 <li class="listitem"> 2342 <p> 2343 <span class="emphasis"> 2344 <em>//wsnt:Subscribe/wsnt:InitialTerminationTime 2345 </em> 2346 </span> 2347 </p> 2348 <p>An optional element. If present, must contain a Subscriber 740 2349 suggestion for the termination time of the Subscription being 741 2350 created (expressed as a local time with timezone). If not present, 742 the termination time is determined automatically - <span class="emphasis"><em>QCG 743 Notification <span class="emphasis"><em>specify a default time 744 period</em></span></em></span> for the Subscription to be 745 valid.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Subscribe/smn-ext:XSLTTranslation</em></span></p><p>An optional element. Inside the XSLTTranslation a Subscriber 2351 the termination time is determined automatically - 2352 <span class="emphasis"> 2353 <em>QCG 2354 Notification 2355 <span class="emphasis"> 2356 <em>specify a default time 2357 period 2358 </em> 2359 </span> 2360 </em> 2361 </span> for the Subscription to be 2362 valid. 2363 </p> 2364 </li> 2365 <li class="listitem"> 2366 <p> 2367 <span class="emphasis"> 2368 <em>//wsnt:Subscribe/smn-ext:XSLTTranslation 2369 </em> 2370 </span> 2371 </p> 2372 <p>An optional element. Inside the XSLTTranslation a Subscriber 746 2373 may deliver an XSLT document that will be used by some publishing 747 2374 modules to transform notification messages to a different form 748 2375 (for example user readable). Note that an actual XSLT document 749 should be enclosed in <![[CDATA and ]]> markers.</p></li></ul></div></div><div class="sect3" title="SubscribeResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp272320"/>SubscribeResponse</h4></div></div></div><p>In answer on SubscribeRequest there is sent the 750 SubscribeResponse message. <span class="emphasis"><em>QCG Notification</em></span> 2376 should be enclosed in <![[CDATA and ]]> markers. 2377 </p> 2378 </li> 2379 </ul> 2380 </div> 2381 </div> 2382 <div class="sect3" title="SubscribeResponse"> 2383 <div class="titlepage"> 2384 <div> 2385 <div> 2386 <h4 class="title"> 2387 <a id="idp272576"/>SubscribeResponse 2388 </h4> 2389 </div> 2390 </div> 2391 </div> 2392 <p>In answer on SubscribeRequest there is sent the 2393 SubscribeResponse message. 2394 <span class="emphasis"> 2395 <em>QCG Notification 2396 </em> 2397 </span> 751 2398 deliver in this message a reference to the created Subscription. This 752 ID can be used for manipulation and to remove the Subscription.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2399 ID can be used for manipulation and to remove the Subscription. 2400 </p> 2401 <pre class="programlisting"><SOAP-ENV:Envelope ... > 753 2402 <SOAP-ENV:Header> 754 2403 <wsa:Action SOAP-ENV:mustUnderstand="1"> 755 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 756 NotificationProducer/SubscribeResponse</strong></span> 2404 2405 <span class="bold"> 2406 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2407 NotificationProducer/SubscribeResponse 2408 </strong> 2409 </span> 757 2410 </wsa:Action> 758 2411 ... … … 762 2415 <wsnt:SubscriptionReference> 763 2416 <wsa:Address> 764 <span class="bold"><strong>http://some.address</strong></span> 2417 2418 <span class="bold"> 2419 <strong>http://some.address 2420 </strong> 2421 </span> 765 2422 </wsa:Address> 766 2423 <wsa:ReferenceParameters> 767 <span class="bold"><strong><SubscriptionID 2424 2425 <span class="bold"> 2426 <strong><SubscriptionID 768 2427 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions"> 769 2428 506435877 770 </SubscriptionID></strong></span> 2429 </SubscriptionID> 2430 </strong> 2431 </span> 771 2432 </wsa:ReferenceParameters> 772 2433 </wsnt:SubscriptionReference> 773 2434 </wsnt:SubscribeResponse> 774 2435 </SOAP-ENV:Body> 775 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 776 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 777 NotificationProducer/SubscribeResponse. <span class="emphasis"><em>If differ, a 778 fault will be returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/wsa:Address</em></span></p><p>An address of a SubscriptionManager interface. In the 779 current solution it is the <span class="emphasis"><em>QCG Notification</em></span> 780 service address.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/</em></span></p><p><span class="emphasis"><em>wsa:ReferenceParameters/SubscriptionID</em></span></p><p>An extensive element in xsd:any that contains Subscription 781 ID. At this time it is at most 32 char long string.</p></li></ul></div></div><div class="sect3" title="RenewRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp283376"/>RenewRequest</h4></div></div></div><p>When a Subscriber wants to renew a Subscription, it can send the 782 RenewRequest message to <span class="emphasis"><em>QCG Notification</em></span>. The 2436 </SOAP-ENV:Envelope> 2437 </pre> 2438 <div class="itemizedlist"> 2439 <ul class="itemizedlist"> 2440 <li class="listitem"> 2441 <p> 2442 <span class="emphasis"> 2443 <em>//SOAP-ENV:Header/wsa:Action 2444 </em> 2445 </span> 2446 </p> 2447 <p>For this message should always be: 2448 2449 <span class="emphasis"> 2450 <em>http://docs.oasis-open.org/wsn/bw-2/ 2451 NotificationProducer/SubscribeResponse. 2452 <span class="emphasis"> 2453 <em>If differ, a 2454 fault will be returned. 2455 </em> 2456 </span> 2457 </em> 2458 </span> 2459 </p> 2460 </li> 2461 <li class="listitem"> 2462 <p> 2463 <span class="emphasis"> 2464 <em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/wsa:Address 2465 </em> 2466 </span> 2467 </p> 2468 <p>An address of a SubscriptionManager interface. In the 2469 current solution it is the 2470 <span class="emphasis"> 2471 <em>QCG Notification 2472 </em> 2473 </span> 2474 service address. 2475 </p> 2476 </li> 2477 <li class="listitem"> 2478 <p> 2479 <span class="emphasis"> 2480 <em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/ 2481 </em> 2482 </span> 2483 </p> 2484 <p> 2485 <span class="emphasis"> 2486 <em>wsa:ReferenceParameters/SubscriptionID 2487 </em> 2488 </span> 2489 </p> 2490 <p>An extensive element in xsd:any that contains Subscription 2491 ID. At this time it is at most 32 char long string. 2492 </p> 2493 </li> 2494 </ul> 2495 </div> 2496 </div> 2497 <div class="sect3" title="RenewRequest"> 2498 <div class="titlepage"> 2499 <div> 2500 <div> 2501 <h4 class="title"> 2502 <a id="idp284496"/>RenewRequest 2503 </h4> 2504 </div> 2505 </div> 2506 </div> 2507 <p>When a Subscriber wants to renew a Subscription, it can send the 2508 RenewRequest message to 2509 <span class="emphasis"> 2510 <em>QCG Notification 2511 </em> 2512 </span>. The 783 2513 message should contain the Subscription ID element and a new 784 termination time suggestion.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2514 termination time suggestion. 2515 </p> 2516 <pre class="programlisting"><SOAP-ENV:Envelope ... > 785 2517 <SOAP-ENV:Header> 786 2518 <wsa:Action SOAP-ENV:mustUnderstand="1"> 787 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 788 SubscriptionManager/RenewRequest</strong></span> 2519 2520 <span class="bold"> 2521 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2522 SubscriptionManager/RenewRequest 2523 </strong> 2524 </span> 789 2525 </wsa:Action> 790 2526 ... … … 793 2529 <wsnt:Renew> 794 2530 <wsnt:TerminationTime> 795 <span class="bold"><strong>2007-07-25T12:24:14+02:00</strong></span> 2531 2532 <span class="bold"> 2533 <strong>2007-07-25T12:24:14+02:00 2534 </strong> 2535 </span> 796 2536 </wsnt:TerminationTime> 797 2537 <smn-ext:SubscriptionID> 798 <span class="bold"><strong>506435877</strong></span> 2538 2539 <span class="bold"> 2540 <strong>506435877 2541 </strong> 2542 </span> 799 2543 </smn-ext:SubscriptionID> 800 2544 </wsnt:Renew> 801 2545 </SOAP-ENV:Body> 802 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 803 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 804 SubscriptionManager/RenewRequest. <span class="emphasis"><em>If differ, a fault 805 will be returned.</em></span></em></span></p></li><li class="listitem"><p>//wsnt:Renew/wsnt:TerminationTime</p><p>A Subscriber suggestion for the new termination time of the 2546 </SOAP-ENV:Envelope> 2547 </pre> 2548 <div class="itemizedlist"> 2549 <ul class="itemizedlist"> 2550 <li class="listitem"> 2551 <p> 2552 <span class="emphasis"> 2553 <em>//SOAP-ENV:Header/wsa:Action 2554 </em> 2555 </span> 2556 </p> 2557 <p>For this message should always be: 2558 2559 <span class="emphasis"> 2560 <em>http://docs.oasis-open.org/wsn/bw-2/ 2561 SubscriptionManager/RenewRequest. 2562 <span class="emphasis"> 2563 <em>If differ, a fault 2564 will be returned. 2565 </em> 2566 </span> 2567 </em> 2568 </span> 2569 </p> 2570 </li> 2571 <li class="listitem"> 2572 <p>//wsnt:Renew/wsnt:TerminationTime 2573 </p> 2574 <p>A Subscriber suggestion for the new termination time of the 806 2575 Subscription being renewed (expressed as a local time with 807 timezone).</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Renew/smn-ext:SubscriptionID</em></span></p><p>A Subscription ID that was received in the SubscribeResponse 808 message.</p></li></ul></div></div><div class="sect3" title="RenewResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp293232"/>RenewResponse</h4></div></div></div><p>An answer to the RenewRequest message is RenewResponse. The 2576 timezone). 2577 </p> 2578 </li> 2579 <li class="listitem"> 2580 <p> 2581 <span class="emphasis"> 2582 <em>//wsnt:Renew/smn-ext:SubscriptionID 2583 </em> 2584 </span> 2585 </p> 2586 <p>A Subscription ID that was received in the SubscribeResponse 2587 message. 2588 </p> 2589 </li> 2590 </ul> 2591 </div> 2592 </div> 2593 <div class="sect3" title="RenewResponse"> 2594 <div class="titlepage"> 2595 <div> 2596 <div> 2597 <h4 class="title"> 2598 <a id="idp295296"/>RenewResponse 2599 </h4> 2600 </div> 2601 </div> 2602 </div> 2603 <p>An answer to the RenewRequest message is RenewResponse. The 809 2604 message contains a termination time for the renewed 810 Subscription.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2605 Subscription. 2606 </p> 2607 <pre class="programlisting"><SOAP-ENV:Envelope ... > 811 2608 <SOAP-ENV:Header> 812 2609 <wsa:Action SOAP-ENV:mustUnderstand="1"> 813 <span class="bold"><strong> http://docs.oasis-open.org/wsn/bw-2/ 814 SubscriptionManager/RenewResponse</strong></span> 2610 2611 <span class="bold"> 2612 <strong> http://docs.oasis-open.org/wsn/bw-2/ 2613 SubscriptionManager/RenewResponse 2614 </strong> 2615 </span> 815 2616 </wsa:Action> 816 2617 ... … … 819 2620 <wsnt:RenewResponse> 820 2621 <wsnt:TerminationTime> 821 <span class="bold"><strong>2007-07-25T10:24:14Z</strong></span> 2622 2623 <span class="bold"> 2624 <strong>2007-07-25T10:24:14Z 2625 </strong> 2626 </span> 822 2627 </wsnt:TerminationTime> 823 2628 <wsnt:CurrentTime> 824 <span class="bold"><strong>2007-07-24T10:24:14Z</strong></span> 2629 2630 <span class="bold"> 2631 <strong>2007-07-24T10:24:14Z 2632 </strong> 2633 </span> 825 2634 </wsnt:CurrentTime> 826 2635 </wsnt:RenewResponse> 827 2636 </SOAP-ENV:Body> 828 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 829 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 830 SubscriptionManager/RenewResponse. <span class="emphasis"><em>If differ, a fault 831 will be returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:RenewResponse/wsnt:TerminationTime</em></span></p><p>A new termination time for the renewed Subscription 832 (expressed as UTC Time).</p></li></ul></div><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//wsnt:RenewResponse/wsnt:CurrentTime</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>A </em></span>QCG 833 Notification's</em></span> time when the Subscription was renewing 834 (expressed as UTC Time).</p></li></ul></div></div><div class="sect3" title="UnsubscribeRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp303536"/>UnsubscribeRequest</h4></div></div></div><p>When a Subscriber wants to terminate a Subscription, it has to 835 send the UnsubscribeRequest message to <span class="emphasis"><em>QCG 836 Notification</em></span>. The parameter attached to this request is a 837 Subscription ID.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2637 </SOAP-ENV:Envelope> 2638 </pre> 2639 <div class="itemizedlist"> 2640 <ul class="itemizedlist"> 2641 <li class="listitem"> 2642 <p> 2643 <span class="emphasis"> 2644 <em>//SOAP-ENV:Header/wsa:Action 2645 </em> 2646 </span> 2647 </p> 2648 <p>For this message should always be: 2649 2650 <span class="emphasis"> 2651 <em>http://docs.oasis-open.org/wsn/bw-2/ 2652 SubscriptionManager/RenewResponse. 2653 <span class="emphasis"> 2654 <em>If differ, a fault 2655 will be returned. 2656 </em> 2657 </span> 2658 </em> 2659 </span> 2660 </p> 2661 </li> 2662 <li class="listitem"> 2663 <p> 2664 <span class="emphasis"> 2665 <em>//wsnt:RenewResponse/wsnt:TerminationTime 2666 </em> 2667 </span> 2668 </p> 2669 <p>A new termination time for the renewed Subscription 2670 (expressed as UTC Time). 2671 </p> 2672 </li> 2673 </ul> 2674 </div> 2675 <div class="itemizedlist"> 2676 <ul class="itemizedlist"> 2677 <li class="listitem"> 2678 <p> 2679 <span class="emphasis"> 2680 <em>//wsnt:RenewResponse/wsnt:CurrentTime 2681 </em> 2682 </span> 2683 </p> 2684 <p> 2685 <span class="emphasis"> 2686 <em> 2687 <span class="emphasis"> 2688 <em>A 2689 </em> 2690 </span>QCG 2691 Notification's 2692 </em> 2693 </span> time when the Subscription was renewing 2694 (expressed as UTC Time). 2695 </p> 2696 </li> 2697 </ul> 2698 </div> 2699 </div> 2700 <div class="sect3" title="UnsubscribeRequest"> 2701 <div class="titlepage"> 2702 <div> 2703 <div> 2704 <h4 class="title"> 2705 <a id="idp306960"/>UnsubscribeRequest 2706 </h4> 2707 </div> 2708 </div> 2709 </div> 2710 <p>When a Subscriber wants to terminate a Subscription, it has to 2711 send the UnsubscribeRequest message to 2712 <span class="emphasis"> 2713 <em>QCG 2714 Notification 2715 </em> 2716 </span>. The parameter attached to this request is a 2717 Subscription ID. 2718 </p> 2719 <pre class="programlisting"><SOAP-ENV:Envelope ... > 838 2720 <SOAP-ENV:Header> 839 2721 <wsa:Action SOAP-ENV:mustUnderstand="1"> 840 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 841 SubscriptionManager/UnsubscribeRequest</strong></span> 2722 2723 <span class="bold"> 2724 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2725 SubscriptionManager/UnsubscribeRequest 2726 </strong> 2727 </span> 842 2728 </wsa:Action> 843 2729 ... … … 846 2732 <wsnt:Unsubscribe> 847 2733 <smn-ext:SubscriptionID> 848 <span class="bold"><strong>506435877</strong></span> 2734 2735 <span class="bold"> 2736 <strong>506435877 2737 </strong> 2738 </span> 849 2739 </smn-ext:SubscriptionID> 850 2740 </wsnt:Unsubscribe> 851 2741 </SOAP-ENV:Body> 852 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 853 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 854 SubscriptionManager/UnsubscribeRequest. <span class="emphasis"><em>If differ, a 855 fault will be returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Unsubscribe/smn-ext:SubscriptionID</em></span></p><p>A Subscription ID that was received in the SubscribeResponse 856 message.</p></li></ul></div></div><div class="sect3" title="UnsubscribeResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp312400"/>UnsubscribeResponse</h4></div></div></div><p>UnsubscribeResponse is returned to a Subscriber after 857 successfully processing the UnsubscribeRequest message.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2742 </SOAP-ENV:Envelope> 2743 </pre> 2744 <div class="itemizedlist"> 2745 <ul class="itemizedlist"> 2746 <li class="listitem"> 2747 <p> 2748 <span class="emphasis"> 2749 <em>//SOAP-ENV:Header/wsa:Action 2750 </em> 2751 </span> 2752 </p> 2753 <p>For this message should always be: 2754 2755 <span class="emphasis"> 2756 <em>http://docs.oasis-open.org/wsn/bw-2/ 2757 SubscriptionManager/UnsubscribeRequest. 2758 <span class="emphasis"> 2759 <em>If differ, a 2760 fault will be returned. 2761 </em> 2762 </span> 2763 </em> 2764 </span> 2765 </p> 2766 </li> 2767 <li class="listitem"> 2768 <p> 2769 <span class="emphasis"> 2770 <em>//wsnt:Unsubscribe/smn-ext:SubscriptionID 2771 </em> 2772 </span> 2773 </p> 2774 <p>A Subscription ID that was received in the SubscribeResponse 2775 message. 2776 </p> 2777 </li> 2778 </ul> 2779 </div> 2780 </div> 2781 <div class="sect3" title="UnsubscribeResponse"> 2782 <div class="titlepage"> 2783 <div> 2784 <div> 2785 <h4 class="title"> 2786 <a id="idp315856"/>UnsubscribeResponse 2787 </h4> 2788 </div> 2789 </div> 2790 </div> 2791 <p>UnsubscribeResponse is returned to a Subscriber after 2792 successfully processing the UnsubscribeRequest message. 2793 </p> 2794 <pre class="programlisting"><SOAP-ENV:Envelope ... > 858 2795 <SOAP-ENV:Header> 859 2796 <wsa:Action SOAP-ENV:mustUnderstAand="1"> 860 <span class="bold"><strong> http://docs.oasis-open.org/wsn/bw-2/ 861 SubscriptionManager/UnsubscribeResponse</strong></span> 2797 2798 <span class="bold"> 2799 <strong> http://docs.oasis-open.org/wsn/bw-2/ 2800 SubscriptionManager/UnsubscribeResponse 2801 </strong> 2802 </span> 862 2803 </wsa:Action> 863 2804 ... … … 867 2808 </wsnt:UnsubscribeResponse> 868 2809 </SOAP-ENV:Body> 869 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 870 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 871 SubscriptionManager/UnsubscribeResponse. <span class="emphasis"><em>If differ, a 872 fault will be returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="RegisterPublisherRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp318544"/>RegisterPublisherRequest</h4></div></div></div><p>In order to sending Notifications, a Publisher can be obligated 873 to register himself previously in <span class="emphasis"><em>QCG 874 Notification</em></span>. For this purpose, it sends the 875 RegisterPublisherRequest message to <span class="emphasis"><em>QCG 876 Notification</em></span>.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2810 </SOAP-ENV:Envelope> 2811 </pre> 2812 <div class="itemizedlist"> 2813 <ul class="itemizedlist"> 2814 <li class="listitem"> 2815 <p> 2816 <span class="emphasis"> 2817 <em>//SOAP-ENV:Header/wsa:Action 2818 </em> 2819 </span> 2820 </p> 2821 <p>For this message should always be: 2822 2823 <span class="emphasis"> 2824 <em>http://docs.oasis-open.org/wsn/bw-2/ 2825 SubscriptionManager/UnsubscribeResponse. 2826 <span class="emphasis"> 2827 <em>If differ, a 2828 fault will be returned. 2829 </em> 2830 </span> 2831 </em> 2832 </span> 2833 </p> 2834 </li> 2835 </ul> 2836 </div> 2837 </div> 2838 <div class="sect3" title="RegisterPublisherRequest"> 2839 <div class="titlepage"> 2840 <div> 2841 <div> 2842 <h4 class="title"> 2843 <a id="idp322000"/>RegisterPublisherRequest 2844 </h4> 2845 </div> 2846 </div> 2847 </div> 2848 <p>In order to sending Notifications, a Publisher can be obligated 2849 to register himself previously in 2850 <span class="emphasis"> 2851 <em>QCG 2852 Notification 2853 </em> 2854 </span>. For this purpose, it sends the 2855 RegisterPublisherRequest message to 2856 <span class="emphasis"> 2857 <em>QCG 2858 Notification 2859 </em> 2860 </span>. 2861 </p> 2862 <pre class="programlisting"><SOAP-ENV:Envelope ... > 877 2863 <SOAP-ENV:Header> 878 2864 <wsa:Action SOAP-ENV:mustUnderstand="1"> 879 <span class="bold"><strong>http://docs.oasis-open.org/wsn/brw-2/ 880 RegisterPublisher/RegisterPublisherRequest</strong></span> 2865 2866 <span class="bold"> 2867 <strong>http://docs.oasis-open.org/wsn/brw-2/ 2868 RegisterPublisher/RegisterPublisherRequest 2869 </strong> 2870 </span> 881 2871 </wsa:Action> 882 2872 ... … … 885 2875 <wsnbr:RegisterPublisher> 886 2876 <wsnbr:Demand> 887 <span class="bold"><strong>false</strong></span> 2877 2878 <span class="bold"> 2879 <strong>false 2880 </strong> 2881 </span> 888 2882 </wsnbr:Demand> 889 2883 <wsnbr:InitialTerminationTime> 890 <span class="bold"><strong>2007-07-23T10:24:14+02:00</strong></span> 2884 2885 <span class="bold"> 2886 <strong>2007-07-23T10:24:14+02:00 2887 </strong> 2888 </span> 891 2889 </wsnbr:InitialTerminationTime> 892 2890 </wsnbr:RegisterPublisher> 893 2891 </SOAP-ENV:Body> 894 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 895 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 896 RegisterPublisher/RegisterPublisherRequest. <span class="emphasis"><em>If differ, a 897 fault will be returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnbr:RegisterPublisher/wsnbr:Demand</em></span></p><p>Determine a demand-based pattern. At this time this pattern 898 isn't supported so default <span class="emphasis"><em>false</em></span> is the sole 899 accepted value.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnbr:RegisterPublisher/wsnbr:InitialTerminationTime</em></span></p><p>An optional element. If present, must contain the requester 2892 </SOAP-ENV:Envelope> 2893 </pre> 2894 <div class="itemizedlist"> 2895 <ul class="itemizedlist"> 2896 <li class="listitem"> 2897 <p> 2898 <span class="emphasis"> 2899 <em>//SOAP-ENV:Header/wsa:Action 2900 </em> 2901 </span> 2902 </p> 2903 <p>For this message should always be: 2904 2905 <span class="emphasis"> 2906 <em>http://docs.oasis-open.org/wsn/brw-2/ 2907 RegisterPublisher/RegisterPublisherRequest. 2908 <span class="emphasis"> 2909 <em>If differ, a 2910 fault will be returned. 2911 </em> 2912 </span> 2913 </em> 2914 </span> 2915 </p> 2916 </li> 2917 <li class="listitem"> 2918 <p> 2919 <span class="emphasis"> 2920 <em>//wsnbr:RegisterPublisher/wsnbr:Demand 2921 </em> 2922 </span> 2923 </p> 2924 <p>Determine a demand-based pattern. At this time this pattern 2925 isn't supported so default 2926 <span class="emphasis"> 2927 <em>false 2928 </em> 2929 </span> is the sole 2930 accepted value. 2931 </p> 2932 </li> 2933 <li class="listitem"> 2934 <p> 2935 <span class="emphasis"> 2936 <em>//wsnbr:RegisterPublisher/wsnbr:InitialTerminationTime 2937 </em> 2938 </span> 2939 </p> 2940 <p>An optional element. If present, must contain the requester 900 2941 suggestion for the termination time of the Registration being 901 2942 created (expressed as a local time with timezone). If not present, 902 the termination time is determined automatically - <span class="emphasis"><em>QCG 903 Notification <span class="emphasis"><em>specify the default time 904 period</em></span></em></span> for the Registration to be valid. 905 Every Notify message renews the termination time.</p></li></ul></div></div><div class="sect3" title="RegisterPublisherResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp331408"/>RegisterPublisherResponse</h4></div></div></div><p>In a response to a successful registration process, 906 <span class="emphasis"><em>QCG Notification</em></span> sends RegisterPublisherResponse. 2943 the termination time is determined automatically - 2944 <span class="emphasis"> 2945 <em>QCG 2946 Notification 2947 <span class="emphasis"> 2948 <em>specify the default time 2949 period 2950 </em> 2951 </span> 2952 </em> 2953 </span> for the Registration to be valid. 2954 Every Notify message renews the termination time. 2955 </p> 2956 </li> 2957 </ul> 2958 </div> 2959 </div> 2960 <div class="sect3" title="RegisterPublisherResponse"> 2961 <div class="titlepage"> 2962 <div> 2963 <div> 2964 <h4 class="title"> 2965 <a id="idp334944"/>RegisterPublisherResponse 2966 </h4> 2967 </div> 2968 </div> 2969 </div> 2970 <p>In a response to a successful registration process, 2971 2972 <span class="emphasis"> 2973 <em>QCG Notification 2974 </em> 2975 </span> sends RegisterPublisherResponse. 907 2976 This message contains a reference to the created Registration. The 908 attached ID is necessary to send any Notification message.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 2977 attached ID is necessary to send any Notification message. 2978 </p> 2979 <pre class="programlisting"><SOAP-ENV:Envelope ... > 909 2980 <SOAP-ENV:Header> 910 2981 <wsa:Action SOAP-ENV:mustUnderstand="1"> 911 <span class="bold"><strong>http://docs.oasis-open.org/wsn/brw-2/ 912 RegisterPublisher/RegisterPublisherResponse</strong></span> 2982 2983 <span class="bold"> 2984 <strong>http://docs.oasis-open.org/wsn/brw-2/ 2985 RegisterPublisher/RegisterPublisherResponse 2986 </strong> 2987 </span> 913 2988 </wsa:Action> 914 2989 </SOAP-ENV:Header> … … 917 2992 <wsnbr:PublisherRegistrationReference> 918 2993 <wsa:Address> 919 <span class="bold"><strong>http://some.address</strong></span> 2994 2995 <span class="bold"> 2996 <strong>http://some.address 2997 </strong> 2998 </span> 920 2999 </wsa:Address> 921 3000 <wsa:ReferenceParameters> 922 <span class="bold"><strong><RegisterPublisherID 3001 3002 <span class="bold"> 3003 <strong><RegisterPublisherID 923 3004 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions"> 924 3005 1207382668 925 </RegisterPublisherID></strong></span> 3006 </RegisterPublisherID> 3007 </strong> 3008 </span> 926 3009 </wsa:ReferenceParameters> 927 3010 </wsnbr:PublisherRegistrationReference> 928 3011 </wsnbr:RegisterPublisherResponse> 929 3012 </SOAP-ENV:Body> 930 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 931 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/RegisterPublisher/RegisterPublisherResponse. 932 <span class="emphasis"><em>If differ, a fault will be 933 returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:Address</em></span></p><p>An address of a PublisherRegistration Manager interface. In 934 the current solution it is the <span class="emphasis"><em>QCG 935 Notification</em></span> service address.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:ReferenceParameters/RegisterPublisherID</em></span></p><p>An extensive element in xsd:any that contains a Publisher 3013 </SOAP-ENV:Envelope> 3014 </pre> 3015 <div class="itemizedlist"> 3016 <ul class="itemizedlist"> 3017 <li class="listitem"> 3018 <p> 3019 <span class="emphasis"> 3020 <em>//SOAP-ENV:Header/wsa:Action 3021 </em> 3022 </span> 3023 </p> 3024 <p>For this message should always be: 3025 3026 <span class="emphasis"> 3027 <em>http://docs.oasis-open.org/wsn/brw-2/RegisterPublisher/RegisterPublisherResponse. 3028 3029 <span class="emphasis"> 3030 <em>If differ, a fault will be 3031 returned. 3032 </em> 3033 </span> 3034 </em> 3035 </span> 3036 </p> 3037 </li> 3038 <li class="listitem"> 3039 <p> 3040 <span class="emphasis"> 3041 <em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:Address 3042 </em> 3043 </span> 3044 </p> 3045 <p>An address of a PublisherRegistration Manager interface. In 3046 the current solution it is the 3047 <span class="emphasis"> 3048 <em>QCG 3049 Notification 3050 </em> 3051 </span> service address. 3052 </p> 3053 </li> 3054 <li class="listitem"> 3055 <p> 3056 <span class="emphasis"> 3057 <em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:ReferenceParameters/RegisterPublisherID 3058 </em> 3059 </span> 3060 </p> 3061 <p>An extensive element in xsd:any that contains a Publisher 936 3062 Registration ID. It defines a session that is created after 937 3063 registration and removed by sending the DestroyRegistration 938 message. At this time it is at most 32 char long string.</p></li></ul></div></div><div class="sect3" title="Notify"><div class="titlepage"><div><div><h4 class="title"><a id="idp343184"/>Notify</h4></div></div></div><p>Notify consists of one or many NotificationMessages. Any of them 3064 message. At this time it is at most 32 char long string. 3065 </p> 3066 </li> 3067 </ul> 3068 </div> 3069 </div> 3070 <div class="sect3" title="Notify"> 3071 <div class="titlepage"> 3072 <div> 3073 <div> 3074 <h4 class="title"> 3075 <a id="idp346800"/>Notify 3076 </h4> 3077 </div> 3078 </div> 3079 </div> 3080 <p>Notify consists of one or many NotificationMessages. Any of them 939 3081 is a separate Notification message and is processed independently. 940 3082 NotificationMessage should define a single Topic it concerns. 941 3083 TopicExpression should be written in the same Dialect that the 942 3084 Subscription was created in. The Publisher Registration ID has to be 943 attached to Notify messages.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3085 attached to Notify messages. 3086 </p> 3087 <pre class="programlisting"><SOAP-ENV:Envelope ... > 944 3088 <SOAP-ENV:Header> 945 3089 <wsa:Action SOAP-ENV:mustUnderstand="1"> 946 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 947 NotificationConsumer/Notify</strong></span> 3090 3091 <span class="bold"> 3092 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3093 NotificationConsumer/Notify 3094 </strong> 3095 </span> 948 3096 </wsa:Action> 949 3097 </SOAP-ENV:Header> … … 952 3100 <wsnt:NotificationMessage> 953 3101 <wsnt:Topic 954 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span><span class="bold"><strong> 955 xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"> 956 tns:House/Kitchen/Light</strong></span> 3102 Dialect= 3103 <span class="bold"> 3104 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 3105 </strong> 3106 </span> 3107 <span class="bold"> 3108 <strong> 3109 xmlns:tns=" 3110 <span class="bold"> 3111 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 3112 </strong> 3113 </span>"> 3114 tns:House/Kitchen/Light 3115 </strong> 3116 </span> 957 3117 </wsnt:Topic> 958 3118 <wsnt:ProducerReference> 959 3119 <wsa:Address> 960 <span class="bold"><strong>http://some.address 961 </strong></span><wsa:Address> 3120 3121 <span class="bold"> 3122 <strong>http://some.address 3123 3124 </strong> 3125 </span><wsa:Address> 962 3126 <wsnt:ProducerReference> 963 3127 <wsnt:Message> 964 <span class="bold"><strong><smnex:State 3128 3129 <span class="bold"> 3130 <strong><smnex:State 965 3131 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 966 3132 on 967 </smnex:State></strong></span> 3133 </smnex:State> 3134 </strong> 3135 </span> 968 3136 </wsnt:Message> 969 3137 </wsnt:NotificationMessage> 970 3138 <smn-ext:RegisterPublisherID> 971 <span class="bold"><strong>1207382668</strong></span> 3139 3140 <span class="bold"> 3141 <strong>1207382668 3142 </strong> 3143 </span> 972 3144 </smn-ext:RegisterPublisherID> 973 3145 </wsnt:Notify> 974 3146 </SOAP-ENV:Body> 975 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 976 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer/Notify. 977 <span class="emphasis"><em>If differ, a fault will be 978 returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>A set of Notification 979 messages.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage</em></span></p><p>A single Notification message.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic</em></span></p><p>The content of this element is an expression that defines 3147 </SOAP-ENV:Envelope> 3148 </pre> 3149 <div class="itemizedlist"> 3150 <ul class="itemizedlist"> 3151 <li class="listitem"> 3152 <p> 3153 <span class="emphasis"> 3154 <em>//SOAP-ENV:Header/wsa:Action 3155 </em> 3156 </span> 3157 </p> 3158 <p>For this message should always be: 3159 3160 <span class="emphasis"> 3161 <em>http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer/Notify. 3162 3163 <span class="emphasis"> 3164 <em>If differ, a fault will be 3165 returned. 3166 </em> 3167 </span> 3168 </em> 3169 </span> 3170 </p> 3171 </li> 3172 <li class="listitem"> 3173 <p> 3174 <span class="emphasis"> 3175 <em>//wsnt:Notify 3176 </em> 3177 </span> 3178 </p> 3179 <p> 3180 <span class="emphasis"> 3181 <em> 3182 <span class="emphasis"> 3183 <em>A set of Notification 3184 messages. 3185 </em> 3186 </span> 3187 </em> 3188 </span> 3189 </p> 3190 </li> 3191 <li class="listitem"> 3192 <p> 3193 <span class="emphasis"> 3194 <em>//wsnt:Notify/wsnt:NotificationMessage 3195 </em> 3196 </span> 3197 </p> 3198 <p>A single Notification message. 3199 </p> 3200 </li> 3201 <li class="listitem"> 3202 <p> 3203 <span class="emphasis"> 3204 <em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic 3205 </em> 3206 </span> 3207 </p> 3208 <p>The content of this element is an expression that defines 980 3209 exactly one Topic in a specified Dialect type. The Topic should be 981 3210 supported. The Topic may be defined in two ways: (1) using … … 983 3212 is defined in a Topic element and assigned to some prefix (e.g. 984 3213 tns) or (2) using inline form (e.g. 985 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light).</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic/@Dialect</em></span></p><p>URI that specifies TopicExpression Dialect type. Allowed 3214 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light). 3215 </p> 3216 </li> 3217 <li class="listitem"> 3218 <p> 3219 <span class="emphasis"> 3220 <em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic/@Dialect 3221 </em> 3222 </span> 3223 </p> 3224 <p>URI that specifies TopicExpression Dialect type. Allowed 986 3225 Dialect types are as follows: 987 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 3226 3227 <span class="emphasis"> 3228 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 988 3229 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 989 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full".</em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address</em></span></p><p>A Notification producer (Publisher) address.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Message</em></span></p><p>A Notify message content. Currently supported are messages 990 shorter than 4096 bytes.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:Notify/smn-ext:RegisterPublisherID</em></span></p><p>A Publisher Registration ID that was received in the 991 RegisterPublisherResponse message.</p></li></ul></div></div><div class="sect3" title="DestroyRegistrationRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp365152"/>DestroyRegistrationRequest</h4></div></div></div><p>A Publisher can terminate a Registration by sending the 992 DestroyRegistrationRequest message to <span class="emphasis"><em>QCG 993 Notification</em></span>. The parameter attached to this request is a 994 Publisher Registration ID.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3230 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full". 3231 </em> 3232 </span> 3233 </p> 3234 </li> 3235 <li class="listitem"> 3236 <p> 3237 <span class="emphasis"> 3238 <em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address 3239 </em> 3240 </span> 3241 </p> 3242 <p>A Notification producer (Publisher) address. 3243 </p> 3244 </li> 3245 <li class="listitem"> 3246 <p> 3247 <span class="emphasis"> 3248 <em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Message 3249 </em> 3250 </span> 3251 </p> 3252 <p>A Notify message content. Currently supported are messages 3253 shorter than 4096 bytes. 3254 </p> 3255 </li> 3256 <li class="listitem"> 3257 <p> 3258 <span class="emphasis"> 3259 <em>//wsnt:Notify/smn-ext:RegisterPublisherID 3260 </em> 3261 </span> 3262 </p> 3263 <p>A Publisher Registration ID that was received in the 3264 RegisterPublisherResponse message. 3265 </p> 3266 </li> 3267 </ul> 3268 </div> 3269 </div> 3270 <div class="sect3" title="DestroyRegistrationRequest"> 3271 <div class="titlepage"> 3272 <div> 3273 <div> 3274 <h4 class="title"> 3275 <a id="idp369712"/>DestroyRegistrationRequest 3276 </h4> 3277 </div> 3278 </div> 3279 </div> 3280 <p>A Publisher can terminate a Registration by sending the 3281 DestroyRegistrationRequest message to 3282 <span class="emphasis"> 3283 <em>QCG 3284 Notification 3285 </em> 3286 </span>. The parameter attached to this request is a 3287 Publisher Registration ID. 3288 </p> 3289 <pre class="programlisting"><SOAP-ENV:Envelope ... > 995 3290 <SOAP-ENV:Header> 996 3291 <wsa:Action SOAP-ENV:mustUnderstand="1"> 997 <span class="bold"><strong>http://docs.oasis-open-org/wsn/brw-2/ 998 PublisherRegistrationManager/DestroyRegistrationRequest</strong></span> 3292 3293 <span class="bold"> 3294 <strong>http://docs.oasis-open-org/wsn/brw-2/ 3295 PublisherRegistrationManager/DestroyRegistrationRequest 3296 </strong> 3297 </span> 999 3298 </wsa:Action> 1000 3299 </SOAP-ENV:Header> … … 1002 3301 <wsnbr:DestroyRegistration> 1003 3302 <smn-ext:RegisterPublisherID> 1004 <span class="bold"><strong>387837036</strong></span> 3303 3304 <span class="bold"> 3305 <strong>387837036 3306 </strong> 3307 </span> 1005 3308 </smn-ext:RegisterPublisherID> 1006 3309 </wsnbr:DestroyRegistration> 1007 3310 </SOAP-ENV:Body> 1008 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1009 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 3311 </SOAP-ENV:Envelope> 3312 </pre> 3313 <div class="itemizedlist"> 3314 <ul class="itemizedlist"> 3315 <li class="listitem"> 3316 <p> 3317 <span class="emphasis"> 3318 <em>//SOAP-ENV:Header/wsa:Action 3319 </em> 3320 </span> 3321 </p> 3322 <p>For this message should always be: 3323 3324 <span class="emphasis"> 3325 <em>http://docs.oasis-open.org/wsn/brw-2/ 1010 3326 PublisherRegistrationManager/DestroyRegistrationRequest. 1011 <span class="emphasis"><em>If differ, a fault will be 1012 returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnbr:DestroyRegistration/smn-ext:RegisterPublisherID</em></span></p><p>A Publisher Registration ID that was received in a 1013 RegisterPublisherResponse message.</p></li></ul></div></div><div class="sect3" title="DestroyRegistrationResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp373904"/>DestroyRegistrationResponse</h4></div></div></div><p>DestroyRegistrationResponse is returned to a Publisher after a 3327 3328 <span class="emphasis"> 3329 <em>If differ, a fault will be 3330 returned. 3331 </em> 3332 </span> 3333 </em> 3334 </span> 3335 </p> 3336 </li> 3337 <li class="listitem"> 3338 <p> 3339 <span class="emphasis"> 3340 <em>//wsnbr:DestroyRegistration/smn-ext:RegisterPublisherID 3341 </em> 3342 </span> 3343 </p> 3344 <p>A Publisher Registration ID that was received in a 3345 RegisterPublisherResponse message. 3346 </p> 3347 </li> 3348 </ul> 3349 </div> 3350 </div> 3351 <div class="sect3" title="DestroyRegistrationResponse"> 3352 <div class="titlepage"> 3353 <div> 3354 <div> 3355 <h4 class="title"> 3356 <a id="idp378544"/>DestroyRegistrationResponse 3357 </h4> 3358 </div> 3359 </div> 3360 </div> 3361 <p>DestroyRegistrationResponse is returned to a Publisher after a 1014 3362 successful process of destroying a Publisher Registration, in a 1015 response to the DestroyRegistration message.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3363 response to the DestroyRegistration message. 3364 </p> 3365 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1016 3366 <SOAP-ENV:Header> 1017 3367 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1018 <span class="bold"><strong>http://docs.oasis-open-org/wsn/brw-2/ 1019 PublisherRegistrationManager/DestroyRegistrationResponse</strong></span> 3368 3369 <span class="bold"> 3370 <strong>http://docs.oasis-open-org/wsn/brw-2/ 3371 PublisherRegistrationManager/DestroyRegistrationResponse 3372 </strong> 3373 </span> 1020 3374 </wsa:Action> 1021 3375 </SOAP-ENV:Header> … … 1024 3378 </wsn-br:DestroyRegistrationResponse> 1025 3379 </SOAP-ENV:Body> 1026 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1027 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 3380 </SOAP-ENV:Envelope> 3381 </pre> 3382 <div class="itemizedlist"> 3383 <ul class="itemizedlist"> 3384 <li class="listitem"> 3385 <p> 3386 <span class="emphasis"> 3387 <em>//SOAP-ENV:Header/wsa:Action 3388 </em> 3389 </span> 3390 </p> 3391 <p>For this message should always be: 3392 3393 <span class="emphasis"> 3394 <em>http://docs.oasis-open.org/wsn/brw-2/ 1028 3395 PublisherRegistrationManager/DestroyRegistrationResponse. 1029 <span class="emphasis"><em>If differ, a fault will be 1030 returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="CreatePullPointRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp380096"/>CreatePullPointRequest</h4></div></div></div><p>In scenarios where the pull-style of notifications delivery is 3396 3397 <span class="emphasis"> 3398 <em>If differ, a fault will be 3399 returned. 3400 </em> 3401 </span> 3402 </em> 3403 </span> 3404 </p> 3405 </li> 3406 </ul> 3407 </div> 3408 </div> 3409 <div class="sect3" title="CreatePullPointRequest"> 3410 <div class="titlepage"> 3411 <div> 3412 <div> 3413 <h4 class="title"> 3414 <a id="idp384736"/>CreatePullPointRequest 3415 </h4> 3416 </div> 3417 </div> 3418 </div> 3419 <p>In scenarios where the pull-style of notifications delivery is 1031 3420 needed, Subscribers can create PullPoints. To do this, a Subscriber 1032 sends the CreatePullPointRequest message to <span class="emphasis"><em>QCG Notification 1033 PullPoint</em></span>.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3421 sends the CreatePullPointRequest message to 3422 <span class="emphasis"> 3423 <em>QCG Notification 3424 PullPoint 3425 </em> 3426 </span>. 3427 </p> 3428 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1034 3429 <SOAP-ENV:Header> 1035 3430 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1036 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1037 CreatePullPoint/CreatePullPointRequest</strong></span> 3431 3432 <span class="bold"> 3433 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3434 CreatePullPoint/CreatePullPointRequest 3435 </strong> 3436 </span> 1038 3437 </wsa:Action> 1039 3438 ... … … 1043 3442 </wsnt:CreatePullPoint> 1044 3443 </SOAP-ENV:Body> 1045 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1046 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointRequest. 1047 <span class="emphasis"><em>If differ, a fault will be 1048 returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="CreatePullPointResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp384240"/>CreatePullPointResponse</h4></div></div></div><p>The CreatePullPointResponse message is returned in a response to 3444 </SOAP-ENV:Envelope> 3445 </pre> 3446 <div class="itemizedlist"> 3447 <ul class="itemizedlist"> 3448 <li class="listitem"> 3449 <p> 3450 <span class="emphasis"> 3451 <em>//SOAP-ENV:Header/wsa:Action 3452 </em> 3453 </span> 3454 </p> 3455 <p>For this message should always be: 3456 3457 <span class="emphasis"> 3458 <em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointRequest. 3459 3460 <span class="emphasis"> 3461 <em>If differ, a fault will be 3462 returned. 3463 </em> 3464 </span> 3465 </em> 3466 </span> 3467 </p> 3468 </li> 3469 </ul> 3470 </div> 3471 </div> 3472 <div class="sect3" title="CreatePullPointResponse"> 3473 <div class="titlepage"> 3474 <div> 3475 <div> 3476 <h4 class="title"> 3477 <a id="idp388368"/>CreatePullPointResponse 3478 </h4> 3479 </div> 3480 </div> 3481 </div> 3482 <p>The CreatePullPointResponse message is returned in a response to 1049 3483 the request of PullPoint creation. This message contains a reference 1050 to the just created PullPoint. </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3484 to the just created PullPoint. 3485 </p> 3486 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1051 3487 <SOAP-ENV:Header> 1052 3488 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1053 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1054 CreatePullPoint/CreatePullPointResponse</strong></span> 3489 3490 <span class="bold"> 3491 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3492 CreatePullPoint/CreatePullPointResponse 3493 </strong> 3494 </span> 1055 3495 </wsa:Action> 1056 3496 ... … … 1059 3499 <wsnt:CreatePullPointResponse> 1060 3500 <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing"> 1061 <span class="bold"><strong> http://some.address:2211?ppID=1100992448</strong></span> 3501 3502 <span class="bold"> 3503 <strong> http://some.address:2211?ppID=1100992448 3504 </strong> 3505 </span> 1062 3506 </wsa:Address> 1063 3507 </wsnt:CreatePullPointResponse> 1064 3508 </SOAP-ENV:Body> 1065 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1066 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointResponse. 1067 <span class="emphasis"><em>If differ, a fault will be 1068 returned.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:CreatePullPointResponse/wsa:Address</em></span></p><p>An logical address of the created PullPoint.</p></li></ul></div></div><div class="sect3" title="GetMessages"><div class="titlepage"><div><div><h4 class="title"><a id="idp394048"/>GetMessages</h4></div></div></div><p>A Pull-style NotificationConsumer can get messages buffered in a 3509 </SOAP-ENV:Envelope> 3510 </pre> 3511 <div class="itemizedlist"> 3512 <ul class="itemizedlist"> 3513 <li class="listitem"> 3514 <p> 3515 <span class="emphasis"> 3516 <em>//SOAP-ENV:Header/wsa:Action 3517 </em> 3518 </span> 3519 </p> 3520 <p>For this message should always be: 3521 3522 <span class="emphasis"> 3523 <em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointResponse. 3524 3525 <span class="emphasis"> 3526 <em>If differ, a fault will be 3527 returned. 3528 </em> 3529 </span> 3530 </em> 3531 </span> 3532 </p> 3533 </li> 3534 <li class="listitem"> 3535 <p> 3536 <span class="emphasis"> 3537 <em>//wsnt:CreatePullPointResponse/wsa:Address 3538 </em> 3539 </span> 3540 </p> 3541 <p>An logical address of the created PullPoint. 3542 </p> 3543 </li> 3544 </ul> 3545 </div> 3546 </div> 3547 <div class="sect3" title="GetMessages"> 3548 <div class="titlepage"> 3549 <div> 3550 <div> 3551 <h4 class="title"> 3552 <a id="idp398704"/>GetMessages 3553 </h4> 3554 </div> 3555 </div> 3556 </div> 3557 <p>A Pull-style NotificationConsumer can get messages buffered in a 1069 3558 PullPoint by invoking the GetMessages method. It sends the 1070 3559 GetMessagesRequest message directly to the specified PullPoint. The 1071 3560 message can contain a specification of a maximal number of 1072 3561 Notification messages that NotificationConsumer wants to receive in 1073 the response.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3562 the response. 3563 </p> 3564 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1074 3565 <SOAP-ENV:Header> 1075 3566 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1076 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1077 PullPoint/GetMessagesRequest</strong></span> 3567 3568 <span class="bold"> 3569 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3570 PullPoint/GetMessagesRequest 3571 </strong> 3572 </span> 1078 3573 </wsa:Action> 1079 3574 ... … … 1081 3576 <SOAP-ENV:Body> 1082 3577 <wsnt:GetMessages> 1083 <wsnt:MaximumNumber><span class="bold"><strong>10</strong></span></wsnt:MaximumNumber> 3578 <wsnt:MaximumNumber> 3579 <span class="bold"> 3580 <strong>10 3581 </strong> 3582 </span></wsnt:MaximumNumber> 1084 3583 </wsnt:GetMessages> 1085 3584 </SOAP-ENV:Body> 1086 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1087 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesRequest. 1088 <span class="emphasis"><em>If differ, a fault will be 1089 returned.</em></span></em></span></p></li></ul></div><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessages/wsnt:MaximumNumber</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>An optional element. It defines a 3585 </SOAP-ENV:Envelope> 3586 </pre> 3587 <div class="itemizedlist"> 3588 <ul class="itemizedlist"> 3589 <li class="listitem"> 3590 <p> 3591 <span class="emphasis"> 3592 <em>//SOAP-ENV:Header/wsa:Action 3593 </em> 3594 </span> 3595 </p> 3596 <p>For this message should always be: 3597 3598 <span class="emphasis"> 3599 <em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesRequest. 3600 3601 <span class="emphasis"> 3602 <em>If differ, a fault will be 3603 returned. 3604 </em> 3605 </span> 3606 </em> 3607 </span> 3608 </p> 3609 </li> 3610 </ul> 3611 </div> 3612 <div class="itemizedlist"> 3613 <ul class="itemizedlist"> 3614 <li class="listitem"> 3615 <p> 3616 <span class="emphasis"> 3617 <em>//wsnt:GetMessages/wsnt:MaximumNumber 3618 </em> 3619 </span> 3620 </p> 3621 <p> 3622 <span class="emphasis"> 3623 <em> 3624 <span class="emphasis"> 3625 <em>An optional element. It defines a 1090 3626 maximal number of messages that will be gotten from the 1091 PullPoint.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="GetMessagesResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp403232"/>GetMessagesResponse</h4></div></div></div><p>GetMessagesResponse, a response message to GetMessages, consists 3627 PullPoint. 3628 </em> 3629 </span> 3630 </em> 3631 </span> 3632 </p> 3633 </li> 3634 </ul> 3635 </div> 3636 </div> 3637 <div class="sect3" title="GetMessagesResponse"> 3638 <div class="titlepage"> 3639 <div> 3640 <div> 3641 <h4 class="title"> 3642 <a id="idp406464"/>GetMessagesResponse 3643 </h4> 3644 </div> 3645 </div> 3646 </div> 3647 <p>GetMessagesResponse, a response message to GetMessages, consists 1092 3648 of a set of Notifications received from the PullPoint. 1093 </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3649 3650 </p> 3651 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1094 3652 <SOAP-ENV:Header> 1095 3653 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1096 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1097 PullPoint/GetMessagesResponse</strong></span> 3654 3655 <span class="bold"> 3656 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3657 PullPoint/GetMessagesResponse 3658 </strong> 3659 </span> 1098 3660 </wsa:Action> 1099 3661 ... … … 1103 3665 <wsnt:NotificationMessage> 1104 3666 <wsnt:Topic 1105 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1106 <span class="bold"><strong>xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"</strong></span>> 1107 <span class="bold"><strong>tns:House/Kitchen/Light</strong></span> 3667 Dialect= 3668 <span class="bold"> 3669 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 3670 </strong> 3671 </span>> 3672 3673 <span class="bold"> 3674 <strong>xmlns:tns=" 3675 <span class="bold"> 3676 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 3677 </strong> 3678 </span>" 3679 </strong> 3680 </span>> 3681 3682 <span class="bold"> 3683 <strong>tns:House/Kitchen/Light 3684 </strong> 3685 </span> 1108 3686 </wsnt:Topic> 1109 3687 <wsnt:ProducerReference> 1110 3688 <wsa:Address> 1111 <span class="bold"><strong>http://some.address 1112 </strong></span><wsa:Address> 3689 3690 <span class="bold"> 3691 <strong>http://some.address 3692 3693 </strong> 3694 </span><wsa:Address> 1113 3695 <wsnt:ProducerReference> 1114 3696 <wsnt:Message> 1115 <span class="bold"><strong><span class="bold"><strong><smnex:State 3697 3698 <span class="bold"> 3699 <strong> 3700 <span class="bold"> 3701 <strong><smnex:State 1116 3702 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 1117 3703 on 1118 </smnex:State></strong></span></strong></span> 3704 </smnex:State> 3705 </strong> 3706 </span> 3707 </strong> 3708 </span> 1119 3709 </wsnt:Message> 1120 3710 </wsnt:NotificationMessage> … … 1125 3715 </wsnt:GetMessagesResponse> 1126 3716 </SOAP-ENV:Body> 1127 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1128 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesResponse. 1129 <span class="emphasis"><em>If differ, a fault will be 1130 returned.</em></span></em></span></p></li><li class="listitem"><p>//wsnt:GetMessagesResponse</p><p>A set of Notification messages. The number of messages is 3717 </SOAP-ENV:Envelope> 3718 </pre> 3719 <div class="itemizedlist"> 3720 <ul class="itemizedlist"> 3721 <li class="listitem"> 3722 <p> 3723 <span class="emphasis"> 3724 <em>//SOAP-ENV:Header/wsa:Action 3725 </em> 3726 </span> 3727 </p> 3728 <p>For this message should always be: 3729 3730 <span class="emphasis"> 3731 <em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesResponse. 3732 3733 <span class="emphasis"> 3734 <em>If differ, a fault will be 3735 returned. 3736 </em> 3737 </span> 3738 </em> 3739 </span> 3740 </p> 3741 </li> 3742 <li class="listitem"> 3743 <p>//wsnt:GetMessagesResponse 3744 </p> 3745 <p>A set of Notification messages. The number of messages is 1131 3746 restricted by the wsnt:MaximumNumber parameter defined in the 1132 GetMessagesRequest message.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage</em></span></p><p>A single Notification message.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic</em></span></p><p>The content of this element is an expression that defines 3747 GetMessagesRequest message. 3748 </p> 3749 </li> 3750 <li class="listitem"> 3751 <p> 3752 <span class="emphasis"> 3753 <em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage 3754 </em> 3755 </span> 3756 </p> 3757 <p>A single Notification message. 3758 </p> 3759 </li> 3760 <li class="listitem"> 3761 <p> 3762 <span class="emphasis"> 3763 <em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic 3764 </em> 3765 </span> 3766 </p> 3767 <p>The content of this element is an expression that defines 1133 3768 exactly one Topic in a specified Dialect type. The Topic should 1134 be supported.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic/@Dialect</em></span></p><p>URI that specifies a TopicExpression Dialect type. Allowed 3769 be supported. 3770 </p> 3771 </li> 3772 <li class="listitem"> 3773 <p> 3774 <span class="emphasis"> 3775 <em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic/@Dialect 3776 </em> 3777 </span> 3778 </p> 3779 <p>URI that specifies a TopicExpression Dialect type. Allowed 1135 3780 Dialect types are as follows: 1136 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 3781 3782 <span class="emphasis"> 3783 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1137 3784 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 1138 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full".</em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address</em></span></p><p>A Notification producer (Publisher) address.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Message</em></span></p><p>A Notify message content. Currently supported are messages 1139 shorter than 4096 bytes.</p></li></ul></div></div><div class="sect3" title="DestroyPullPointRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp422992"/>DestroyPullPointRequest</h4></div></div></div><p>A PullPoint can be destroyed by invoking a DestroyPullPoint 3785 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full". 3786 </em> 3787 </span> 3788 </p> 3789 </li> 3790 <li class="listitem"> 3791 <p> 3792 <span class="emphasis"> 3793 <em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address 3794 </em> 3795 </span> 3796 </p> 3797 <p>A Notification producer (Publisher) address. 3798 </p> 3799 </li> 3800 <li class="listitem"> 3801 <p> 3802 <span class="emphasis"> 3803 <em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Message 3804 </em> 3805 </span> 3806 </p> 3807 <p>A Notify message content. Currently supported are messages 3808 shorter than 4096 bytes. 3809 </p> 3810 </li> 3811 </ul> 3812 </div> 3813 </div> 3814 <div class="sect3" title="DestroyPullPointRequest"> 3815 <div class="titlepage"> 3816 <div> 3817 <div> 3818 <h4 class="title"> 3819 <a id="idp427648"/>DestroyPullPointRequest 3820 </h4> 3821 </div> 3822 </div> 3823 </div> 3824 <p>A PullPoint can be destroyed by invoking a DestroyPullPoint 1140 3825 method. An empty request message should be sent directly to the 1141 PullPoint.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3826 PullPoint. 3827 </p> 3828 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1142 3829 <SOAP-ENV:Header> 1143 3830 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1144 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1145 PullPoint/DestroyPullPointRequest</strong></span> 3831 3832 <span class="bold"> 3833 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3834 PullPoint/DestroyPullPointRequest 3835 </strong> 3836 </span> 1146 3837 </wsa:Action> 1147 3838 ... … … 1151 3842 </wsnt:DestroyPullPoint> 1152 3843 </SOAP-ENV:Body> 1153 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1154 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointRequest. 1155 <span class="emphasis"><em>If differ, a fault will be 1156 returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="DestroyPullPointResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp430000"/>DestroyPullPointResponse</h4></div></div></div><p>A response to a DestroyPullPointRequest message is an empty 1157 DestroyPullPointResponse message.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3844 </SOAP-ENV:Envelope> 3845 </pre> 3846 <div class="itemizedlist"> 3847 <ul class="itemizedlist"> 3848 <li class="listitem"> 3849 <p> 3850 <span class="emphasis"> 3851 <em>//SOAP-ENV:Header/wsa:Action 3852 </em> 3853 </span> 3854 </p> 3855 <p>For this message should always be: 3856 3857 <span class="emphasis"> 3858 <em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointRequest. 3859 3860 <span class="emphasis"> 3861 <em>If differ, a fault will be 3862 returned. 3863 </em> 3864 </span> 3865 </em> 3866 </span> 3867 </p> 3868 </li> 3869 </ul> 3870 </div> 3871 </div> 3872 <div class="sect3" title="DestroyPullPointResponse"> 3873 <div class="titlepage"> 3874 <div> 3875 <div> 3876 <h4 class="title"> 3877 <a id="idp433632"/>DestroyPullPointResponse 3878 </h4> 3879 </div> 3880 </div> 3881 </div> 3882 <p>A response to a DestroyPullPointRequest message is an empty 3883 DestroyPullPointResponse message. 3884 </p> 3885 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1158 3886 <SOAP-ENV:Header> 1159 3887 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1160 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1161 PullPoint/DestroyPullPointResponse</strong></span> 3888 3889 <span class="bold"> 3890 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3891 PullPoint/DestroyPullPointResponse 3892 </strong> 3893 </span> 1162 3894 </wsa:Action> 1163 3895 ... … … 1167 3899 </wsnt:DestroyPullPointResponse> 1168 3900 </SOAP-ENV:Body> 1169 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1170 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointResponse. 1171 <span class="emphasis"><em>If differ, a fault will be 1172 returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="GetCurrentMessageRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp435616"/>GetCurrentMessageRequest</h4></div></div></div><p>GetCurrentMessageRequest is useful especially when a new 3901 </SOAP-ENV:Envelope> 3902 </pre> 3903 <div class="itemizedlist"> 3904 <ul class="itemizedlist"> 3905 <li class="listitem"> 3906 <p> 3907 <span class="emphasis"> 3908 <em>//SOAP-ENV:Header/wsa:Action 3909 </em> 3910 </span> 3911 </p> 3912 <p>For this message should always be: 3913 3914 <span class="emphasis"> 3915 <em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointResponse. 3916 3917 <span class="emphasis"> 3918 <em>If differ, a fault will be 3919 returned. 3920 </em> 3921 </span> 3922 </em> 3923 </span> 3924 </p> 3925 </li> 3926 </ul> 3927 </div> 3928 </div> 3929 <div class="sect3" title="GetCurrentMessageRequest"> 3930 <div class="titlepage"> 3931 <div> 3932 <div> 3933 <h4 class="title"> 3934 <a id="idp440240"/>GetCurrentMessageRequest 3935 </h4> 3936 </div> 3937 </div> 3938 </div> 3939 <p>GetCurrentMessageRequest is useful especially when a new 1173 3940 NotificationConsumer is connecting and want to get the last published 1174 3941 Notification Message on a specified Topic. Single GetCurrentMessage 1175 3942 should refer exactly one Topic and has to be expressed in a supported 1176 Dialect type.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3943 Dialect type. 3944 </p> 3945 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1177 3946 <SOAP-ENV:Header> 1178 3947 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1179 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1180 NotificationProducer/GetCurrentMessageRequest</strong></span> 3948 3949 <span class="bold"> 3950 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3951 NotificationProducer/GetCurrentMessageRequest 3952 </strong> 3953 </span> 1181 3954 </wsa:Action> 1182 3955 </SOAP-ENV:Header> … … 1184 3957 <wsnt:GetCurrentMessage> 1185 3958 <wsnt:Topic 1186 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1187 <span class="bold"><strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span>> 1188 <span class="bold"><strong>tns:</strong></span><span class="bold"><strong>House/Kitchen/Light</strong></span> 3959 Dialect= 3960 <span class="bold"> 3961 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 3962 </strong> 3963 </span>> 3964 3965 <span class="bold"> 3966 <strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics" 3967 </strong> 3968 </span>> 3969 3970 <span class="bold"> 3971 <strong>tns: 3972 </strong> 3973 </span> 3974 <span class="bold"> 3975 <strong>House/Kitchen/Light 3976 </strong> 3977 </span> 1189 3978 </wsnt:Topic> 1190 3979 </wsnt:GetCurrentMessage> 1191 3980 </SOAP-ENV:Body> 1192 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1193 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1194 NotificationProducer/GetCurrentMessageRequest. <span class="emphasis"><em>If 1195 differ, a fault will be returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessage/wsnt:Topic</em></span></p><p>The content of this element is an expression that defines 3981 </SOAP-ENV:Envelope> 3982 </pre> 3983 <div class="itemizedlist"> 3984 <ul class="itemizedlist"> 3985 <li class="listitem"> 3986 <p> 3987 <span class="emphasis"> 3988 <em>//SOAP-ENV:Header/wsa:Action 3989 </em> 3990 </span> 3991 </p> 3992 <p>For this message should always be: 3993 3994 <span class="emphasis"> 3995 <em>http://docs.oasis-open.org/wsn/bw-2/ 3996 NotificationProducer/GetCurrentMessageRequest. 3997 <span class="emphasis"> 3998 <em>If 3999 differ, a fault will be returned 4000 </em> 4001 </span> 4002 </em> 4003 </span>. 4004 </p> 4005 </li> 4006 <li class="listitem"> 4007 <p> 4008 <span class="emphasis"> 4009 <em>//wsnt:GetCurrentMessage/wsnt:Topic 4010 </em> 4011 </span> 4012 </p> 4013 <p>The content of this element is an expression that defines 1196 4014 exactly one Topic in a specified Dialect type. The topic should be 1197 4015 supported. The Topic may be defined in two ways: (1) using … … 1199 4017 is defined in a Topic element and assigned to some prefix (e.g. 1200 4018 tns) or (2) using inline form (e.g. 1201 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessage/wsnt:Topic/@Dialect</em></span></p><p>URI that specifies TopicExpression Dialect's type. Allowed 4019 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light. 4020 </p> 4021 </li> 4022 <li class="listitem"> 4023 <p> 4024 <span class="emphasis"> 4025 <em>//wsnt:GetCurrentMessage/wsnt:Topic/@Dialect 4026 </em> 4027 </span> 4028 </p> 4029 <p>URI that specifies TopicExpression Dialect's type. Allowed 1202 4030 dialect's types are as follows: 1203 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 4031 4032 <span class="emphasis"> 4033 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1204 4034 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 1205 4035 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full". 1206 </em></span></p></li></ul></div></div><div class="sect3" title="GetCurrentMessageResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp448864"/>GetCurrentMessageResponse</h4></div></div></div><p>In a response to GetCurrentMessageRequest <span class="emphasis"><em>QCG 1207 Notification</em></span> prepares GetCurrentMessageResponse. This 4036 4037 </em> 4038 </span> 4039 </p> 4040 </li> 4041 </ul> 4042 </div> 4043 </div> 4044 <div class="sect3" title="GetCurrentMessageResponse"> 4045 <div class="titlepage"> 4046 <div> 4047 <div> 4048 <h4 class="title"> 4049 <a id="idp453424"/>GetCurrentMessageResponse 4050 </h4> 4051 </div> 4052 </div> 4053 </div> 4054 <p>In a response to GetCurrentMessageRequest 4055 <span class="emphasis"> 4056 <em>QCG 4057 Notification 4058 </em> 4059 </span> prepares GetCurrentMessageResponse. This 1208 4060 message includes the content of the last Notification 1209 GetCurrentMessageRequest refers to.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 4061 GetCurrentMessageRequest refers to. 4062 </p> 4063 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1210 4064 <SOAP-ENV:Header> 1211 4065 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1212 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1213 NotificationProducer/GetCurrentMessageResponse</strong></span> 4066 4067 <span class="bold"> 4068 <strong>http://docs.oasis-open.org/wsn/bw-2/ 4069 NotificationProducer/GetCurrentMessageResponse 4070 </strong> 4071 </span> 1214 4072 </wsa:Action> 1215 4073 </SOAP-ENV:Header> … … 1218 4076 <smn-ext:CurrentMessage> 1219 4077 <smn-ext:NotifyTime> 1220 <span class="bold"><strong>2007-07-23T10:43:14Z</strong></span> 4078 4079 <span class="bold"> 4080 <strong>2007-07-23T10:43:14Z 4081 </strong> 4082 </span> 1221 4083 </smn-ext:NotifyTime> 1222 4084 <wsnt:ProducerReference> 1223 4085 <wsa:Address> 1224 <span class="bold"><strong>http://some.address 1225 </strong></span><wsa:Address> 4086 4087 <span class="bold"> 4088 <strong>http://some.address 4089 4090 </strong> 4091 </span><wsa:Address> 1226 4092 <wsnt:ProducerReference> 1227 4093 <smn-ext:Message> 1228 <span class="bold"><strong><span class="bold"><strong><smnex:State 4094 4095 <span class="bold"> 4096 <strong> 4097 <span class="bold"> 4098 <strong><smnex:State 1229 4099 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 1230 4100 on 1231 </smnex:State></strong></span></strong></span> 4101 </smnex:State> 4102 </strong> 4103 </span> 4104 </strong> 4105 </span> 1232 4106 </smn-ext:Message> 1233 4107 </smn-ext:CurrentMessage> 1234 4108 </wsnt:GetCurrentMessageResponse> 1235 4109 </SOAP-ENV:Body> 1236 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1237 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1238 NotificationProducer/GetCurrentMessageResponse. <span class="emphasis"><em>If 1239 differ, a fault will be returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The element that contains current 4110 </SOAP-ENV:Envelope> 4111 </pre> 4112 <div class="itemizedlist"> 4113 <ul class="itemizedlist"> 4114 <li class="listitem"> 4115 <p> 4116 <span class="emphasis"> 4117 <em>//SOAP-ENV:Header/wsa:Action 4118 </em> 4119 </span> 4120 </p> 4121 <p>For this message should always be: 4122 4123 <span class="emphasis"> 4124 <em>http://docs.oasis-open.org/wsn/bw-2/ 4125 NotificationProducer/GetCurrentMessageResponse. 4126 <span class="emphasis"> 4127 <em>If 4128 differ, a fault will be returned 4129 </em> 4130 </span> 4131 </em> 4132 </span>. 4133 </p> 4134 </li> 4135 <li class="listitem"> 4136 <p> 4137 <span class="emphasis"> 4138 <em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage 4139 </em> 4140 </span> 4141 </p> 4142 <p> 4143 <span class="emphasis"> 4144 <em> 4145 <span class="emphasis"> 4146 <em>The element that contains current 1240 4147 Notification and information related to this 1241 notification.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:NotifyTime</em></span></p><p>The time when notification was received by <span class="emphasis"><em>QCG 1242 Notification</em></span>; expressed as universal time (UTC).</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/wsnt:ProducerReference/wsa:Address</em></span></p><p>A Notification producer (Publisher) address.</p></li><li class="listitem"><p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:Message</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>An extensive element. The content of 4148 notification. 4149 </em> 4150 </span> 4151 </em> 4152 </span> 4153 </p> 4154 </li> 4155 <li class="listitem"> 4156 <p> 4157 <span class="emphasis"> 4158 <em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:NotifyTime 4159 </em> 4160 </span> 4161 </p> 4162 <p>The time when notification was received by 4163 <span class="emphasis"> 4164 <em>QCG 4165 Notification 4166 </em> 4167 </span>; expressed as universal time (UTC). 4168 </p> 4169 </li> 4170 <li class="listitem"> 4171 <p> 4172 <span class="emphasis"> 4173 <em>//wsnt:GetCurrentMessageResponse/wsnt:ProducerReference/wsa:Address 4174 </em> 4175 </span> 4176 </p> 4177 <p>A Notification producer (Publisher) address. 4178 </p> 4179 </li> 4180 <li class="listitem"> 4181 <p> 4182 <span class="emphasis"> 4183 <em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:Message 4184 </em> 4185 </span> 4186 </p> 4187 <p> 4188 <span class="emphasis"> 4189 <em> 4190 <span class="emphasis"> 4191 <em>An extensive element. The content of 1243 4192 this element is the last Notification message published to the 1244 4193 Topic specified in GetCurrentMessageRequest. Currently supported 1245 are messages shorter than 4096 bytes.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="ListSubscriptions"><div class="titlepage"><div><div><h4 class="title"><a id="idp465952"/>ListSubscriptions</h4></div></div></div><p>The first method from the the group of administrative methods. 4194 are messages shorter than 4096 bytes. 4195 </em> 4196 </span> 4197 </em> 4198 </span> 4199 </p> 4200 </li> 4201 </ul> 4202 </div> 4203 </div> 4204 <div class="sect3" title="ListSubscriptions"> 4205 <div class="titlepage"> 4206 <div> 4207 <div> 4208 <h4 class="title"> 4209 <a id="idp470480"/>ListSubscriptions 4210 </h4> 4211 </div> 4212 </div> 4213 </div> 4214 <p>The first method from the the group of administrative methods. 1246 4215 It may be invoked to get an information about available subscriptions 1247 in the <span class="emphasis"><em>QCG Notification</em></span> service. The method 1248 consists of various filtering parameters.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 4216 in the 4217 <span class="emphasis"> 4218 <em>QCG Notification 4219 </em> 4220 </span> service. The method 4221 consists of various filtering parameters. 4222 </p> 4223 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1249 4224 <SOAP-ENV:Header> 1250 4225 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1251 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1252 QCGNotificationManager/ListSubscriptionsRequest</strong></span> 4226 4227 <span class="bold"> 4228 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4229 QCGNotificationManager/ListSubscriptionsRequest 4230 </strong> 4231 </span> 1253 4232 </wsa:Action> 1254 4233 ... … … 1258 4237 <smn-ext:Filter> 1259 4238 <smn-ext:SubscriptionID> 1260 <span class="bold"><strong>1568334</strong></span> 4239 4240 <span class="bold"> 4241 <strong>1568334 4242 </strong> 4243 </span> 1261 4244 </smn-ext:SubscriptionID> 1262 4245 <smn-ext:ConsumerReference> 1263 4246 <wsa:Address> 1264 <span class="bold"><strong>http://localhost:2233</strong></span> 4247 4248 <span class="bold"> 4249 <strong>http://localhost:2233 4250 </strong> 4251 </span> 1265 4252 </wsa:Address> 1266 4253 </smn-ext:ConsumerReference> 1267 4254 <smn-ext:CreationTimeMin> 1268 <span class="bold"><strong>2010-07-09T08:21:58Z</strong></span> 4255 4256 <span class="bold"> 4257 <strong>2010-07-09T08:21:58Z 4258 </strong> 4259 </span> 1269 4260 </smn-ext:CreationTimeMin> 1270 4261 <smn-ext:CreationTimeMax> 1271 <span class="bold"><strong>2010-07-09T10:21:58Z</strong></span> 4262 4263 <span class="bold"> 4264 <strong>2010-07-09T10:21:58Z 4265 </strong> 4266 </span> 1272 4267 </smn-ext:CreationTimeMax> 1273 4268 <smn-ext:TerminationTimeMin> 1274 <span class="bold"><strong>2010-07-09T08:21:58Z</strong></span> 4269 4270 <span class="bold"> 4271 <strong>2010-07-09T08:21:58Z 4272 </strong> 4273 </span> 1275 4274 </smn-ext:TerminationTimeMin> 1276 4275 <smn-ext:TerminationTimeMax> 1277 <span class="bold"><strong>2010-07-09T10:21:58Z</strong></span> 4276 4277 <span class="bold"> 4278 <strong>2010-07-09T10:21:58Z 4279 </strong> 4280 </span> 1278 4281 </smn-ext:TerminationTimeMax> 1279 4282 <wsnt:Filter> 1280 4283 <wsnt:MessageContent 1281 <span class="bold"><strong>xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"</strong></span> 4284 4285 <span class="bold"> 4286 <strong>xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage" 4287 </strong> 4288 </span> 1282 4289 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 1283 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 4290 4291 <span class="bold"> 4292 <strong>boolean(//smnex:State[text()="on"]) 4293 </strong> 4294 </span> 1284 4295 </wsnt:MessageContent> 1285 4296 <wsnt:TopicExpression 1286 <span class="bold"><strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span> 1287 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1288 <span class="bold"><strong>tns://*</strong></span> 4297 4298 <span class="bold"> 4299 <strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics" 4300 </strong> 4301 </span> 4302 Dialect= 4303 <span class="bold"> 4304 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 4305 </strong> 4306 </span>> 4307 4308 <span class="bold"> 4309 <strong>tns://* 4310 </strong> 4311 </span> 1289 4312 </wsnt:TopicExpression> 1290 4313 </wsnt:Filter> … … 1292 4315 </smn-ext:ListSubscriptions> 1293 4316 </SOAP-ENV:Body> 1294 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1295 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsRequest. 1296 <span class="emphasis"><em>If differ, a fault will be 1297 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListSubscriptions/smn-ext:Filter</em></span></p><p>The expanding element from <span class="emphasis"><em>QCG 1298 Notification</em></span> schema. It consists of a number of 1299 optional filtering parameters.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListSubscriptions/smn-ext:Filter/SubscriptionID</em></span></p><p>A Subscription identifier. Thanks to this parameter 4317 </SOAP-ENV:Envelope> 4318 </pre> 4319 <div class="itemizedlist"> 4320 <ul class="itemizedlist"> 4321 <li class="listitem"> 4322 <p> 4323 <span class="emphasis"> 4324 <em>//SOAP-ENV:Header/wsa:Action 4325 </em> 4326 </span> 4327 </p> 4328 <p>For this message should always be: 4329 4330 <span class="emphasis"> 4331 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsRequest. 4332 4333 <span class="emphasis"> 4334 <em>If differ, a fault will be 4335 returned 4336 </em> 4337 </span> 4338 </em> 4339 </span>. 4340 </p> 4341 </li> 4342 <li class="listitem"> 4343 <p> 4344 <span class="emphasis"> 4345 <em>//smn-ext:ListSubscriptions/smn-ext:Filter 4346 </em> 4347 </span> 4348 </p> 4349 <p>The expanding element from 4350 <span class="emphasis"> 4351 <em>QCG 4352 Notification 4353 </em> 4354 </span> schema. It consists of a number of 4355 optional filtering parameters. 4356 </p> 4357 </li> 4358 <li class="listitem"> 4359 <p> 4360 <span class="emphasis"> 4361 <em>//smn-ext:ListSubscriptions/smn-ext:Filter/SubscriptionID 4362 </em> 4363 </span> 4364 </p> 4365 <p>A Subscription identifier. Thanks to this parameter 1300 4366 Subscriptions may be simply filtered on the basis of Subscription 1301 ID. The value is at most 32 char long string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:ConsumerReference/wsa:Address</em></span></p><p>The parameter that enables filtering Subscriptions based on 1302 addresses of Notification Consumers.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMin 1303 </em></span></p><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>All these elements define filtering 4367 ID. The value is at most 32 char long string. 4368 </p> 4369 </li> 4370 <li class="listitem"> 4371 <p> 4372 <span class="emphasis"> 4373 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:ConsumerReference/wsa:Address 4374 </em> 4375 </span> 4376 </p> 4377 <p>The parameter that enables filtering Subscriptions based on 4378 addresses of Notification Consumers. 4379 </p> 4380 </li> 4381 <li class="listitem"> 4382 <p> 4383 <span class="emphasis"> 4384 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMin 4385 </em> 4386 </span> 4387 </p> 4388 <p> 4389 <span class="emphasis"> 4390 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMax 4391 </em> 4392 </span> 4393 </p> 4394 <p> 4395 <span class="emphasis"> 4396 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMin 4397 4398 </em> 4399 </span> 4400 </p> 4401 <p> 4402 <span class="emphasis"> 4403 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMax 4404 </em> 4405 </span> 4406 </p> 4407 <p> 4408 <span class="emphasis"> 4409 <em> 4410 <span class="emphasis"> 4411 <em>All these elements define filtering 1304 4412 parameters related to lifetime of a Subscription, respectively: 1305 4413 minimal creation time, maximal creation time, minimal termination 1306 4414 time and maximal termination time. The content of these elements 1307 4415 is a time expressed as a local time with a 1308 timezone.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/wsnt:Filter</em></span></p><p>The same parameter as the parameter specified in the 4416 timezone. 4417 </em> 4418 </span> 4419 </em> 4420 </span> 4421 </p> 4422 </li> 4423 <li class="listitem"> 4424 <p> 4425 <span class="emphasis"> 4426 <em>/smn-ext:ListSubscriptions/smn-ext:Filter/wsnt:Filter 4427 </em> 4428 </span> 4429 </p> 4430 <p>The same parameter as the parameter specified in the 1309 4431 Subscribe message. In this method it is utilized to filter 1310 4432 Subscriptions on the basis of notification filtering 1311 parameters.</p></li></ul></div></div><div class="sect3" title="ListSubscriptionsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp492144"/>ListSubscriptionsResponse</h4></div></div></div><p>The message is sent in the response to ListSubscriptions. It 4433 parameters. 4434 </p> 4435 </li> 4436 </ul> 4437 </div> 4438 </div> 4439 <div class="sect3" title="ListSubscriptionsResponse"> 4440 <div class="titlepage"> 4441 <div> 4442 <div> 4443 <h4 class="title"> 4444 <a id="idp496848"/>ListSubscriptionsResponse 4445 </h4> 4446 </div> 4447 </div> 4448 </div> 4449 <p>The message is sent in the response to ListSubscriptions. It 1312 4450 includes a list of information sets about available and probably 1313 filtered Subscriptions.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 4451 filtered Subscriptions. 4452 </p> 4453 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1314 4454 <SOAP-ENV:Header> 1315 4455 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1316 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4456 4457 <span class="bold"> 4458 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1317 4459 QCGNotificationManager/ListSubscriptionsResponse 1318 </strong></span></wsa:Action> 4460 4461 </strong> 4462 </span></wsa:Action> 1319 4463 ... 1320 4464 </SOAP-ENV:Header> … … 1323 4467 <smn-ext:Subscription> 1324 4468 <smn-ext:SubscriptionID> 1325 <span class="bold"><strong>16807 1326 </strong></span></smn-ext:SubscriptionID> 4469 4470 <span class="bold"> 4471 <strong>16807 4472 4473 </strong> 4474 </span></smn-ext:SubscriptionID> 1327 4475 <smn-ext:ConsumerReference> 1328 4476 <wsa:Address> 1329 <span class="bold"><strong>http://localhost:2233</strong></span> 4477 4478 <span class="bold"> 4479 <strong>http://localhost:2233 4480 </strong> 4481 </span> 1330 4482 </wsa:Address> 1331 4483 </smn-ext:ConsumerReference> 1332 4484 <smn-ext:CreationTime> 1333 <span class="bold"><strong>2010-07-09T09:21:48Z 1334 </strong></span></smn-ext:CreationTime> 4485 4486 <span class="bold"> 4487 <strong>2010-07-09T09:21:48Z 4488 4489 </strong> 4490 </span></smn-ext:CreationTime> 1335 4491 <smn-ext:TerminationTime> 1336 <span class="bold"><strong>2010-07-09T09:21:48Z</strong></span> 4492 4493 <span class="bold"> 4494 <strong>2010-07-09T09:21:48Z 4495 </strong> 4496 </span> 1337 4497 </smn-ext:TerminationTime> 1338 4498 <wsnt:Filter> 1339 4499 <wsnt:MessageContent 1340 <span class="bold"><strong>xmlns:smnex="</strong></span><span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"</strong></span> 4500 4501 <span class="bold"> 4502 <strong>xmlns:smnex=" 4503 </strong> 4504 </span> 4505 <span class="bold"> 4506 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage" 4507 </strong> 4508 </span> 1341 4509 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 1342 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 4510 4511 <span class="bold"> 4512 <strong>boolean(//smnex:State[text()="on"]) 4513 </strong> 4514 </span> 1343 4515 </wsnt:MessageContent> 1344 <wsnt:TopicExpression <span class="bold"><strong> 1345 xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span> 1346 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1347 <span class="bold"><strong>tns://* 1348 </strong></span></wsnt:TopicExpression> 4516 <wsnt:TopicExpression 4517 <span class="bold"> 4518 <strong> 4519 xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics" 4520 </strong> 4521 </span> 4522 Dialect= 4523 <span class="bold"> 4524 <strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full" 4525 </strong> 4526 </span>> 4527 4528 <span class="bold"> 4529 <strong>tns://* 4530 4531 </strong> 4532 </span></wsnt:TopicExpression> 1349 4533 </wsnt:Filter> 1350 4534 </smn-ext:Subscription> … … 1355 4539 </smn-ext:ListSubscriptionsResponse> 1356 4540 </SOAP-ENV:Body> 1357 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1358 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsResponse. 1359 <span class="emphasis"><em>If differ, a fault will be 1360 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse</em></span></p><p>This element contains a list of subscriptions received from 1361 <span class="emphasis"><em>QCG Notification</em></span> (probably also filtered on 4541 </SOAP-ENV:Envelope> 4542 </pre> 4543 <div class="itemizedlist"> 4544 <ul class="itemizedlist"> 4545 <li class="listitem"> 4546 <p> 4547 <span class="emphasis"> 4548 <em>//SOAP-ENV:Header/wsa:Action 4549 </em> 4550 </span> 4551 </p> 4552 <p>For this message should always be: 4553 4554 <span class="emphasis"> 4555 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsResponse. 4556 4557 <span class="emphasis"> 4558 <em>If differ, a fault will be 4559 returned 4560 </em> 4561 </span> 4562 </em> 4563 </span>. 4564 </p> 4565 </li> 4566 <li class="listitem"> 4567 <p> 4568 <span class="emphasis"> 4569 <em>//smn-ext:ListSubscriptionsResponse 4570 </em> 4571 </span> 4572 </p> 4573 <p>This element contains a list of subscriptions received from 4574 4575 <span class="emphasis"> 4576 <em>QCG Notification 4577 </em> 4578 </span> (probably also filtered on 1362 4579 the basis of the smn-ext:Filter element sent in 1363 ListSubscriptions).</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The element provides information about a 1364 single Subscription.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/SubscriptionID</em></span></p><p>A Subscription identifier. The value is at most 32 char long 1365 string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:ConsumerReference/wsa:Address</em></span></p><p>An address of Notification Consumer declared in a 1366 Subscription.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:CreationTime</em></span></p><p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:TerminationTime</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 4580 ListSubscriptions). 4581 </p> 4582 </li> 4583 <li class="listitem"> 4584 <p> 4585 <span class="emphasis"> 4586 <em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription 4587 </em> 4588 </span> 4589 </p> 4590 <p> 4591 <span class="emphasis"> 4592 <em> 4593 <span class="emphasis"> 4594 <em>The element provides information about a 4595 single Subscription. 4596 </em> 4597 </span> 4598 </em> 4599 </span> 4600 </p> 4601 </li> 4602 <li class="listitem"> 4603 <p> 4604 <span class="emphasis"> 4605 <em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/SubscriptionID 4606 </em> 4607 </span> 4608 </p> 4609 <p>A Subscription identifier. The value is at most 32 char long 4610 string. 4611 </p> 4612 </li> 4613 <li class="listitem"> 4614 <p> 4615 <span class="emphasis"> 4616 <em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:ConsumerReference/wsa:Address 4617 </em> 4618 </span> 4619 </p> 4620 <p>An address of Notification Consumer declared in a 4621 Subscription. 4622 </p> 4623 </li> 4624 <li class="listitem"> 4625 <p> 4626 <span class="emphasis"> 4627 <em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:CreationTime 4628 </em> 4629 </span> 4630 </p> 4631 <p> 4632 <span class="emphasis"> 4633 <em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:TerminationTime 4634 </em> 4635 </span> 4636 </p> 4637 <p> 4638 <span class="emphasis"> 4639 <em> 4640 <span class="emphasis"> 4641 <em>Creation time and termination time of a 1367 4642 Subscription. The content of these elements is a time expressed as 1368 UTC time.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/wsnt:Filter</em></span></p><p>The same parameter as the parameter specified in the 4643 UTC time. 4644 </em> 4645 </span> 4646 </em> 4647 </span> 4648 </p> 4649 </li> 4650 <li class="listitem"> 4651 <p> 4652 <span class="emphasis"> 4653 <em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/wsnt:Filter 4654 </em> 4655 </span> 4656 </p> 4657 <p>The same parameter as the parameter specified in the 1369 4658 Subscribe message. It specifies Notification filtering parameters 1370 of a Subscription.</p></li></ul></div></div><div class="sect3" title="ListPublishersRegistrations"><div class="titlepage"><div><div><h4 class="title"><a id="idp517664"/>ListPublishersRegistrations</h4></div></div></div><p>The next method from the group of administrative methods. It may 4659 of a Subscription. 4660 </p> 4661 </li> 4662 </ul> 4663 </div> 4664 </div> 4665 <div class="sect3" title="ListPublishersRegistrations"> 4666 <div class="titlepage"> 4667 <div> 4668 <div> 4669 <h4 class="title"> 4670 <a id="idp522048"/>ListPublishersRegistrations 4671 </h4> 4672 </div> 4673 </div> 4674 </div> 4675 <p>The next method from the group of administrative methods. It may 1371 4676 be utilized to list Publishers Registrations. The method consists of 1372 several filtering parameters.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 4677 several filtering parameters. 4678 </p> 4679 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1373 4680 <SOAP-ENV:Header> 1374 4681 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1375 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1376 QCGNotificationManager/ListPublishersRegistrationsRequest</strong></span> 4682 4683 <span class="bold"> 4684 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4685 QCGNotificationManager/ListPublishersRegistrationsRequest 4686 </strong> 4687 </span> 1377 4688 </wsa:Action> 1378 4689 ... … … 1382 4693 <smn-ext:Filter> 1383 4694 <smn-ext:PublisherRegistrationID> 1384 <span class="bold"><strong>984943658</strong></span> 4695 4696 <span class="bold"> 4697 <strong>984943658 4698 </strong> 4699 </span> 1385 4700 </smn-ext:PublisherRegistrationID> 1386 4701 <smn-ext:PublisherReference> 1387 4702 <wsa:Address> 1388 <span class="bold"><strong>127.0.0.1</strong></span> 4703 4704 <span class="bold"> 4705 <strong>127.0.0.1 4706 </strong> 4707 </span> 1389 4708 </wsa5:Address> 1390 4709 </smn-ext:PublisherReference> 1391 4710 <smn-ext:CreationTimeMin> 1392 <span class="bold"><strong>2010-07-08T09:37:04Z</strong></span> 4711 4712 <span class="bold"> 4713 <strong>2010-07-08T09:37:04Z 4714 </strong> 4715 </span> 1393 4716 </smn-ext:CreationTimeMin> 1394 4717 <smn-ext:CreationTimeMax> 1395 <span class="bold"><strong>2010-07-08T11:37:04Z</strong></span> 4718 4719 <span class="bold"> 4720 <strong>2010-07-08T11:37:04Z 4721 </strong> 4722 </span> 1396 4723 </smn-ext:CreationTimeMax> 1397 4724 <smn-ext:TerminationTimeMin> 1398 <span class="bold"><strong>2010-07-08T09:37:04Z</strong></span> 4725 4726 <span class="bold"> 4727 <strong>2010-07-08T09:37:04Z 4728 </strong> 4729 </span> 1399 4730 </smn-ext:TerminationTimeMin> 1400 4731 <smn-ext:TerminationTimeMax> 1401 <span class="bold"><strong>2010-07-08T11:37:04Z</strong></span> 4732 4733 <span class="bold"> 4734 <strong>2010-07-08T11:37:04Z 4735 </strong> 4736 </span> 1402 4737 </smn-ext:TerminationTimeMax> 1403 4738 </smn-ext:Filter> 1404 4739 </smn-ext:ListPublishersRegistrations> 1405 4740 </SOAP-ENV:Body> 1406 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1407 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsRequest. 1408 <span class="emphasis"><em>If differ, a fault will be 1409 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter</em></span></p><p>The element from <span class="emphasis"><em>QCG Notification</em></span> 1410 schema. It consists of optional filtering parameters.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter/PublisherRegistrationID</em></span></p><p>A Publisher Registration identifier. This parameter enables 4741 </SOAP-ENV:Envelope> 4742 </pre> 4743 <div class="itemizedlist"> 4744 <ul class="itemizedlist"> 4745 <li class="listitem"> 4746 <p> 4747 <span class="emphasis"> 4748 <em>//SOAP-ENV:Header/wsa:Action 4749 </em> 4750 </span> 4751 </p> 4752 <p>For this message should always be: 4753 4754 <span class="emphasis"> 4755 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsRequest. 4756 4757 <span class="emphasis"> 4758 <em>If differ, a fault will be 4759 returned 4760 </em> 4761 </span> 4762 </em> 4763 </span>. 4764 </p> 4765 </li> 4766 <li class="listitem"> 4767 <p> 4768 <span class="emphasis"> 4769 <em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter 4770 </em> 4771 </span> 4772 </p> 4773 <p>The element from 4774 <span class="emphasis"> 4775 <em>QCG Notification 4776 </em> 4777 </span> 4778 schema. It consists of optional filtering parameters. 4779 </p> 4780 </li> 4781 <li class="listitem"> 4782 <p> 4783 <span class="emphasis"> 4784 <em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter/PublisherRegistrationID 4785 </em> 4786 </span> 4787 </p> 4788 <p>A Publisher Registration identifier. This parameter enables 1411 4789 filtering of Publisher Registrations based on Publishers 1412 Registrations ID. The value is at most 32 char long string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:PublisherReference/wsa:Address</em></span></p><p>This element enables filtering based on an addresses of 4790 Registrations ID. The value is at most 32 char long string. 4791 </p> 4792 </li> 4793 <li class="listitem"> 4794 <p> 4795 <span class="emphasis"> 4796 <em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:PublisherReference/wsa:Address 4797 </em> 4798 </span> 4799 </p> 4800 <p>This element enables filtering based on an addresses of 1413 4801 Publishers. Depending on configuration, this address may be held 1414 in the <span class="emphasis"><em>QCG Notification</em></span> service as an address 4802 in the 4803 <span class="emphasis"> 4804 <em>QCG Notification 4805 </em> 4806 </span> service as an address 1415 4807 sent in the From element of WSA Header of RegisterPublisher 1416 message or an IP address of a Publisher.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMin 1417 </em></span></p><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The elements define filtering parameters 4808 message or an IP address of a Publisher. 4809 </p> 4810 </li> 4811 <li class="listitem"> 4812 <p> 4813 <span class="emphasis"> 4814 <em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMin 4815 </em> 4816 </span> 4817 </p> 4818 <p> 4819 <span class="emphasis"> 4820 <em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMax 4821 </em> 4822 </span> 4823 </p> 4824 <p> 4825 <span class="emphasis"> 4826 <em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMin 4827 4828 </em> 4829 </span> 4830 </p> 4831 <p> 4832 <span class="emphasis"> 4833 <em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMax 4834 </em> 4835 </span> 4836 </p> 4837 <p> 4838 <span class="emphasis"> 4839 <em> 4840 <span class="emphasis"> 4841 <em>The elements define filtering parameters 1418 4842 related to lifetime of a Publisher Registration, respectively: 1419 4843 minimal creation time, maximal creation time, minimal termination 1420 4844 time and maximal termination time. The content of these elements 1421 4845 is a time expressed as a local time with a 1422 timezone.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="ListPublisherRegistrationsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp538736"/>ListPublisherRegistrationsResponse</h4></div></div></div><p>The response message to ListPublishersRegistrations. It includes 1423 a list of information sets about Publishers Registrations.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 4846 timezone. 4847 </em> 4848 </span> 4849 </em> 4850 </span> 4851 </p> 4852 </li> 4853 </ul> 4854 </div> 4855 </div> 4856 <div class="sect3" title="ListPublisherRegistrationsResponse"> 4857 <div class="titlepage"> 4858 <div> 4859 <div> 4860 <h4 class="title"> 4861 <a id="idp543296"/>ListPublisherRegistrationsResponse 4862 </h4> 4863 </div> 4864 </div> 4865 </div> 4866 <p>The response message to ListPublishersRegistrations. It includes 4867 a list of information sets about Publishers Registrations. 4868 </p> 4869 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1424 4870 <SOAP-ENV:Header> 1425 4871 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1426 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4872 4873 <span class="bold"> 4874 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1427 4875 QCGNotificationManager/ListPublishersRegistrationsResponse 1428 </strong></span></wsa:Action> 4876 4877 </strong> 4878 </span></wsa:Action> 1429 4879 ... 1430 4880 </SOAP-ENV:Header> … … 1433 4883 <smn-ext:PublisherRegistration> 1434 4884 <smn-ext:PublisherRegistrationID> 1435 <span class="bold"><strong>16807 1436 </strong></span></smn-ext:PublisherRegistrationID> 4885 4886 <span class="bold"> 4887 <strong>16807 4888 4889 </strong> 4890 </span></smn-ext:PublisherRegistrationID> 1437 4891 <smn-ext:PublisherReference> 1438 4892 <wsa:Address> 1439 <span class="bold"><strong>http://localhost:2233</strong></span> 4893 4894 <span class="bold"> 4895 <strong>http://localhost:2233 4896 </strong> 4897 </span> 1440 4898 </wsa:Address> 1441 4899 </smn-ext:PublisherReference> 1442 4900 <smn-ext:CreationTime> 1443 <span class="bold"><strong>2010-07-09T09:21:48Z 1444 </strong></span></smn-ext:CreationTime> 4901 4902 <span class="bold"> 4903 <strong>2010-07-09T09:21:48Z 4904 4905 </strong> 4906 </span></smn-ext:CreationTime> 1445 4907 <smn-ext:TerminationTime> 1446 <span class="bold"><strong>2010-07-09T09:21:48Z</strong></span> 4908 4909 <span class="bold"> 4910 <strong>2010-07-09T09:21:48Z 4911 </strong> 4912 </span> 1447 4913 </smn-ext:TerminationTime> 1448 4914 </smn-ext:PublisherRegistration> … … 1453 4919 </smn-ext:ListPublishersRegistrationsResponse> 1454 4920 </SOAP-ENV:Body> 1455 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1456 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsResponse. 1457 <span class="emphasis"><em>If differ, a fault will be 1458 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse</em></span></p><p>The element contains a list of Publishers Registrations 1459 received from <span class="emphasis"><em>QCG Notification</em></span> (probably also 4921 </SOAP-ENV:Envelope> 4922 </pre> 4923 <div class="itemizedlist"> 4924 <ul class="itemizedlist"> 4925 <li class="listitem"> 4926 <p> 4927 <span class="emphasis"> 4928 <em>//SOAP-ENV:Header/wsa:Action 4929 </em> 4930 </span> 4931 </p> 4932 <p>For this message should always be: 4933 4934 <span class="emphasis"> 4935 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsResponse. 4936 4937 <span class="emphasis"> 4938 <em>If differ, a fault will be 4939 returned 4940 </em> 4941 </span> 4942 </em> 4943 </span>. 4944 </p> 4945 </li> 4946 <li class="listitem"> 4947 <p> 4948 <span class="emphasis"> 4949 <em>//smn-ext:ListPublishersRegistrationsResponse 4950 </em> 4951 </span> 4952 </p> 4953 <p>The element contains a list of Publishers Registrations 4954 received from 4955 <span class="emphasis"> 4956 <em>QCG Notification 4957 </em> 4958 </span> (probably also 1460 4959 filtered on the basis of the smn-ext:Filter element sent in a 1461 ListPublishersRegistrations message).</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The element provides information about a 1462 single Publisher Registration.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/PublisherRegistrationID</em></span></p><p>A Publisher Registration identifier. The value is at most 32 1463 char long string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:PublisherReference/wsa:Address</em></span></p><p>An address of Publisher. It may be an address defined in a 4960 ListPublishersRegistrations message). 4961 </p> 4962 </li> 4963 <li class="listitem"> 4964 <p> 4965 <span class="emphasis"> 4966 <em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration 4967 </em> 4968 </span> 4969 </p> 4970 <p> 4971 <span class="emphasis"> 4972 <em> 4973 <span class="emphasis"> 4974 <em>The element provides information about a 4975 single Publisher Registration. 4976 </em> 4977 </span> 4978 </em> 4979 </span> 4980 </p> 4981 </li> 4982 <li class="listitem"> 4983 <p> 4984 <span class="emphasis"> 4985 <em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/PublisherRegistrationID 4986 </em> 4987 </span> 4988 </p> 4989 <p>A Publisher Registration identifier. The value is at most 32 4990 char long string. 4991 </p> 4992 </li> 4993 <li class="listitem"> 4994 <p> 4995 <span class="emphasis"> 4996 <em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:PublisherReference/wsa:Address 4997 </em> 4998 </span> 4999 </p> 5000 <p>An address of Publisher. It may be an address defined in a 1464 5001 From element of WSA Header of a RegisterPublisher message or an IP 1465 address of a publisher.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:CreationTime</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:TerminationTime</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 5002 address of a publisher. 5003 </p> 5004 </li> 5005 <li class="listitem"> 5006 <p> 5007 <span class="emphasis"> 5008 <em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:CreationTime 5009 </em> 5010 </span> 5011 </p> 5012 <p> 5013 <span class="emphasis"> 5014 <em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:TerminationTime 5015 </em> 5016 </span> 5017 </p> 5018 <p> 5019 <span class="emphasis"> 5020 <em> 5021 <span class="emphasis"> 5022 <em>Creation time and termination time of a 1466 5023 Publisher Registration. The content of these elements is a time 1467 expressed as UTC time.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="ListPullPoints"><div class="titlepage"><div><div><h4 class="title"><a id="idp558320"/>ListPullPoints</h4></div></div></div><p>The next administrative method. It enables listing of available 5024 expressed as UTC time. 5025 </em> 5026 </span> 5027 </em> 5028 </span> 5029 </p> 5030 </li> 5031 </ul> 5032 </div> 5033 </div> 5034 <div class="sect3" title="ListPullPoints"> 5035 <div class="titlepage"> 5036 <div> 5037 <div> 5038 <h4 class="title"> 5039 <a id="idp562880"/>ListPullPoints 5040 </h4> 5041 </div> 5042 </div> 5043 </div> 5044 <p>The next administrative method. It enables listing of available 1468 5045 PullPoints. The method consists of several optional filtering 1469 parameters.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5046 parameters. 5047 </p> 5048 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1470 5049 <SOAP-ENV:Header> 1471 5050 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1472 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1473 QCGNotificationManager/ListPullPointsRequest</strong></span> 5051 5052 <span class="bold"> 5053 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5054 QCGNotificationManager/ListPullPointsRequest 5055 </strong> 5056 </span> 1474 5057 </wsa:Action> 1475 5058 ... … … 1479 5062 <smn-ext:Filter> 1480 5063 <smn-ext:PullPointID> 1481 <span class="bold"><strong>9342232</strong></span> 5064 5065 <span class="bold"> 5066 <strong>9342232 5067 </strong> 5068 </span> 1482 5069 </smn-ext:PullPointID> 1483 5070 <smn-ext:PullPointReference> 1484 5071 <wsa:Address> 1485 <span class="bold"><strong>http://localhost:2211?ppID=9342232</strong></span> 5072 5073 <span class="bold"> 5074 <strong>http://localhost:2211?ppID=9342232 5075 </strong> 5076 </span> 1486 5077 </wsa5:Address> 1487 5078 </smn-ext:PullPointReference> 1488 5079 <smn-ext:CreationTimeMin> 1489 <span class="bold"><strong>2010-07-08T09:38:03Z</strong></span> 5080 5081 <span class="bold"> 5082 <strong>2010-07-08T09:38:03Z 5083 </strong> 5084 </span> 1490 5085 </smn-ext:CreationTimeMin> 1491 5086 <smn-ext:CreationTimeMax> 1492 <span class="bold"><strong>2010-07-08T11:38:03Z</strong></span> 5087 5088 <span class="bold"> 5089 <strong>2010-07-08T11:38:03Z 5090 </strong> 5091 </span> 1493 5092 </smn-ext:CreationTimeMax> 1494 5093 <smn-ext:TerminationTimeMin> 1495 <span class="bold"><strong>2010-07-08T09:38:03Z</strong></span> 5094 5095 <span class="bold"> 5096 <strong>2010-07-08T09:38:03Z 5097 </strong> 5098 </span> 1496 5099 </smn-ext:TerminationTimeMin> 1497 5100 <smn-ext:TerminationTimeMax> 1498 <span class="bold"><strong>2010-07-08T11:38:03Z</strong></span> 5101 5102 <span class="bold"> 5103 <strong>2010-07-08T11:38:03Z 5104 </strong> 5105 </span> 1499 5106 </smn-ext:TerminationTimeMax> 1500 5107 </smn-ext:Filter> 1501 5108 </smn-ext:ListPullPoints> 1502 5109 </SOAP-ENV:Body> 1503 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1504 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsRequest. 1505 <span class="emphasis"><em>If differ, a fault will be 1506 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter</em></span></p><p>The element from <span class="emphasis"><em>QCG Notification</em></span> 1507 schema. It consists of optional filtering parameters.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointID</em></span></p><p>A PullPoint identifier. This parameter enables filtering of 5110 </SOAP-ENV:Envelope> 5111 </pre> 5112 <div class="itemizedlist"> 5113 <ul class="itemizedlist"> 5114 <li class="listitem"> 5115 <p> 5116 <span class="emphasis"> 5117 <em>//SOAP-ENV:Header/wsa:Action 5118 </em> 5119 </span> 5120 </p> 5121 <p>For this message should always be: 5122 5123 <span class="emphasis"> 5124 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsRequest. 5125 5126 <span class="emphasis"> 5127 <em>If differ, a fault will be 5128 returned 5129 </em> 5130 </span> 5131 </em> 5132 </span>. 5133 </p> 5134 </li> 5135 <li class="listitem"> 5136 <p> 5137 <span class="emphasis"> 5138 <em>//smn-ext:ListPullPoints/smn-ext:Filter 5139 </em> 5140 </span> 5141 </p> 5142 <p>The element from 5143 <span class="emphasis"> 5144 <em>QCG Notification 5145 </em> 5146 </span> 5147 schema. It consists of optional filtering parameters. 5148 </p> 5149 </li> 5150 <li class="listitem"> 5151 <p> 5152 <span class="emphasis"> 5153 <em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointID 5154 </em> 5155 </span> 5156 </p> 5157 <p>A PullPoint identifier. This parameter enables filtering of 1508 5158 PullPoints based on PullPoint ID. The value is at most 32 char 1509 long string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointReference/wsa:Address</em></span></p><p>This element enables filtering based on an addresses of 5159 long string. 5160 </p> 5161 </li> 5162 <li class="listitem"> 5163 <p> 5164 <span class="emphasis"> 5165 <em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointReference/wsa:Address 5166 </em> 5167 </span> 5168 </p> 5169 <p>This element enables filtering based on an addresses of 1510 5170 PullPoint. The PullPoint address is assigned after creation of a 1511 PullPoint in <span class="emphasis"><em>QCG Notification</em></span> and returned 1512 inside CreatePullPointResponse.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMin 1513 </em></span></p><p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The elements define filtering parameters 5171 PullPoint in 5172 <span class="emphasis"> 5173 <em>QCG Notification 5174 </em> 5175 </span> and returned 5176 inside CreatePullPointResponse. 5177 </p> 5178 </li> 5179 <li class="listitem"> 5180 <p> 5181 <span class="emphasis"> 5182 <em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMin 5183 </em> 5184 </span> 5185 </p> 5186 <p> 5187 <span class="emphasis"> 5188 <em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMax 5189 </em> 5190 </span> 5191 </p> 5192 <p> 5193 <span class="emphasis"> 5194 <em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMin 5195 5196 </em> 5197 </span> 5198 </p> 5199 <p> 5200 <span class="emphasis"> 5201 <em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMax 5202 </em> 5203 </span> 5204 </p> 5205 <p> 5206 <span class="emphasis"> 5207 <em> 5208 <span class="emphasis"> 5209 <em>The elements define filtering parameters 1514 5210 related to PullPoint lifetime, respectively: minimal creation 1515 5211 time, maximal creation time, minimal termination time and maximal 1516 5212 termination time. The content of these elements is a time 1517 5213 expressed as a local time with a 1518 timezone.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="ListPullPointsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp579120"/>ListPullPointsResponse</h4></div></div></div><p>The response message to ListPullPoints. It includes a list of 1519 information sets about filtered Pullpoints.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5214 timezone. 5215 </em> 5216 </span> 5217 </em> 5218 </span> 5219 </p> 5220 </li> 5221 </ul> 5222 </div> 5223 </div> 5224 <div class="sect3" title="ListPullPointsResponse"> 5225 <div class="titlepage"> 5226 <div> 5227 <div> 5228 <h4 class="title"> 5229 <a id="idp583600"/>ListPullPointsResponse 5230 </h4> 5231 </div> 5232 </div> 5233 </div> 5234 <p>The response message to ListPullPoints. It includes a list of 5235 information sets about filtered Pullpoints. 5236 </p> 5237 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1520 5238 <SOAP-ENV:Header> 1521 5239 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1522 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5240 5241 <span class="bold"> 5242 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1523 5243 QCGNotificationManager/ListPullPointsResponse 1524 </strong></span></wsa:Action> 5244 5245 </strong> 5246 </span></wsa:Action> 1525 5247 ... 1526 5248 </SOAP-ENV:Header> … … 1529 5251 <smn-ext:PullPoint> 1530 5252 <smn-ext:PullPointID> 1531 <span class="bold"><strong>9342232 1532 </strong></span></smn-ext:PullPointID> 5253 5254 <span class="bold"> 5255 <strong>9342232 5256 5257 </strong> 5258 </span></smn-ext:PullPointID> 1533 5259 <smn-ext:PullPointReference> 1534 5260 <wsa:Address> 1535 <span class="bold"><strong>http://localhost:2211?ppID=9342232</strong></span> 5261 5262 <span class="bold"> 5263 <strong>http://localhost:2211?ppID=9342232 5264 </strong> 5265 </span> 1536 5266 </wsa:Address> 1537 5267 </smn-ext:PullPointReference> 1538 5268 <smn-ext:CreationTime> 1539 <span class="bold"><strong>2010-07-09T09:31:28Z 1540 </strong></span></smn-ext:CreationTime> 5269 5270 <span class="bold"> 5271 <strong>2010-07-09T09:31:28Z 5272 5273 </strong> 5274 </span></smn-ext:CreationTime> 1541 5275 <smn-ext:TerminationTime> 1542 <span class="bold"><strong>2010-07-09T09:31:28Z</strong></span> 5276 5277 <span class="bold"> 5278 <strong>2010-07-09T09:31:28Z 5279 </strong> 5280 </span> 1543 5281 </smn-ext:TerminationTime> 1544 5282 </smn-ext:PullPoint> … … 1549 5287 </smn-ext:ListPullPointsResponse> 1550 5288 </SOAP-ENV:Body> 1551 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1552 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsResponse. 1553 <span class="emphasis"><em>If differ, a fault will be 1554 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse</em></span></p><p>The element contains a list of PullPoints received from 1555 <span class="emphasis"><em>QCG Notification</em></span> (probably also previously 5289 </SOAP-ENV:Envelope> 5290 </pre> 5291 <div class="itemizedlist"> 5292 <ul class="itemizedlist"> 5293 <li class="listitem"> 5294 <p> 5295 <span class="emphasis"> 5296 <em>//SOAP-ENV:Header/wsa:Action 5297 </em> 5298 </span> 5299 </p> 5300 <p>For this message should always be: 5301 5302 <span class="emphasis"> 5303 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsResponse. 5304 5305 <span class="emphasis"> 5306 <em>If differ, a fault will be 5307 returned 5308 </em> 5309 </span> 5310 </em> 5311 </span>. 5312 </p> 5313 </li> 5314 <li class="listitem"> 5315 <p> 5316 <span class="emphasis"> 5317 <em>//smn-ext:ListPullPointsResponse 5318 </em> 5319 </span> 5320 </p> 5321 <p>The element contains a list of PullPoints received from 5322 5323 <span class="emphasis"> 5324 <em>QCG Notification 5325 </em> 5326 </span> (probably also previously 1556 5327 filtered on the basis of the smn-ext:Filter element sent in a 1557 ListPullPoints message).</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The element provides particular 1558 information about a single PullPoint.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint/PullPointID</em></span></p><p>A PullPoint identifier. The value is at most 32 char long 1559 string.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:PullPointReference/wsa:Address</em></span></p><p>An address of PullPoint. For particular PullPoint it is the 5328 ListPullPoints message). 5329 </p> 5330 </li> 5331 <li class="listitem"> 5332 <p> 5333 <span class="emphasis"> 5334 <em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint 5335 </em> 5336 </span> 5337 </p> 5338 <p> 5339 <span class="emphasis"> 5340 <em> 5341 <span class="emphasis"> 5342 <em>The element provides particular 5343 information about a single PullPoint. 5344 </em> 5345 </span> 5346 </em> 5347 </span> 5348 </p> 5349 </li> 5350 <li class="listitem"> 5351 <p> 5352 <span class="emphasis"> 5353 <em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint/PullPointID 5354 </em> 5355 </span> 5356 </p> 5357 <p>A PullPoint identifier. The value is at most 32 char long 5358 string. 5359 </p> 5360 </li> 5361 <li class="listitem"> 5362 <p> 5363 <span class="emphasis"> 5364 <em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:PullPointReference/wsa:Address 5365 </em> 5366 </span> 5367 </p> 5368 <p>An address of PullPoint. For particular PullPoint it is the 1560 5369 same address as the address from a corresponding 1561 CreatePullPointResponse message.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:CreationTime</em></span></p><p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:TerminationTime</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 5370 CreatePullPointResponse message. 5371 </p> 5372 </li> 5373 <li class="listitem"> 5374 <p> 5375 <span class="emphasis"> 5376 <em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:CreationTime 5377 </em> 5378 </span> 5379 </p> 5380 <p> 5381 <span class="emphasis"> 5382 <em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:TerminationTime 5383 </em> 5384 </span> 5385 </p> 5386 <p> 5387 <span class="emphasis"> 5388 <em> 5389 <span class="emphasis"> 5390 <em>Creation time and termination time of a 1562 5391 PullPoint. The content of these elements is a time expressed as 1563 UTC time.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="ListTopicNamespaces"><div class="titlepage"><div><div><h4 class="title"><a id="idp598336"/>ListTopicNamespaces</h4></div></div></div><p>An administrative method. It is designed to listing available 1564 Topic Namespaces and Topics assigned to this namespaces.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5392 UTC time. 5393 </em> 5394 </span> 5395 </em> 5396 </span> 5397 </p> 5398 </li> 5399 </ul> 5400 </div> 5401 </div> 5402 <div class="sect3" title="ListTopicNamespaces"> 5403 <div class="titlepage"> 5404 <div> 5405 <div> 5406 <h4 class="title"> 5407 <a id="idp602816"/>ListTopicNamespaces 5408 </h4> 5409 </div> 5410 </div> 5411 </div> 5412 <p>An administrative method. It is designed to listing available 5413 Topic Namespaces and Topics assigned to this namespaces. 5414 </p> 5415 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1565 5416 <SOAP-ENV:Header> 1566 5417 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1567 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1568 QCGNotificationManager/ListTopicNamespacesRequest</strong></span> 5418 5419 <span class="bold"> 5420 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5421 QCGNotificationManager/ListTopicNamespacesRequest 5422 </strong> 5423 </span> 1569 5424 </wsa:Action> 1570 5425 ... … … 1574 5429 <smn-ext:Filter> 1575 5430 <smn-ext:targetNamespace> 1576 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span> 5431 5432 <span class="bold"> 5433 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 5434 </strong> 5435 </span> 1577 5436 </smn-ext:targetNamespace> 1578 5437 </smn-ext:Filter> 1579 5438 </smn-ext:ListTopicNamespaces> 1580 5439 </SOAP-ENV:Body> 1581 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1582 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesRequest. 1583 <span class="emphasis"><em>If differ, a fault will be 1584 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListTopicNamespaces/smn-ext:Filter</em></span></p><p>The element from <span class="emphasis"><em>QCG Notification</em></span> 1585 schema. It consists of optional filtering parameters.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:targetNamespace</em></span></p><p>A targetNamespace of a TopicNamespace. This parameter 5440 </SOAP-ENV:Envelope> 5441 </pre> 5442 <div class="itemizedlist"> 5443 <ul class="itemizedlist"> 5444 <li class="listitem"> 5445 <p> 5446 <span class="emphasis"> 5447 <em>//SOAP-ENV:Header/wsa:Action 5448 </em> 5449 </span> 5450 </p> 5451 <p>For this message should always be: 5452 5453 <span class="emphasis"> 5454 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesRequest. 5455 5456 <span class="emphasis"> 5457 <em>If differ, a fault will be 5458 returned 5459 </em> 5460 </span> 5461 </em> 5462 </span>. 5463 </p> 5464 </li> 5465 <li class="listitem"> 5466 <p> 5467 <span class="emphasis"> 5468 <em>//smn-ext:ListTopicNamespaces/smn-ext:Filter 5469 </em> 5470 </span> 5471 </p> 5472 <p>The element from 5473 <span class="emphasis"> 5474 <em>QCG Notification 5475 </em> 5476 </span> 5477 schema. It consists of optional filtering parameters. 5478 </p> 5479 </li> 5480 <li class="listitem"> 5481 <p> 5482 <span class="emphasis"> 5483 <em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:targetNamespace 5484 </em> 5485 </span> 5486 </p> 5487 <p>A targetNamespace of a TopicNamespace. This parameter 1586 5488 enables filtering of TopicNamespaces based on their 1587 targetNamespace names.</p></li></ul></div></div><div class="sect3" title="ListTopicNamespacesResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp609184"/>ListTopicNamespacesResponse</h4></div></div></div><p>The response message to ListTopicNamespaces. The message 5489 targetNamespace names. 5490 </p> 5491 </li> 5492 </ul> 5493 </div> 5494 </div> 5495 <div class="sect3" title="ListTopicNamespacesResponse"> 5496 <div class="titlepage"> 5497 <div> 5498 <div> 5499 <h4 class="title"> 5500 <a id="idp613664"/>ListTopicNamespacesResponse 5501 </h4> 5502 </div> 5503 </div> 5504 </div> 5505 <p>The response message to ListTopicNamespaces. The message 1588 5506 consists of information sets for each filtered TopicNamespace. A 1589 single set includes targetNamespaces and a list of topics.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5507 single set includes targetNamespaces and a list of topics. 5508 </p> 5509 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1590 5510 <SOAP-ENV:Header> 1591 5511 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1592 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5512 5513 <span class="bold"> 5514 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1593 5515 QCGNotificationManager/ListPullPointsResponse 1594 </strong></span></wsa:Action> 5516 5517 </strong> 5518 </span></wsa:Action> 1595 5519 ... 1596 5520 </SOAP-ENV:Header> … … 1599 5523 <smn-ext:TopicNamespace> 1600 5524 <smn-ext:targetNamespace> 1601 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span><span class="bold"><strong> 1602 </strong></span></smn-ext:targetNamespace> 5525 5526 <span class="bold"> 5527 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 5528 </strong> 5529 </span> 5530 <span class="bold"> 5531 <strong> 5532 5533 </strong> 5534 </span></smn-ext:targetNamespace> 1603 5535 <smn-ext:Topic> 1604 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics/House</strong></span> 5536 5537 <span class="bold"> 5538 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics/House 5539 </strong> 5540 </span> 1605 5541 </smn-ext:Topic> 1606 5542 <smn-ext:Topic> … … 1615 5551 </smn-ext:ListTopicNamespacesResponse> 1616 5552 </SOAP-ENV:Body> 1617 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1618 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesResponse. 1619 <span class="emphasis"><em>If differ, a fault will be 1620 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse</em></span></p><p>The element contains a list of information about 1621 TopicNamespaces received from <span class="emphasis"><em>QCG 1622 Notification</em></span> (optionally filtered on the basis of the 5553 </SOAP-ENV:Envelope> 5554 </pre> 5555 <div class="itemizedlist"> 5556 <ul class="itemizedlist"> 5557 <li class="listitem"> 5558 <p> 5559 <span class="emphasis"> 5560 <em>//SOAP-ENV:Header/wsa:Action 5561 </em> 5562 </span> 5563 </p> 5564 <p>For this message should always be: 5565 5566 <span class="emphasis"> 5567 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesResponse. 5568 5569 <span class="emphasis"> 5570 <em>If differ, a fault will be 5571 returned 5572 </em> 5573 </span> 5574 </em> 5575 </span>. 5576 </p> 5577 </li> 5578 <li class="listitem"> 5579 <p> 5580 <span class="emphasis"> 5581 <em>//smn-ext:ListTopicNamespacesResponse 5582 </em> 5583 </span> 5584 </p> 5585 <p>The element contains a list of information about 5586 TopicNamespaces received from 5587 <span class="emphasis"> 5588 <em>QCG 5589 Notification 5590 </em> 5591 </span> (optionally filtered on the basis of the 1623 5592 smn-ext:Filter element sent in a ListTopicNamespaces 1624 message).</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace</em></span></p><p><span class="emphasis"><em><span class="emphasis"><em>The element provides particular 5593 message). 5594 </p> 5595 </li> 5596 <li class="listitem"> 5597 <p> 5598 <span class="emphasis"> 5599 <em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace 5600 </em> 5601 </span> 5602 </p> 5603 <p> 5604 <span class="emphasis"> 5605 <em> 5606 <span class="emphasis"> 5607 <em>The element provides particular 1625 5608 information about a single 1626 TopicNamespace.</em></span></em></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:targetNamespace</em></span></p><p>A targetNamespace identifying single TopicNamespace. The 1627 value should be compliant with anyURI.</p></li><li class="listitem"><p><span class="emphasis"><em>/smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:Topic</em></span></p><p>A list of topics belonging to a TopicNamespace. Each listed 1628 topic is proceeded by a targetNamespace so it is Unix.</p></li></ul></div></div><div class="sect3" title="AddTopicNamespace"><div class="titlepage"><div><div><h4 class="title"><a id="idp624752"/>AddTopicNamespace</h4></div></div></div><p>An administrative method. The method may be invoked to add a new 1629 TopicNamespace to the <span class="emphasis"><em>QCG Notification</em></span>.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5609 TopicNamespace. 5610 </em> 5611 </span> 5612 </em> 5613 </span> 5614 </p> 5615 </li> 5616 <li class="listitem"> 5617 <p> 5618 <span class="emphasis"> 5619 <em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:targetNamespace 5620 </em> 5621 </span> 5622 </p> 5623 <p>A targetNamespace identifying single TopicNamespace. The 5624 value should be compliant with anyURI. 5625 </p> 5626 </li> 5627 <li class="listitem"> 5628 <p> 5629 <span class="emphasis"> 5630 <em>/smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:Topic 5631 </em> 5632 </span> 5633 </p> 5634 <p>A list of topics belonging to a TopicNamespace. Each listed 5635 topic is proceeded by a targetNamespace so it is Unix. 5636 </p> 5637 </li> 5638 </ul> 5639 </div> 5640 </div> 5641 <div class="sect3" title="AddTopicNamespace"> 5642 <div class="titlepage"> 5643 <div> 5644 <div> 5645 <h4 class="title"> 5646 <a id="idp629232"/>AddTopicNamespace 5647 </h4> 5648 </div> 5649 </div> 5650 </div> 5651 <p>An administrative method. The method may be invoked to add a new 5652 TopicNamespace to the 5653 <span class="emphasis"> 5654 <em>QCG Notification 5655 </em> 5656 </span>. 5657 </p> 5658 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1630 5659 <SOAP-ENV:Header> 1631 5660 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1632 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1633 QCGNotificationManager/AddTopicNamespaceRequest</strong></span> 5661 5662 <span class="bold"> 5663 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5664 QCGNotificationManager/AddTopicNamespaceRequest 5665 </strong> 5666 </span> 1634 5667 </wsa:Action> 1635 5668 ... … … 1638 5671 <smn-ext:AddTopicNamespace> 1639 5672 <wstop:TopicNamespace 1640 targetNamespace="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2</strong></span>"> 1641 <wstop:Topic final="false" name="<span class="bold"><strong>House</strong></span>"> 5673 targetNamespace=" 5674 <span class="bold"> 5675 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2 5676 </strong> 5677 </span>"> 5678 <wstop:Topic final="false" name=" 5679 <span class="bold"> 5680 <strong>House 5681 </strong> 5682 </span>"> 1642 5683 <wstop:Topic ...> 1643 5684 ... … … 1649 5690 </smn-ext:AddTopicNamespace> 1650 5691 </SOAP-ENV:Body> 1651 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1652 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceRequest. 1653 <span class="emphasis"><em>If differ, a fault will be 1654 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:AddTopicNamespaces/wstop:TopicNamespace</em></span></p><p>The element defining a single Topic Namespace. It cames from 1655 WS-Topics schema.</p></li></ul></div></div><div class="sect3" title="AddTopicNamespaceResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp634272"/>AddTopicNamespaceResponse</h4></div></div></div><p>A response message to a AddTopicNamespaceRequest. It is empty 5692 </SOAP-ENV:Envelope> 5693 </pre> 5694 <div class="itemizedlist"> 5695 <ul class="itemizedlist"> 5696 <li class="listitem"> 5697 <p> 5698 <span class="emphasis"> 5699 <em>//SOAP-ENV:Header/wsa:Action 5700 </em> 5701 </span> 5702 </p> 5703 <p>For this message should always be: 5704 5705 <span class="emphasis"> 5706 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceRequest. 5707 5708 <span class="emphasis"> 5709 <em>If differ, a fault will be 5710 returned 5711 </em> 5712 </span> 5713 </em> 5714 </span>. 5715 </p> 5716 </li> 5717 <li class="listitem"> 5718 <p> 5719 <span class="emphasis"> 5720 <em>//smn-ext:AddTopicNamespaces/wstop:TopicNamespace 5721 </em> 5722 </span> 5723 </p> 5724 <p>The element defining a single Topic Namespace. It cames from 5725 WS-Topics schema. 5726 </p> 5727 </li> 5728 </ul> 5729 </div> 5730 </div> 5731 <div class="sect3" title="AddTopicNamespaceResponse"> 5732 <div class="titlepage"> 5733 <div> 5734 <div> 5735 <h4 class="title"> 5736 <a id="idp636624"/>AddTopicNamespaceResponse 5737 </h4> 5738 </div> 5739 </div> 5740 </div> 5741 <p>A response message to a AddTopicNamespaceRequest. It is empty 1656 5742 and only confirms successful addition of a TopicNamespace to the 1657 <span class="emphasis"><em>QCG Notification</em></span> service. </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5743 5744 <span class="emphasis"> 5745 <em>QCG Notification 5746 </em> 5747 </span> service. 5748 </p> 5749 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1658 5750 <SOAP-ENV:Header> 1659 5751 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1660 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1661 PullPoint/AddTopicNamespaceResponse</strong></span> 5752 5753 <span class="bold"> 5754 <strong>http://docs.oasis-open.org/wsn/bw-2/ 5755 PullPoint/AddTopicNamespaceResponse 5756 </strong> 5757 </span> 1662 5758 </wsa:Action> 1663 5759 ... … … 1667 5763 </smn-ext:AddTopicNamespaceResponse> 1668 5764 </SOAP-ENV:Body> 1669 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1670 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceResponse.</em></span><span class="emphasis"><em><span class="emphasis"><em> 1671 If differ, a fault will be returned.</em></span></em></span></p></li></ul></div></div><div class="sect3" title="RemoveTopicNamespace"><div class="titlepage"><div><div><h4 class="title"><a id="idp640752"/>RemoveTopicNamespace</h4></div></div></div><p>The next administrative method. It is used to remove a 1672 TopicNamespace from the <span class="emphasis"><em>QCG Notification</em></span> system. 5765 </SOAP-ENV:Envelope> 5766 </pre> 5767 <div class="itemizedlist"> 5768 <ul class="itemizedlist"> 5769 <li class="listitem"> 5770 <p> 5771 <span class="emphasis"> 5772 <em>//SOAP-ENV:Header/wsa:Action 5773 </em> 5774 </span> 5775 </p> 5776 <p>For this message should always be: 5777 5778 <span class="emphasis"> 5779 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceResponse. 5780 </em> 5781 </span> 5782 <span class="emphasis"> 5783 <em> 5784 <span class="emphasis"> 5785 <em> 5786 If differ, a fault will be returned. 5787 </em> 5788 </span> 5789 </em> 5790 </span> 5791 </p> 5792 </li> 5793 </ul> 5794 </div> 5795 </div> 5796 <div class="sect3" title="RemoveTopicNamespace"> 5797 <div class="titlepage"> 5798 <div> 5799 <div> 5800 <h4 class="title"> 5801 <a id="idp644960"/>RemoveTopicNamespace 5802 </h4> 5803 </div> 5804 </div> 5805 </div> 5806 <p>The next administrative method. It is used to remove a 5807 TopicNamespace from the 5808 <span class="emphasis"> 5809 <em>QCG Notification 5810 </em> 5811 </span> system. 1673 5812 Note that the removing may be only temporary (active to the restart of 1674 5813 the system) if the TopicNamespace file is protected by disabling write 1675 permission.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5814 permission. 5815 </p> 5816 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1676 5817 <SOAP-ENV:Header> 1677 5818 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1678 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 1679 QCGNotificationManager/RemoveTopicNamespaceRequest</strong></span> 5819 5820 <span class="bold"> 5821 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5822 QCGNotificationManager/RemoveTopicNamespaceRequest 5823 </strong> 5824 </span> 1680 5825 </wsa:Action> 1681 5826 ... … … 1684 5829 <smn-ext:RemoveTopicNamespace> 1685 5830 <smn-ext:targetNamespace> 1686 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2/House</strong></span> 5831 5832 <span class="bold"> 5833 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2/House 5834 </strong> 5835 </span> 1687 5836 </smn-ext:targetNamespace> 1688 5837 </smn-ext:RemoveTopicNamespace> 1689 5838 </SOAP-ENV:Body> 1690 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1691 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceRequest. 1692 <span class="emphasis"><em>If differ, a fault will be 1693 returned</em></span></em></span>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn-ext:RemoveTopicNamespaces/smn-ext:targetNamespace</em></span></p><p>The targetNamespace name of a TopicNamespace dedicated to 1694 remove - anyURI.</p></li></ul></div></div><div class="sect3" title="RemoveTopicNamespaceResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp649600"/>RemoveTopicNamespaceResponse</h4></div></div></div><p>A response message to a RemoveTopicNamespaceRequest. It is empty 5839 </SOAP-ENV:Envelope> 5840 </pre> 5841 <div class="itemizedlist"> 5842 <ul class="itemizedlist"> 5843 <li class="listitem"> 5844 <p> 5845 <span class="emphasis"> 5846 <em>//SOAP-ENV:Header/wsa:Action 5847 </em> 5848 </span> 5849 </p> 5850 <p>For this message should always be: 5851 5852 <span class="emphasis"> 5853 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceRequest. 5854 5855 <span class="emphasis"> 5856 <em>If differ, a fault will be 5857 returned 5858 </em> 5859 </span> 5860 </em> 5861 </span>. 5862 </p> 5863 </li> 5864 <li class="listitem"> 5865 <p> 5866 <span class="emphasis"> 5867 <em>//smn-ext:RemoveTopicNamespaces/smn-ext:targetNamespace 5868 </em> 5869 </span> 5870 </p> 5871 <p>The targetNamespace name of a TopicNamespace dedicated to 5872 remove - anyURI. 5873 </p> 5874 </li> 5875 </ul> 5876 </div> 5877 </div> 5878 <div class="sect3" title="RemoveTopicNamespaceResponse"> 5879 <div class="titlepage"> 5880 <div> 5881 <div> 5882 <h4 class="title"> 5883 <a id="idp650880"/>RemoveTopicNamespaceResponse 5884 </h4> 5885 </div> 5886 </div> 5887 </div> 5888 <p>A response message to a RemoveTopicNamespaceRequest. It is empty 1695 5889 and confirms the successful deletion of a TopicNamespace. 1696 </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5890 5891 </p> 5892 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1697 5893 <SOAP-ENV:Header> 1698 5894 <wsa:Action SOAP-ENV:mustUnderstand="1"> 1699 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1700 PullPoint/RemoveTopicNamespaceResponse</strong></span> 5895 5896 <span class="bold"> 5897 <strong>http://docs.oasis-open.org/wsn/bw-2/ 5898 PullPoint/RemoveTopicNamespaceResponse 5899 </strong> 5900 </span> 1701 5901 </wsa:Action> 1702 5902 ... … … 1706 5906 </smn-ext:RemoveTopicNamespaceResponse> 1707 5907 </SOAP-ENV:Body> 1708 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p><p>For this message should always be: 1709 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceResponse.</em></span><span class="emphasis"><em><span class="emphasis"><em> 1710 If differ, a fault will be returned.</em></span></em></span></p></li></ul></div></div></div></div><div class="sect1" title="Administration Guide of QCG Notification"><div class="titlepage"><div><div><h2 class="title"><a id="idp653040"/>Administration Guide of <span class="emphasis"><em>QCG 1711 Notification</em></span></h2></div></div></div><div class="sect2" title="Prerequisites"><div class="titlepage"><div><div><h3 class="title"><a id="idp656032"/>Prerequisites</h3></div></div></div><p>In order to build and install <span class="emphasis"><em>QCG 1712 Notification</em></span>, an administrator has to appropriately configure 5908 </SOAP-ENV:Envelope> 5909 </pre> 5910 <div class="itemizedlist"> 5911 <ul class="itemizedlist"> 5912 <li class="listitem"> 5913 <p> 5914 <span class="emphasis"> 5915 <em>//SOAP-ENV:Header/wsa:Action 5916 </em> 5917 </span> 5918 </p> 5919 <p>For this message should always be: 5920 5921 <span class="emphasis"> 5922 <em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceResponse. 5923 </em> 5924 </span> 5925 <span class="emphasis"> 5926 <em> 5927 <span class="emphasis"> 5928 <em> 5929 If differ, a fault will be returned. 5930 </em> 5931 </span> 5932 </em> 5933 </span> 5934 </p> 5935 </li> 5936 </ul> 5937 </div> 5938 </div> 5939 </div> 5940 </div> 5941 <div class="sect1" title="Administration Guide of QCG Notification"> 5942 <div class="titlepage"> 5943 <div> 5944 <div> 5945 <h2 class="title"> 5946 <a id="idp238096"/>Administration Guide of 5947 <span class="emphasis"> 5948 <em>QCG 5949 Notification 5950 </em> 5951 </span> 5952 </h2> 5953 </div> 5954 </div> 5955 </div> 5956 <div class="sect2" title="Prerequisites"> 5957 <div class="titlepage"> 5958 <div> 5959 <div> 5960 <h3 class="title"> 5961 <a id="idp660768"/>Prerequisites 5962 </h3> 5963 </div> 5964 </div> 5965 </div> 5966 <p>In order to build and install 5967 <span class="emphasis"> 5968 <em>QCG 5969 Notification 5970 </em> 5971 </span>, an administrator has to appropriately configure 1713 5972 operating system. There is some dependencies to external software that 1714 should be satisfied.</p><div class="sect3" title="QCG Core library"><div class="titlepage"><div><div><h4 class="title"><a id="idp657808"/>QCG Core library</h4></div></div></div><p><span class="emphasis"><em>QCG Notification</em></span> is based on the 1715 <span class="emphasis"><em>QCG Core</em></span> library developed by the 1716 <span class="emphasis"><em>QCG</em></span> team. QCG Core is a common utility library 5973 should be satisfied. 5974 </p> 5975 <div class="sect3" title="QCG Core library"> 5976 <div class="titlepage"> 5977 <div> 5978 <div> 5979 <h4 class="title"> 5980 <a id="idp662352"/>QCG Core library 5981 </h4> 5982 </div> 5983 </div> 5984 </div> 5985 <p> 5986 <span class="emphasis"> 5987 <em>QCG Notification 5988 </em> 5989 </span> is based on the 5990 5991 <span class="emphasis"> 5992 <em>QCG Core 5993 </em> 5994 </span> library developed by the 5995 5996 <span class="emphasis"> 5997 <em>QCG 5998 </em> 5999 </span> team. QCG Core is a common utility library 1717 6000 providing set of basic modules used by other components within QCG 1718 Project. For more information see QCG Core documentation.</p><p>The QCG Core library should be properly configured in prior to 1719 preparation of <span class="emphasis"><em>QCG Notification</em></span>.</p></div></div><div class="sect2" title="Building"><div class="titlepage"><div><div><h3 class="title"><a id="idp661776"/>Building</h3></div></div></div><p>Before you compile <span class="emphasis"><em>QCG Notification</em></span>, you need 6001 Project. For more information see QCG Core documentation. 6002 </p> 6003 <p>The QCG Core library should be properly configured in prior to 6004 preparation of 6005 <span class="emphasis"> 6006 <em>QCG Notification 6007 </em> 6008 </span>. 6009 </p> 6010 </div> 6011 </div> 6012 <div class="sect2" title="Building"> 6013 <div class="titlepage"> 6014 <div> 6015 <div> 6016 <h3 class="title"> 6017 <a id="idp666256"/>Building 6018 </h3> 6019 </div> 6020 </div> 6021 </div> 6022 <p>Before you compile 6023 <span class="emphasis"> 6024 <em>QCG Notification 6025 </em> 6026 </span>, you need 1720 6027 to run the configuration script first. It will try to check if all the 1721 6028 requirements are met and whether needed third party software is 1722 available. Simply type the following command:</p><pre class="programlisting">$ ./configure</pre><p>There are several options that can be passed to the script. If you 6029 available. Simply type the following command: 6030 </p> 6031 <pre class="programlisting">$ ./configure 6032 </pre> 6033 <p>There are several options that can be passed to the script. If you 1723 6034 type the --help parameter you will see all available options. These are 1724 the most important ones:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>--prefix=DIR</p><p>specifies directory where <span class="emphasis"><em>QCG 1725 Notification</em></span> will be installed.</p><p>Default: /opt/qcg</p></li><li class="listitem"><p>--with-qcg-core=PFX</p><p>specifies where QCG Core library is installed.</p><p>Default: no default value. qcg-core-config script is used to 1726 determine necessary paths</p></li><li class="listitem"><p>--with-client</p><p>Determine if the test client program should be build</p></li><li class="listitem"><p>--with-consumer</p><p>Determine if the test NotificationConsumer service should be 1727 build</p></li><li class="listitem"><p>--with-addressing-handler</p><p>Determine if the test Web Services Addressing handler 1728 service should be build</p></li></ul></div><p>After successful configuration step, compiling and 1729 installing of <span class="emphasis"><em>QCG Notification</em></span> should be a 1730 straightforward process:</p><pre class="programlisting">$ make 1731 $ make install</pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The installation step should be done either as 1732 <code class="filename">root</code> or the user that will execute <span class="emphasis"><em>QCG 1733 Notification</em></span> service, assuming he has necessary privileges 1734 to do this.</p></div></div><div class="sect2" title="Creating database for QCG Notification - the PostgreSQL example"><div class="titlepage"><div><div><h3 class="title"><a id="idp677424"/>Creating database for <span class="emphasis"><em>QCG Notification</em></span> - the 1735 PostgreSQL example</h3></div></div></div><p><span class="emphasis"><em>QCG Notification</em></span> can be run in two basic 6035 the most important ones: 6036 </p> 6037 <div class="itemizedlist"> 6038 <ul class="itemizedlist"> 6039 <li class="listitem"> 6040 <p>--prefix=DIR 6041 </p> 6042 <p>specifies directory where 6043 <span class="emphasis"> 6044 <em>QCG 6045 Notification 6046 </em> 6047 </span> will be installed. 6048 </p> 6049 <p>Default: /opt/qcg 6050 </p> 6051 </li> 6052 <li class="listitem"> 6053 <p>--with-qcg-core=PFX 6054 </p> 6055 <p>specifies where QCG Core library is installed. 6056 </p> 6057 <p>Default: no default value. qcg-core-config script is used to 6058 determine necessary paths 6059 </p> 6060 </li> 6061 <li class="listitem"> 6062 <p>--with-client 6063 </p> 6064 <p>Determine if the test client program should be build 6065 </p> 6066 </li> 6067 <li class="listitem"> 6068 <p>--with-consumer 6069 </p> 6070 <p>Determine if the test NotificationConsumer service should be 6071 build 6072 </p> 6073 </li> 6074 <li class="listitem"> 6075 <p>--with-addressing-handler 6076 </p> 6077 <p>Determine if the test Web Services Addressing handler 6078 service should be build 6079 </p> 6080 </li> 6081 </ul> 6082 </div> 6083 <p>After successful configuration step, compiling and 6084 installing of 6085 <span class="emphasis"> 6086 <em>QCG Notification 6087 </em> 6088 </span> should be a 6089 straightforward process: 6090 </p> 6091 <pre class="programlisting">$ make 6092 $ make install 6093 </pre> 6094 <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"> 6095 <h3 class="title">Note 6096 </h3> 6097 <p>The installation step should be done either as 6098 6099 <code class="filename">root 6100 </code> or the user that will execute 6101 <span class="emphasis"> 6102 <em>QCG 6103 Notification 6104 </em> 6105 </span> service, assuming he has necessary privileges 6106 to do this. 6107 </p> 6108 </div> 6109 </div> 6110 <div class="sect2" title="Creating database for QCG Notification - the PostgreSQL example"> 6111 <div class="titlepage"> 6112 <div> 6113 <div> 6114 <h3 class="title"> 6115 <a id="idp681984"/>Creating database for 6116 <span class="emphasis"> 6117 <em>QCG Notification 6118 </em> 6119 </span> - the 6120 PostgreSQL example 6121 </h3> 6122 </div> 6123 </div> 6124 </div> 6125 <p> 6126 <span class="emphasis"> 6127 <em>QCG Notification 6128 </em> 6129 </span> can be run in two basic 1736 6130 modes related to the database connection: without database or with 1737 6131 database. Although the first option is sufficient for simple scenarios, 1738 it reduces the overall functionality of the <span class="emphasis"><em>QCG 1739 Notification</em></span> (e.g. disable PullPoints). Therefore using the 1740 database is recomended and can be often essential.</p><p>You will find more detailed description of administrative tasks in 6132 it reduces the overall functionality of the 6133 <span class="emphasis"> 6134 <em>QCG 6135 Notification 6136 </em> 6137 </span> (e.g. disable PullPoints). Therefore using the 6138 database is recomended and can be often essential. 6139 </p> 6140 <p>You will find more detailed description of administrative tasks in 1741 6141 PostgreSQL tutorial. However, the following basic steps are needed to 1742 set up a database and appropriate tables for <span class="emphasis"><em>QCG 1743 Notification</em></span> assuming that you have already setup a 1744 PostgreSQL database:</p><p>By default, the first database user created will also be named 1745 <code class="filename">postgres</code>. In order to create a user for 1746 <span class="emphasis"><em>QCG Notification</em></span> usage, for instance 1747 <code class="filename">qcg-ntf</code>, type the following:</p><pre class="programlisting">$ createuser -U postgres -W qcg-ntf -P</pre><p>If you use a password then remember to supply it in 1748 <code class="filename">qcg-ntfd.xml</code> configuration file. Create a database, 1749 for example <code class="filename">qcg-ntf</code>, by typing the following 1750 command:</p><pre class="programlisting">$ createdb qcg-ntf</pre><p>and set up a table structure using the 1751 <code class="filename">qcg-ntf-psql.sql</code> file from <span class="emphasis"><em>QCG 1752 Notification</em></span> distribution - it can be found in 1753 <code class="filename">/opt/qcg/share/tools</code> directory by default.</p><pre class="programlisting">$ psql -d qcg-ntf -U qcg-ntf < qcg-ntf-psql.sql</pre><p>Eventually you need to add this database as the ODBC Data Source 6142 set up a database and appropriate tables for 6143 <span class="emphasis"> 6144 <em>QCG 6145 Notification 6146 </em> 6147 </span> assuming that you have already setup a 6148 PostgreSQL database: 6149 </p> 6150 <p>By default, the first database user created will also be named 6151 6152 <code class="filename">postgres 6153 </code>. In order to create a user for 6154 6155 <span class="emphasis"> 6156 <em>QCG Notification 6157 </em> 6158 </span> usage, for instance 6159 6160 <code class="filename">qcg-ntf 6161 </code>, type the following: 6162 </p> 6163 <pre class="programlisting">$ createuser -U postgres -W qcg-ntf -P 6164 </pre> 6165 <p>If you use a password then remember to supply it in 6166 6167 <code class="filename">qcg-ntfd.xml 6168 </code> configuration file. Create a database, 6169 for example 6170 <code class="filename">qcg-ntf 6171 </code>, by typing the following 6172 command: 6173 </p> 6174 <pre class="programlisting">$ createdb qcg-ntf 6175 </pre> 6176 <p>and set up a table structure using the 6177 6178 <code class="filename">qcg-ntf-psql.sql 6179 </code> file from 6180 <span class="emphasis"> 6181 <em>QCG 6182 Notification 6183 </em> 6184 </span> distribution - it can be found in 6185 6186 <code class="filename">/opt/qcg/share/tools 6187 </code> directory by default. 6188 </p> 6189 <pre class="programlisting">$ psql -d qcg-ntf -U qcg-ntf < qcg-ntf-psql.sql 6190 </pre> 6191 <p>Eventually you need to add this database as the ODBC Data Source 1754 6192 Name. You can do this by editing system-wide configuration file (e.g. 1755 <code class="filename">/etc/odbc.ini)</code> or <code class="filename">.odbc.ini</code> in 1756 home directory of the user that will be used to start <span class="emphasis"><em>QCG 1757 Notification</em></span>.</p><p>Assuming that ODBC are installed in /usr/local/lib and the choosed 1758 name for <span class="emphasis"><em>QCG Notification</em></span> is 1759 <code class="filename">qcg-ntf</code> the configuration file should looks 1760 simmilar to the following:</p><pre class="programlisting">[qcg-ntf] 6193 6194 <code class="filename">/etc/odbc.ini) 6195 </code> or 6196 <code class="filename">.odbc.ini 6197 </code> in 6198 home directory of the user that will be used to start 6199 <span class="emphasis"> 6200 <em>QCG 6201 Notification 6202 </em> 6203 </span>. 6204 </p> 6205 <p>Assuming that ODBC are installed in /usr/local/lib and the choosed 6206 name for 6207 <span class="emphasis"> 6208 <em>QCG Notification 6209 </em> 6210 </span> is 6211 6212 <code class="filename">qcg-ntf 6213 </code> the configuration file should looks 6214 simmilar to the following: 6215 </p> 6216 <pre class="programlisting">[qcg-ntf] 1761 6217 Description = QCG Notification database 1762 6218 Driver = /usr/local/lib/libodbcpsql.so … … 1769 6225 TraceFile = odbc.trace 1770 6226 Debug = 0 1771 DebugFile = odbc.debug</pre><p>You can also try some GUI tools to set up and manage ODBC and 6227 DebugFile = odbc.debug 6228 </pre> 6229 <p>You can also try some GUI tools to set up and manage ODBC and 1772 6230 databases. Check out if the following tools are available on your 1773 machine:</p><pre class="programlisting">$ DataManager</pre><pre class="programlisting">$ ODBCConfig</pre></div></div><div class="sect1" title="Configuration of QCG Notification"><div class="titlepage"><div><div><h2 class="title"><a id="idp698528"/>Configuration of <span class="emphasis"><em>QCG Notification</em></span></h2></div></div></div><div class="sect2" title="Configuration File: qcg-ntfd.xml"><div class="titlepage"><div><div><h3 class="title"><a id="idp699840"/>Configuration File: <code class="filename">qcg-ntfd.xml</code></h3></div></div></div><pre class="programlisting"><sm:QCGCore 6231 machine: 6232 </p> 6233 <pre class="programlisting">$ DataManager 6234 </pre> 6235 <pre class="programlisting">$ ODBCConfig 6236 </pre> 6237 </div> 6238 </div> 6239 <div class="sect1" title="Configuration of QCG Notification"> 6240 <div class="titlepage"> 6241 <div> 6242 <div> 6243 <h2 class="title"> 6244 <a id="idp703040"/>Configuration of 6245 <span class="emphasis"> 6246 <em>QCG Notification 6247 </em> 6248 </span> 6249 </h2> 6250 </div> 6251 </div> 6252 </div> 6253 <div class="sect2" title="Configuration File: qcg-ntfd.xml"> 6254 <div class="titlepage"> 6255 <div> 6256 <div> 6257 <h3 class="title"> 6258 <a id="idp704272"/>Configuration File: 6259 <code class="filename">qcg-ntfd.xml 6260 </code> 6261 </h3> 6262 </div> 6263 </div> 6264 </div> 6265 <pre class="programlisting"><sm:QCGCore 1774 6266 xmlns:sm="http://schemas.qoscosgrid.org/core/2011/04/config" 1775 6267 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/config" … … 1860 6352 1861 6353 </Configuration> 1862 </sm:QCGCore></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="emphasis"><em>//sm:ModuleManager/sm:Directory 1863 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Directories with modules that will be used in the 1864 service.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service 1865 <span class="emphasis"><em>[sm:QCGBaseServiceType]</em></span></em></span></p><p>Configuration of the services. It is possible to configure 1866 many instances of the service in the one configuration file.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Logger</em></span> 1867 [sm:LoggerType]</p><p>Configuration of the logging.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Logger/sm:FileName 1868 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A log file path.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Logger/sm:Level 1869 <span class="emphasis"><em>[enumeration]</em></span></em></span></p><p>DEBUG, INFO, NOTICE, WARNING, ERROR, CRIT, EMERG - filter less 1870 important messages.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Transport</em></span> 1871 [sm:TransportType]</p><p>This element aggregates configuration of transport modules. At 6354 </sm:QCGCore> 6355 </pre> 6356 <div class="itemizedlist"> 6357 <ul class="itemizedlist"> 6358 <li class="listitem"> 6359 <p> 6360 <span class="emphasis"> 6361 <em>//sm:ModuleManager/sm:Directory 6362 6363 <span class="emphasis"> 6364 <em>[string] 6365 </em> 6366 </span> 6367 </em> 6368 </span> 6369 </p> 6370 <p>Directories with modules that will be used in the 6371 service. 6372 </p> 6373 </li> 6374 <li class="listitem"> 6375 <p> 6376 <span class="emphasis"> 6377 <em>//sm:Service 6378 6379 <span class="emphasis"> 6380 <em>[sm:QCGBaseServiceType] 6381 </em> 6382 </span> 6383 </em> 6384 </span> 6385 </p> 6386 <p>Configuration of the services. It is possible to configure 6387 many instances of the service in the one configuration file. 6388 </p> 6389 </li> 6390 <li class="listitem"> 6391 <p> 6392 <span class="emphasis"> 6393 <em>//sm:Service/sm:Logger 6394 </em> 6395 </span> 6396 [sm:LoggerType] 6397 </p> 6398 <p>Configuration of the logging. 6399 </p> 6400 </li> 6401 <li class="listitem"> 6402 <p> 6403 <span class="emphasis"> 6404 <em>//sm:Service/sm:Logger/sm:FileName 6405 6406 <span class="emphasis"> 6407 <em>[string] 6408 </em> 6409 </span> 6410 </em> 6411 </span> 6412 </p> 6413 <p>A log file path. 6414 </p> 6415 </li> 6416 <li class="listitem"> 6417 <p> 6418 <span class="emphasis"> 6419 <em>//sm:Service/sm:Logger/sm:Level 6420 6421 <span class="emphasis"> 6422 <em>[enumeration] 6423 </em> 6424 </span> 6425 </em> 6426 </span> 6427 </p> 6428 <p>DEBUG, INFO, NOTICE, WARNING, ERROR, CRIT, EMERG - filter less 6429 important messages. 6430 </p> 6431 </li> 6432 <li class="listitem"> 6433 <p> 6434 <span class="emphasis"> 6435 <em>//sm:Service/sm:Transport 6436 </em> 6437 </span> 6438 [sm:TransportType] 6439 </p> 6440 <p>This element aggregates configuration of transport modules. At 1872 6441 least one module of type ecm* should by specified in this place. For 1873 6442 full list of supported ecm* modules see the QCG Core 1874 documentation</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Transport/sm:Module[@type=sm:ecm_gsoap.service]</em></span></p><p>Basic configuration of the Web Service interface. The most 6443 documentation 6444 </p> 6445 </li> 6446 <li class="listitem"> 6447 <p> 6448 <span class="emphasis"> 6449 <em>//sm:Service/sm:Transport/sm:Module[@type=sm:ecm_gsoap.service] 6450 </em> 6451 </span> 6452 </p> 6453 <p>Basic configuration of the Web Service interface. The most 1875 6454 important configuration covers such aspects as host and port where 1876 6455 the service will be listening. The instruction of using other 1877 options is located in QCG Core documentation.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Transport/sm:Module[@type=smn:ntf-service-gsoap]</em></span></p><p>Define ntf-service-gsoap module as a default module for the 1878 service. This option shouldn't be changed.</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Authentication</em></span> 1879 [sm:AuthenticationType]</p><p>Configuration of authentication modules for the service. For 6456 options is located in QCG Core documentation. 6457 </p> 6458 </li> 6459 <li class="listitem"> 6460 <p> 6461 <span class="emphasis"> 6462 <em>//sm:Service/sm:Transport/sm:Module[@type=smn:ntf-service-gsoap] 6463 </em> 6464 </span> 6465 </p> 6466 <p>Define ntf-service-gsoap module as a default module for the 6467 service. This option shouldn't be changed. 6468 </p> 6469 </li> 6470 <li class="listitem"> 6471 <p> 6472 <span class="emphasis"> 6473 <em>//sm:Service/sm:Authentication 6474 </em> 6475 </span> 6476 [sm:AuthenticationType] 6477 </p> 6478 <p>Configuration of authentication modules for the service. For 1880 6479 full list of supported authentication modules see the QCG Core 1881 6480 documentation (the most basic are: sm:atc_transport_http for 1882 6481 anonymous communication and sm:atc_transport_https for SSL based 1883 communication).</p></li><li class="listitem"><p><span class="emphasis"><em>//sm:Service/sm:Module/[@type=smn:ntf-publisher*]</em></span></p><p>Initialization and configuration of the modules for the 1884 Publisher side of <span class="emphasis"><em>QCG Notification</em></span>. The 1885 following modules are currently supported:</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>smn:ntf-publisher-gsoap-anonymous for anonymous SOAP 1886 communication;</p></li><li class="listitem"><p>smn:ntf-publisher-gsoap-ssl for SSL based SOAP 1887 communication;</p></li><li class="listitem"><p>smn:ntf-publisher-xmpp for XMPP communication;</p></li><li class="listitem"><p>smn:ntf-publisher-smtp for SMTP communication;</p></li></ul></div><p>For details see the <a class="link" href="#moduleoptions" title="Module configuration">Section 1888 5.2</a>.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar 1889 </em></span>[smn:NotificationsVarType]</p><p>Various notification settings closely related to QCG 1890 Notification service implementation.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:TopicNsDir 1891 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Location of the directory with files containing Topic 1892 definitions.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:StrictCorrectnessCheckingEnabled</em></span> 1893 [boolean]</p><p>true, false - determines a strict validation of incoming 6482 communication). 6483 </p> 6484 </li> 6485 <li class="listitem"> 6486 <p> 6487 <span class="emphasis"> 6488 <em>//sm:Service/sm:Module/[@type=smn:ntf-publisher*] 6489 </em> 6490 </span> 6491 </p> 6492 <p>Initialization and configuration of the modules for the 6493 Publisher side of 6494 <span class="emphasis"> 6495 <em>QCG Notification 6496 </em> 6497 </span>. The 6498 following modules are currently supported: 6499 </p> 6500 <div class="itemizedlist"> 6501 <ul class="itemizedlist"> 6502 <li class="listitem"> 6503 <p>smn:ntf-publisher-gsoap-anonymous for anonymous SOAP 6504 communication; 6505 </p> 6506 </li> 6507 <li class="listitem"> 6508 <p>smn:ntf-publisher-gsoap-ssl for SSL based SOAP 6509 communication; 6510 </p> 6511 </li> 6512 <li class="listitem"> 6513 <p>smn:ntf-publisher-xmpp for XMPP communication; 6514 </p> 6515 </li> 6516 <li class="listitem"> 6517 <p>smn:ntf-publisher-smtp for SMTP communication; 6518 </p> 6519 </li> 6520 </ul> 6521 </div> 6522 <p>For details see the 6523 <a class="link" href="#moduleoptions" title="Module configuration">Section 6524 5.2 6525 </a>. 6526 </p> 6527 </li> 6528 <li class="listitem"> 6529 <p> 6530 <span class="emphasis"> 6531 <em>//smn:Core/smn:NotificationsVar 6532 6533 </em> 6534 </span>[smn:NotificationsVarType] 6535 </p> 6536 <p>Various notification settings closely related to QCG 6537 Notification service implementation. 6538 </p> 6539 </li> 6540 <li class="listitem"> 6541 <p> 6542 <span class="emphasis"> 6543 <em>//smn:Core/smn:NotificationsVar/smn:TopicNsDir 6544 6545 <span class="emphasis"> 6546 <em>[string] 6547 </em> 6548 </span> 6549 </em> 6550 </span> 6551 </p> 6552 <p>Location of the directory with files containing Topic 6553 definitions. 6554 </p> 6555 </li> 6556 <li class="listitem"> 6557 <p> 6558 <span class="emphasis"> 6559 <em>//smn:Core/smn:NotificationsVar/smn:StrictCorrectnessCheckingEnabled 6560 </em> 6561 </span> 6562 [boolean] 6563 </p> 6564 <p>true, false - determines a strict validation of incoming 1894 6565 messages; if true, it allows receiving detailed information about 1895 6566 faults but it causes greatest delays; if false, then faults 1896 processing is minimal and delays are smaller. Default: false</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:DisableCurrentMessages</em></span> 1897 [boolean]</p><p>true, false - enable or disable support for CurrentMessages; 6567 processing is minimal and delays are smaller. Default: false 6568 </p> 6569 </li> 6570 <li class="listitem"> 6571 <p> 6572 <span class="emphasis"> 6573 <em>//smn:Core/smn:NotificationsVar/smn:DisableCurrentMessages 6574 </em> 6575 </span> 6576 [boolean] 6577 </p> 6578 <p>true, false - enable or disable support for CurrentMessages; 1898 6579 If set to true, the last notification messages wouldn't be stored in 1899 6580 a buffer for the gathering by the GetCurrentMessage method. Default: 1900 false</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/ 1901 </em></span>[smn:SubscriptionManagerType]</p><p>Settings related to Subscriptions management.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:ContentFilteringEnabled</em></span> 1902 [boolean]</p><p>true, false - determines if a content filtering of 6581 false 6582 </p> 6583 </li> 6584 <li class="listitem"> 6585 <p> 6586 <span class="emphasis"> 6587 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/ 6588 6589 </em> 6590 </span>[smn:SubscriptionManagerType] 6591 </p> 6592 <p>Settings related to Subscriptions management. 6593 </p> 6594 </li> 6595 <li class="listitem"> 6596 <p> 6597 <span class="emphasis"> 6598 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:ContentFilteringEnabled 6599 </em> 6600 </span> 6601 [boolean] 6602 </p> 6603 <p>true, false - determines if a content filtering of 1903 6604 notification messages can be used; if true, Subscribers can specify 1904 6605 content filters in their Subscriptions, if false, it is disallowed. 1905 Default: true</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPolicy</em></span> 1906 [enumeration]</p><p>DUPLICATE, DELETE_OLD, RETURN_FAULT - parameter defines an 6606 Default: true 6607 </p> 6608 </li> 6609 <li class="listitem"> 6610 <p> 6611 <span class="emphasis"> 6612 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPolicy 6613 </em> 6614 </span> 6615 [enumeration] 6616 </p> 6617 <p>DUPLICATE, DELETE_OLD, RETURN_FAULT - parameter defines an 1907 6618 action which should be taken when a Subscriber wants to create a 1908 6619 Subscription with the same parameters as the parameters of already 1909 existing Subscription. Default: <span class="bold"><strong>DELETE_OLD 1910 (before the version 2.6.2 it was DUPLICATE)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:DialectConsistencyRequired</em></span> 1911 [boolean]</p><p>true, false - determines if a Subscription covers the Notify 6620 existing Subscription. Default: 6621 <span class="bold"> 6622 <strong>DELETE_OLD 6623 (before the version 2.6.2 it was DUPLICATE) 6624 </strong> 6625 </span> 6626 </p> 6627 </li> 6628 <li class="listitem"> 6629 <p> 6630 <span class="emphasis"> 6631 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:DialectConsistencyRequired 6632 </em> 6633 </span> 6634 [boolean] 6635 </p> 6636 <p>true, false - determines if a Subscription covers the Notify 1912 6637 messages with a different Topics Dialect than the Topic Dialect of 1913 6638 the Subscription; if true, the Subscription covers only Notify … … 1915 6640 Notify messages with simpler Dialects (i.e. Subscription with Full 1916 6641 type of Dialect covers notifications sent with Concrete or Simple 1917 type). Default: true</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPeriod</em></span> 1918 [integer]</p><p>A default time period for a Subscription to be valid; in 6642 type). Default: true 6643 </p> 6644 </li> 6645 <li class="listitem"> 6646 <p> 6647 <span class="emphasis"> 6648 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPeriod 6649 </em> 6650 </span> 6651 [integer] 6652 </p> 6653 <p>A default time period for a Subscription to be valid; in 1919 6654 minutes; if negative the Subscription time checking will be 1920 disabled. Default: <span class="bold"><strong>43200 (before the version 1921 2.6.2 it was 10)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:RefreshRate</em></span> 1922 [integer]</p><p>A time period between successive Subscription Manager 6655 disabled. Default: 6656 <span class="bold"> 6657 <strong>43200 (before the version 6658 2.6.2 it was 10) 6659 </strong> 6660 </span> 6661 </p> 6662 </li> 6663 <li class="listitem"> 6664 <p> 6665 <span class="emphasis"> 6666 <em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:RefreshRate 6667 </em> 6668 </span> 6669 [integer] 6670 </p> 6671 <p>A time period between successive Subscription Manager 1923 6672 refreshing events (events when outdated Subscriptions are deleted); 1924 6673 the time period is measured in seconds; if value is set to 0 or 1925 6674 negative then the periodical refreshing is disabled. Default: 1926 3600</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/ 1927 </em></span>[smn:PublisherManagerType]</p><p>Settings related to Publishers management.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationRequired</em></span> 1928 [boolean]</p><p>true, false - determines a requirement of Publishers 6675 3600 6676 </p> 6677 </li> 6678 <li class="listitem"> 6679 <p> 6680 <span class="emphasis"> 6681 <em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/ 6682 6683 </em> 6684 </span>[smn:PublisherManagerType] 6685 </p> 6686 <p>Settings related to Publishers management. 6687 </p> 6688 </li> 6689 <li class="listitem"> 6690 <p> 6691 <span class="emphasis"> 6692 <em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationRequired 6693 </em> 6694 </span> 6695 [boolean] 6696 </p> 6697 <p>true, false - determines a requirement of Publishers 1929 6698 Registrations; if true, a Publisher has to register himself before 1930 sending notifications; if false, it has not. Default: false</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationPeriod</em></span> 1931 [integer]</p><p>A default time period for a Publisher Registration to be 6699 sending notifications; if false, it has not. Default: false 6700 </p> 6701 </li> 6702 <li class="listitem"> 6703 <p> 6704 <span class="emphasis"> 6705 <em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationPeriod 6706 </em> 6707 </span> 6708 [integer] 6709 </p> 6710 <p>A default time period for a Publisher Registration to be 1932 6711 valid; in minutes; if negative the Registration time checking will 1933 be disabled. <span class="bold"><strong>Default: 43200 (before the 1934 version 2.6.2 it was 10)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RefreshRate</em></span> 1935 [integer]</p><p>A time period between successive Publisher Manager refreshing 6712 be disabled. 6713 <span class="bold"> 6714 <strong>Default: 43200 (before the 6715 version 2.6.2 it was 10) 6716 </strong> 6717 </span> 6718 </p> 6719 </li> 6720 <li class="listitem"> 6721 <p> 6722 <span class="emphasis"> 6723 <em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RefreshRate 6724 </em> 6725 </span> 6726 [integer] 6727 </p> 6728 <p>A time period between successive Publisher Manager refreshing 1936 6729 events (events when outdated Publishers are deleted); the time 1937 6730 period is measured in seconds; if value is set to 0 or negative then 1938 the periodical refreshing is disabled. Default: 3600</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/ 1939 </em></span>[smn:PullPointManagerType]</p><p>Settings related to PullPoints management.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointsEnabled 1940 <span class="emphasis"><em>[boolean]</em></span></em></span></p><p>true, false - determines if PullPoints for pull style of 1941 notifications can be used. Default: true</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointSize</em></span> 1942 [integer]</p><p>A maximal number of messages that can be buffered in a single 6731 the periodical refreshing is disabled. Default: 3600 6732 </p> 6733 </li> 6734 <li class="listitem"> 6735 <p> 6736 <span class="emphasis"> 6737 <em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/ 6738 6739 </em> 6740 </span>[smn:PullPointManagerType] 6741 </p> 6742 <p>Settings related to PullPoints management. 6743 </p> 6744 </li> 6745 <li class="listitem"> 6746 <p> 6747 <span class="emphasis"> 6748 <em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointsEnabled 6749 6750 <span class="emphasis"> 6751 <em>[boolean] 6752 </em> 6753 </span> 6754 </em> 6755 </span> 6756 </p> 6757 <p>true, false - determines if PullPoints for pull style of 6758 notifications can be used. Default: true 6759 </p> 6760 </li> 6761 <li class="listitem"> 6762 <p> 6763 <span class="emphasis"> 6764 <em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointSize 6765 </em> 6766 </span> 6767 [integer] 6768 </p> 6769 <p>A maximal number of messages that can be buffered in a single 1943 6770 PullPoint; if negative then the number of messages is unbounded. 1944 Default: <span class="bold"><strong>1000 (before the version 2.6.2 it was 1945 100)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointPeriod</em></span> 1946 [integer]</p><p>A default time period for a PullPoint to be valid; in minutes; 6771 Default: 6772 <span class="bold"> 6773 <strong>1000 (before the version 2.6.2 it was 6774 100) 6775 </strong> 6776 </span> 6777 </p> 6778 </li> 6779 <li class="listitem"> 6780 <p> 6781 <span class="emphasis"> 6782 <em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointPeriod 6783 </em> 6784 </span> 6785 [integer] 6786 </p> 6787 <p>A default time period for a PullPoint to be valid; in minutes; 1947 6788 if negative the PullPoint time checking will be disabled. Default: 1948 <span class="bold"><strong>43200 (before the version 2.6.2 it was 1949 10)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:RefreshRate</em></span> 1950 [integer]</p><p>A time period between successive PullPoint Manager refreshing 6789 6790 <span class="bold"> 6791 <strong>43200 (before the version 2.6.2 it was 6792 10) 6793 </strong> 6794 </span> 6795 </p> 6796 </li> 6797 <li class="listitem"> 6798 <p> 6799 <span class="emphasis"> 6800 <em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:RefreshRate 6801 </em> 6802 </span> 6803 [integer] 6804 </p> 6805 <p>A time period between successive PullPoint Manager refreshing 1951 6806 events (events when outdated PullPoints are deleted); the time 1952 6807 period is measured in seconds; if value is set to 0 or negative then 1953 the periodical refreshing is disabled. Default: 3600</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/ 1954 </em></span>[smn:PublishingType]</p><p>A group of settings related to Publishing procedure.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferEnabled 1955 </em></span>[boolean]</p><p>true, false - determines if Notifications Buffer should be 6808 the periodical refreshing is disabled. Default: 3600 6809 </p> 6810 </li> 6811 <li class="listitem"> 6812 <p> 6813 <span class="emphasis"> 6814 <em>//smn:Core/smn:NotificationsVar/smn:Publishing/ 6815 6816 </em> 6817 </span>[smn:PublishingType] 6818 </p> 6819 <p>A group of settings related to Publishing procedure. 6820 </p> 6821 </li> 6822 <li class="listitem"> 6823 <p> 6824 <span class="emphasis"> 6825 <em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferEnabled 6826 6827 </em> 6828 </span>[boolean] 6829 </p> 6830 <p>true, false - determines if Notifications Buffer should be 1956 6831 enabled; Notifications Buffer is used for resending Notifications if 1957 6832 those weren't sent successfully at the first attempt. Default: 1958 true</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferSize 1959 </em></span>[integer]</p><p>A maximal number of Notifications that can be buffered in 1960 Notifications Buffer. Default: <span class="bold"><strong>10000 (before 1961 the version 2.6.2 it was 1000)</strong></span></p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsResendingRate 1962 </em></span>[integer]</p><p>A time period between successive notification resending 6833 true 6834 </p> 6835 </li> 6836 <li class="listitem"> 6837 <p> 6838 <span class="emphasis"> 6839 <em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferSize 6840 6841 </em> 6842 </span>[integer] 6843 </p> 6844 <p>A maximal number of Notifications that can be buffered in 6845 Notifications Buffer. Default: 6846 <span class="bold"> 6847 <strong>10000 (before 6848 the version 2.6.2 it was 1000) 6849 </strong> 6850 </span> 6851 </p> 6852 </li> 6853 <li class="listitem"> 6854 <p> 6855 <span class="emphasis"> 6856 <em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsResendingRate 6857 6858 </em> 6859 </span>[integer] 6860 </p> 6861 <p>A time period between successive notification resending 1963 6862 procedures; in seconds; if 0 or negative then the resending will be 1964 disabled. Default: 60</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:MaxSendTries</em></span> 1965 [integer]</p><p>A maximal number of consecutive unsuccessful tries of sending 6863 disabled. Default: 60 6864 </p> 6865 </li> 6866 <li class="listitem"> 6867 <p> 6868 <span class="emphasis"> 6869 <em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:MaxSendTries 6870 </em> 6871 </span> 6872 [integer] 6873 </p> 6874 <p>A maximal number of consecutive unsuccessful tries of sending 1966 6875 notification; unsuccessful tries of sending notifications are 1967 6876 counted independently for every Subscription; a certain Subscription 1968 6877 will be delayed if its counter become equal to 1969 <span class="emphasis"><em>MaxSendTries</em></span>; if value is set to 0 or negative 1970 then this option is disabled. Default: 5</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/Database/DatabaseEnabled 1971 <span class="emphasis"><em>[boolean]</em></span></em></span></p><p>true, false - determines if a database should be enabled; in 1972 the simplest configuration, <span class="emphasis"><em>QCG Notification</em></span> 6878 6879 <span class="emphasis"> 6880 <em>MaxSendTries 6881 </em> 6882 </span>; if value is set to 0 or negative 6883 then this option is disabled. Default: 5 6884 </p> 6885 </li> 6886 <li class="listitem"> 6887 <p> 6888 <span class="emphasis"> 6889 <em>//smn:Core/Database/DatabaseEnabled 6890 6891 <span class="emphasis"> 6892 <em>[boolean] 6893 </em> 6894 </span> 6895 </em> 6896 </span> 6897 </p> 6898 <p>true, false - determines if a database should be enabled; in 6899 the simplest configuration, 6900 <span class="emphasis"> 6901 <em>QCG Notification 6902 </em> 6903 </span> 1973 6904 can be used also without a database connection, however many options 1974 will be then unavailable. Default: true</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/Database/DSN 1975 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Data Source Name of a database. Note, that you should use ODBC 1976 DSN <span class="bold"><strong>not</strong></span> the database name.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/Database/User 1977 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A database user name.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/Database/Password 1978 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A password for a database user.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Core/Database/CleanAtStart 1979 <span class="emphasis"><em>[boolean]</em></span></em></span></p><p>true, false - determines whether all information stored in a 6905 will be then unavailable. Default: true 6906 </p> 6907 </li> 6908 <li class="listitem"> 6909 <p> 6910 <span class="emphasis"> 6911 <em>//smn:Core/Database/DSN 6912 6913 <span class="emphasis"> 6914 <em>[string] 6915 </em> 6916 </span> 6917 </em> 6918 </span> 6919 </p> 6920 <p>Data Source Name of a database. Note, that you should use ODBC 6921 DSN 6922 <span class="bold"> 6923 <strong>not 6924 </strong> 6925 </span> the database name. 6926 </p> 6927 </li> 6928 <li class="listitem"> 6929 <p> 6930 <span class="emphasis"> 6931 <em>//smn:Core/Database/User 6932 6933 <span class="emphasis"> 6934 <em>[string] 6935 </em> 6936 </span> 6937 </em> 6938 </span> 6939 </p> 6940 <p>A database user name. 6941 </p> 6942 </li> 6943 <li class="listitem"> 6944 <p> 6945 <span class="emphasis"> 6946 <em>//smn:Core/Database/Password 6947 6948 <span class="emphasis"> 6949 <em>[string] 6950 </em> 6951 </span> 6952 </em> 6953 </span> 6954 </p> 6955 <p>A password for a database user. 6956 </p> 6957 </li> 6958 <li class="listitem"> 6959 <p> 6960 <span class="emphasis"> 6961 <em>//smn:Core/Database/CleanAtStart 6962 6963 <span class="emphasis"> 6964 <em>[boolean] 6965 </em> 6966 </span> 6967 </em> 6968 </span> 6969 </p> 6970 <p>true, false - determines whether all information stored in a 1980 6971 database should be cleaned at starting of the QCG Notification 1981 service.</p></li></ul></div></div><div class="sect2" title="Module configuration"><div class="titlepage"><div><div><h3 class="title"><a id="moduleoptions"/>Module configuration</h3></div></div></div><p>Modules are located in the PREFIX/*/lib/modules directories and 1982 are loaded during the<span class="emphasis"><em> QCG Notification</em></span> run time. 6972 service. 6973 </p> 6974 </li> 6975 </ul> 6976 </div> 6977 </div> 6978 <div class="sect2" title="Module configuration"> 6979 <div class="titlepage"> 6980 <div> 6981 <div> 6982 <h3 class="title"> 6983 <a id="moduleoptions"/>Module configuration 6984 </h3> 6985 </div> 6986 </div> 6987 </div> 6988 <p>Modules are located in the PREFIX/*/lib/modules directories and 6989 are loaded during the 6990 <span class="emphasis"> 6991 <em> QCG Notification 6992 </em> 6993 </span> run time. 1983 6994 Module definitions are specified in appropriate sections of the 1984 configuration file.</p><div class="sect3" title="Publisher modules"><div class="titlepage"><div><div><h4 class="title"><a id="idp791232"/>Publisher modules</h4></div></div></div><p>As it was discussed in the previous sections, in a typical 6995 configuration file. 6996 </p> 6997 <div class="sect3" title="Publisher modules"> 6998 <div class="titlepage"> 6999 <div> 7000 <div> 7001 <h4 class="title"> 7002 <a id="idp795952"/>Publisher modules 7003 </h4> 7004 </div> 7005 </div> 7006 </div> 7007 <p>As it was discussed in the previous sections, in a typical 1985 7008 brokered notification scenario there are two types of communication 1986 7009 and notification channels that need to be setup. The first one is a 1987 7010 communication channel between Subscriber/Publisher clients and 1988 <span class="emphasis"><em>QCG Notification. </em></span>This type of communication is 1989 currently completely based on QCG Core library.</p><p>The second type is an outgoing communication between 1990 <span class="emphasis"><em>QCG Notification</em></span> and NotificationConsumers and it 1991 is particular for <span class="emphasis"><em>QCG Notification</em></span>. In this 1992 situation <span class="emphasis"><em>QCG Notification</em></span> plays a role of a 7011 7012 <span class="emphasis"> 7013 <em>QCG Notification. 7014 </em> 7015 </span>This type of communication is 7016 currently completely based on QCG Core library. 7017 </p> 7018 <p>The second type is an outgoing communication between 7019 7020 <span class="emphasis"> 7021 <em>QCG Notification 7022 </em> 7023 </span> and NotificationConsumers and it 7024 is particular for 7025 <span class="emphasis"> 7026 <em>QCG Notification 7027 </em> 7028 </span>. In this 7029 situation 7030 <span class="emphasis"> 7031 <em>QCG Notification 7032 </em> 7033 </span> plays a role of a 1993 7034 Notification Publisher. At this time, supported modules for this 1994 7035 channel utilize a Web Service interface, XMPP interface and SMTP 1995 interface.</p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p><span class="bold"><strong>Publisher Anonymous WS 1996 transport</strong></span></p><p><span class="emphasis"><em><span class="emphasis"><em>This type of transport is recommended 7036 interface. 7037 </p> 7038 <div class="itemizedlist"> 7039 <ul class="itemizedlist"> 7040 <li class="listitem"> 7041 <p> 7042 <span class="bold"> 7043 <strong>Publisher Anonymous WS 7044 transport 7045 </strong> 7046 </span> 7047 </p> 7048 <p> 7049 <span class="emphasis"> 7050 <em> 7051 <span class="emphasis"> 7052 <em>This type of transport is recommended 1997 7053 only for internal, secure network environments or 1998 testing.</em></span></em></span></p><pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-anonymous"> 7054 testing. 7055 </em> 7056 </span> 7057 </em> 7058 </span> 7059 </p> 7060 <pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-anonymous"> 1999 7061 <smn:UseWSA>true</smn:UseWSA> 2000 7062 <smn:RecvTimeout>10</smn:RecvTimeout> 2001 7063 <smn:SendTimeout>10</smn:SendTimeout> 2002 7064 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 2003 </Module></pre></li><li class="listitem"><p><span class="bold"><strong>Publisher SSL WS transport and 2004 authentication</strong></span></p><pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-ssl"> 7065 </Module> 7066 </pre> 7067 </li> 7068 <li class="listitem"> 7069 <p> 7070 <span class="bold"> 7071 <strong>Publisher SSL WS transport and 7072 authentication 7073 </strong> 7074 </span> 7075 </p> 7076 <pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-ssl"> 2005 7077 <smn:UseWSA>true</smn:UseWSA> 2006 7078 <smn:RecvTimeout>10</smn:RecvTimeout> … … 2011 7083 <smn:TrustedCAPath>/opt/qcg/etc/ssl/certs/qcg-ntf/ca.pem</smn:TrustedCAPath> 2012 7084 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 2013 </Module></pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:UseWSA 2014 <span class="emphasis"><em>[boolean]</em></span></em></span></p><p>Determine if WS-Addressing should be used.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:RecvTimeout 2015 <span class="emphasis"><em>[positiveInteger]</em></span></em></span></p><p>The timeout in seconds for stall on the recv function. 2016 If negative, time is measured in microseconds.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:SendTimeout 2017 <span class="emphasis"><em>[positiveInteger]</em></span></em></span></p><p>The timeout in seconds for stall on the send function. 2018 If negative, time is measured in microseconds.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:X509CertKeyFile 2019 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A path to the file with both X509 certificate and 2020 private key. Mandatory argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:X509KeyPass 2021 <span class="emphasis"><em>[string]</em></span></em></span></p><p>An optional password to X509 private key.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:TrutedCAFile 2022 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A path to the file with trusted CAs certificates. 7085 </Module> 7086 </pre> 7087 <div class="itemizedlist"> 7088 <ul class="itemizedlist"> 7089 <li dir="lro" class="listitem"> 7090 <p dir="lro"> 7091 <span class="emphasis"> 7092 <em>//smn:UseWSA 7093 7094 <span class="emphasis"> 7095 <em>[boolean] 7096 </em> 7097 </span> 7098 </em> 7099 </span> 7100 </p> 7101 <p>Determine if WS-Addressing should be used. 7102 </p> 7103 </li> 7104 <li dir="lro" class="listitem"> 7105 <p dir="lro"> 7106 <span class="emphasis"> 7107 <em>//smn:RecvTimeout 7108 7109 <span class="emphasis"> 7110 <em>[positiveInteger] 7111 </em> 7112 </span> 7113 </em> 7114 </span> 7115 </p> 7116 <p>The timeout in seconds for stall on the recv function. 7117 If negative, time is measured in microseconds. 7118 </p> 7119 </li> 7120 <li dir="lro" class="listitem"> 7121 <p dir="lro"> 7122 <span class="emphasis"> 7123 <em>//smn:SendTimeout 7124 7125 <span class="emphasis"> 7126 <em>[positiveInteger] 7127 </em> 7128 </span> 7129 </em> 7130 </span> 7131 </p> 7132 <p>The timeout in seconds for stall on the send function. 7133 If negative, time is measured in microseconds. 7134 </p> 7135 </li> 7136 <li dir="lro" class="listitem"> 7137 <p dir="lro"> 7138 <span class="emphasis"> 7139 <em>//smn:X509CertKeyFile 7140 7141 <span class="emphasis"> 7142 <em>[string] 7143 </em> 7144 </span> 7145 </em> 7146 </span> 7147 </p> 7148 <p>A path to the file with both X509 certificate and 7149 private key. Mandatory argument. 7150 </p> 7151 </li> 7152 <li class="listitem"> 7153 <p> 7154 <span class="emphasis"> 7155 <em>//smn:X509KeyPass 7156 7157 <span class="emphasis"> 7158 <em>[string] 7159 </em> 7160 </span> 7161 </em> 7162 </span> 7163 </p> 7164 <p>An optional password to X509 private key. 7165 </p> 7166 </li> 7167 <li class="listitem"> 7168 <p> 7169 <span class="emphasis"> 7170 <em>//smn:TrutedCAFile 7171 7172 <span class="emphasis"> 7173 <em>[string] 7174 </em> 7175 </span> 7176 </em> 7177 </span> 7178 </p> 7179 <p>A path to the file with trusted CAs certificates. 2023 7180 Either TrustedCAFile or TrustedCAPath must be 2024 specified.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:TrutedCAPath 2025 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A path to the directory with the files with trusted 7181 specified. 7182 </p> 7183 </li> 7184 <li class="listitem"> 7185 <p> 7186 <span class="emphasis"> 7187 <em>//smn:TrutedCAPath 7188 7189 <span class="emphasis"> 7190 <em>[string] 7191 </em> 7192 </span> 7193 </em> 7194 </span> 7195 </p> 7196 <p>A path to the directory with the files with trusted 2026 7197 CAs certificates. Either TrustedCAFile or TrustedCAPath must 2027 be specified.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:NotifyTopicConversion 2028 <span class="emphasis"><em>[enumeration]</em></span></em></span></p><p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 7198 be specified. 7199 </p> 7200 </li> 7201 <li class="listitem"> 7202 <p> 7203 <span class="emphasis"> 7204 <em>//smn:NotifyTopicConversion 7205 7206 <span class="emphasis"> 7207 <em>[enumeration] 7208 </em> 7209 </span> 7210 </em> 7211 </span> 7212 </p> 7213 <p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 2029 7214 type of conversion that will be applied (if needed) to the 2030 Topic element of Notify messages.</p></li></ul></div></li><li class="listitem"><p><span class="bold"><strong>Publisher XMPP 2031 transport</strong></span></p><p><span class="bold"><strong><span class="emphasis"><em>The XMPP publisher module 7215 Topic element of Notify messages. 7216 </p> 7217 </li> 7218 </ul> 7219 </div> 7220 </li> 7221 <li class="listitem"> 7222 <p> 7223 <span class="bold"> 7224 <strong>Publisher XMPP 7225 transport 7226 </strong> 7227 </span> 7228 </p> 7229 <p> 7230 <span class="bold"> 7231 <strong> 7232 <span class="emphasis"> 7233 <em>The XMPP publisher module 2032 7234 can send two versions of notifications via XMPP. The first version 2033 7235 are notifications expressed as SOAP messages, the second are … … 2036 7238 document was provided in Subscribe message: the XSLT document will 2037 7239 be used to transform the message to the appropriate 2038 form.</em></span></strong></span></p><pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-xmpp"> 7240 form. 7241 </em> 7242 </span> 7243 </strong> 7244 </span> 7245 </p> 7246 <pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-xmpp"> 2039 7247 <smn:Server>xmppserver.qcg.com</smn:Server> 2040 7248 <smn:Port>5222</smn:Port> … … 2046 7254 <smn:CertFingerprint>00112233445566778899AABBCCDDEE</smn:CertFingerprint> 2047 7255 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 2048 </sm:Module></pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:Server 2049 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Hostname of the XMPP server on which the XMPP account 2050 is set up.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn<span class="emphasis"><em>:Port 2051 [positiveInteger]</em></span></em></span></p><p>Port number of the XMPP server. Default is 2052 5222.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:Username<span class="emphasis"><em>[string]</em></span></em></span></p><p>Username used for the XMPP account.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:Password<span class="emphasis"><em>[string]</em></span></em></span></p><p>The secret key for the XMPP account.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Jid 2053 <span class="emphasis"><em>[string]</em></span></em></span></p><p>JID of the XMPP account</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:ResourceName 2054 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Resource name used by publisher's client 2055 connection.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Encryption 2056 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Encryption to use. By default it's "none". Use "TLS" 7256 </sm:Module> 7257 </pre> 7258 <div class="itemizedlist"> 7259 <ul class="itemizedlist"> 7260 <li dir="lro" class="listitem"> 7261 <p dir="lro"> 7262 <span class="emphasis"> 7263 <em>//smn:Server 7264 7265 <span class="emphasis"> 7266 <em>[string] 7267 </em> 7268 </span> 7269 </em> 7270 </span> 7271 </p> 7272 <p>Hostname of the XMPP server on which the XMPP account 7273 is set up. 7274 </p> 7275 </li> 7276 <li dir="lro" class="listitem"> 7277 <p dir="lro"> 7278 <span class="emphasis"> 7279 <em>//smn 7280 <span class="emphasis"> 7281 <em>:Port 7282 [positiveInteger] 7283 </em> 7284 </span> 7285 </em> 7286 </span> 7287 </p> 7288 <p>Port number of the XMPP server. Default is 7289 5222. 7290 </p> 7291 </li> 7292 <li dir="lro" class="listitem"> 7293 <p dir="lro"> 7294 <span class="emphasis"> 7295 <em>//smn:Username 7296 <span class="emphasis"> 7297 <em>[string] 7298 </em> 7299 </span> 7300 </em> 7301 </span> 7302 </p> 7303 <p>Username used for the XMPP account. 7304 </p> 7305 </li> 7306 <li dir="lro" class="listitem"> 7307 <p dir="lro"> 7308 <span class="emphasis"> 7309 <em>//smn:Password 7310 <span class="emphasis"> 7311 <em>[string] 7312 </em> 7313 </span> 7314 </em> 7315 </span> 7316 </p> 7317 <p>The secret key for the XMPP account. 7318 </p> 7319 </li> 7320 <li class="listitem"> 7321 <p> 7322 <span class="emphasis"> 7323 <em>//smn:Jid 7324 7325 <span class="emphasis"> 7326 <em>[string] 7327 </em> 7328 </span> 7329 </em> 7330 </span> 7331 </p> 7332 <p>JID of the XMPP account 7333 </p> 7334 </li> 7335 <li class="listitem"> 7336 <p> 7337 <span class="emphasis"> 7338 <em>//smn:ResourceName 7339 7340 <span class="emphasis"> 7341 <em>[string] 7342 </em> 7343 </span> 7344 </em> 7345 </span> 7346 </p> 7347 <p>Resource name used by publisher's client 7348 connection. 7349 </p> 7350 </li> 7351 <li class="listitem"> 7352 <p> 7353 <span class="emphasis"> 7354 <em>//smn:Encryption 7355 7356 <span class="emphasis"> 7357 <em>[string] 7358 </em> 7359 </span> 7360 </em> 7361 </span> 7362 </p> 7363 <p>Encryption to use. By default it's "none". Use "TLS" 2057 7364 for STARTTLS connection encryption. Use "SSL" for old-style 2058 SSL encryption (typically port 5223).</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:CertFingerprint 2059 <span class="emphasis"><em>[string]</em></span></em></span></p><p>MD5 fingerprint of the encryption certificate used by 7365 SSL encryption (typically port 5223). 7366 </p> 7367 </li> 7368 <li class="listitem"> 7369 <p> 7370 <span class="emphasis"> 7371 <em>//smn:CertFingerprint 7372 7373 <span class="emphasis"> 7374 <em>[string] 7375 </em> 7376 </span> 7377 </em> 7378 </span> 7379 </p> 7380 <p>MD5 fingerprint of the encryption certificate used by 2060 7381 the XMPP server. Upon mismatch, the connection will fail. 2061 Use empty string to accept any certificate.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:NotifyTopicConversion 2062 <span class="emphasis"><em>[enumeration]</em></span></em></span></p><p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 7382 Use empty string to accept any certificate. 7383 </p> 7384 </li> 7385 <li class="listitem"> 7386 <p> 7387 <span class="emphasis"> 7388 <em>//smn:NotifyTopicConversion 7389 7390 <span class="emphasis"> 7391 <em>[enumeration] 7392 </em> 7393 </span> 7394 </em> 7395 </span> 7396 </p> 7397 <p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 2063 7398 type of conversion that will be applied (only if needed) to 2064 the Topic element of Notify messages.</p></li></ul></div></li><li class="listitem"><p><span class="bold"><strong>Publisher SMTP 2065 transport</strong></span></p><p><span class="bold"><strong><span class="emphasis"><em>Similarly to the XMPP 7399 the Topic element of Notify messages. 7400 </p> 7401 </li> 7402 </ul> 7403 </div> 7404 </li> 7405 <li class="listitem"> 7406 <p> 7407 <span class="bold"> 7408 <strong>Publisher SMTP 7409 transport 7410 </strong> 7411 </span> 7412 </p> 7413 <p> 7414 <span class="bold"> 7415 <strong> 7416 <span class="emphasis"> 7417 <em>Similarly to the XMPP 2066 7418 publisher module, the SMTP module utilizes the XSLT documents to 2067 7419 transform the content of the notification to the human-friendly 2068 form. </em></span></strong></span></p><pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-smtp"> 7420 form. 7421 </em> 7422 </span> 7423 </strong> 7424 </span> 7425 </p> 7426 <pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-smtp"> 2069 7427 <smn:ServerURL>smtp://localhost:25</smn:ServerURL> 2070 7428 <smn:User>someuser</smn:User> … … 2077 7435 <smn:Trace>false</smn:Trace> 2078 7436 <smn:SendTimeout>10</smn:SendTimeout> 2079 </sm:Module> </pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:Server 2080 <span class="emphasis"><em>[string]</em></span></em></span></p><p>URL of the SMTP server. Mandatory argument.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:User 2081 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Name of the account on SMTP server. Optional 2082 argument.</p></li><li dir="lro" class="listitem"><p dir="lro"><span class="emphasis"><em>//smn:Password 2083 <span class="emphasis"><em>[string]</em></span></em></span></p><p>The secret key for the account. Optional 2084 argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Encryption 2085 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Used to enable encryption. The only supported type of 7437 </sm:Module> 7438 </pre> 7439 <div class="itemizedlist"> 7440 <ul class="itemizedlist"> 7441 <li dir="lro" class="listitem"> 7442 <p dir="lro"> 7443 <span class="emphasis"> 7444 <em>//smn:Server 7445 7446 <span class="emphasis"> 7447 <em>[string] 7448 </em> 7449 </span> 7450 </em> 7451 </span> 7452 </p> 7453 <p>URL of the SMTP server. Mandatory argument. 7454 </p> 7455 </li> 7456 <li dir="lro" class="listitem"> 7457 <p dir="lro"> 7458 <span class="emphasis"> 7459 <em>//smn:User 7460 7461 <span class="emphasis"> 7462 <em>[string] 7463 </em> 7464 </span> 7465 </em> 7466 </span> 7467 </p> 7468 <p>Name of the account on SMTP server. Optional 7469 argument. 7470 </p> 7471 </li> 7472 <li dir="lro" class="listitem"> 7473 <p dir="lro"> 7474 <span class="emphasis"> 7475 <em>//smn:Password 7476 7477 <span class="emphasis"> 7478 <em>[string] 7479 </em> 7480 </span> 7481 </em> 7482 </span> 7483 </p> 7484 <p>The secret key for the account. Optional 7485 argument. 7486 </p> 7487 </li> 7488 <li class="listitem"> 7489 <p> 7490 <span class="emphasis"> 7491 <em>//smn:Encryption 7492 7493 <span class="emphasis"> 7494 <em>[string] 7495 </em> 7496 </span> 7497 </em> 7498 </span> 7499 </p> 7500 <p>Used to enable encryption. The only supported type of 2086 7501 encryption is "TLS". If not present, encryption will be 2087 switched off. Optional argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:TrutedCAFile 2088 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A path to the file with trusted CAs certificates. 2089 Optional argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:TrutedCAPath 2090 <span class="emphasis"><em>[string]</em></span></em></span></p><p>A path to the directory with the files with trusted 2091 CAs certificates. Optional argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:From 2092 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Defines a name that will be placed in From field of 2093 the e-mail message. Optional argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Subject 2094 <span class="emphasis"><em>[string]</em></span></em></span></p><p>Defines a Subject of the e-mail message. Optional 2095 argument.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:Trace 2096 <span class="emphasis"><em>[boolean]</em></span></em></span></p><p>Switches trace logging. Optional argument, default is 2097 false.</p></li><li class="listitem"><p><span class="emphasis"><em>//smn:SendTimeout 2098 <span class="emphasis"><em>[int]</em></span></em></span></p><p>The timeout in seconds for stall on the send function. 2099 Optional argument, default is 10.</p></li></ul></div></li></ul></div></div></div><div class="sect2" title="WS-Topics management"><div class="titlepage"><div><div><h3 class="title"><a id="idp866480"/>WS-Topics management</h3></div></div></div><p>In the current release, a topics management in <span class="emphasis"><em>QCG 2100 Notification</em></span> is relatively simple. The first step is a 7502 switched off. Optional argument. 7503 </p> 7504 </li> 7505 <li class="listitem"> 7506 <p> 7507 <span class="emphasis"> 7508 <em>//smn:TrutedCAFile 7509 7510 <span class="emphasis"> 7511 <em>[string] 7512 </em> 7513 </span> 7514 </em> 7515 </span> 7516 </p> 7517 <p>A path to the file with trusted CAs certificates. 7518 Optional argument. 7519 </p> 7520 </li> 7521 <li class="listitem"> 7522 <p> 7523 <span class="emphasis"> 7524 <em>//smn:TrutedCAPath 7525 7526 <span class="emphasis"> 7527 <em>[string] 7528 </em> 7529 </span> 7530 </em> 7531 </span> 7532 </p> 7533 <p>A path to the directory with the files with trusted 7534 CAs certificates. Optional argument. 7535 </p> 7536 </li> 7537 <li class="listitem"> 7538 <p> 7539 <span class="emphasis"> 7540 <em>//smn:From 7541 7542 <span class="emphasis"> 7543 <em>[string] 7544 </em> 7545 </span> 7546 </em> 7547 </span> 7548 </p> 7549 <p>Defines a name that will be placed in From field of 7550 the e-mail message. Optional argument. 7551 </p> 7552 </li> 7553 <li class="listitem"> 7554 <p> 7555 <span class="emphasis"> 7556 <em>//smn:Subject 7557 7558 <span class="emphasis"> 7559 <em>[string] 7560 </em> 7561 </span> 7562 </em> 7563 </span> 7564 </p> 7565 <p>Defines a Subject of the e-mail message. Optional 7566 argument. 7567 </p> 7568 </li> 7569 <li class="listitem"> 7570 <p> 7571 <span class="emphasis"> 7572 <em>//smn:Trace 7573 7574 <span class="emphasis"> 7575 <em>[boolean] 7576 </em> 7577 </span> 7578 </em> 7579 </span> 7580 </p> 7581 <p>Switches trace logging. Optional argument, default is 7582 false. 7583 </p> 7584 </li> 7585 <li class="listitem"> 7586 <p> 7587 <span class="emphasis"> 7588 <em>//smn:SendTimeout 7589 7590 <span class="emphasis"> 7591 <em>[int] 7592 </em> 7593 </span> 7594 </em> 7595 </span> 7596 </p> 7597 <p>The timeout in seconds for stall on the send function. 7598 Optional argument, default is 10. 7599 </p> 7600 </li> 7601 </ul> 7602 </div> 7603 </li> 7604 </ul> 7605 </div> 7606 </div> 7607 </div> 7608 <div class="sect2" title="WS-Topics management"> 7609 <div class="titlepage"> 7610 <div> 7611 <div> 7612 <h3 class="title"> 7613 <a id="idp871104"/>WS-Topics management 7614 </h3> 7615 </div> 7616 </div> 7617 </div> 7618 <p>In the current release, a topics management in 7619 <span class="emphasis"> 7620 <em>QCG 7621 Notification 7622 </em> 7623 </span> is relatively simple. The first step is a 2101 7624 preparation of an XML document with a Topic Namespace definition. This 2102 step can be done by one of the peers cooperating with <span class="emphasis"><em>QCG 2103 Notification</em></span>. Then the document should be delivered to the 2104 computer where <span class="emphasis"><em>QCG Notification</em></span> is installed. It 7625 step can be done by one of the peers cooperating with 7626 <span class="emphasis"> 7627 <em>QCG 7628 Notification 7629 </em> 7630 </span>. Then the document should be delivered to the 7631 computer where 7632 <span class="emphasis"> 7633 <em>QCG Notification 7634 </em> 7635 </span> is installed. It 2105 7636 can be done in two ways: the document may be copied manually by QCG 2106 7637 Notification administrator to TopicNamespaces directory in prior to 2107 <span class="emphasis"><em>a QCG Notification</em></span> startup or it can be send 2108 through the <span class="emphasis"><em>QCG Notification</em></span> interface when 2109 <span class="emphasis"><em>QCG Notification</em></span> is already running. In the last 7638 7639 <span class="emphasis"> 7640 <em>a QCG Notification 7641 </em> 7642 </span> startup or it can be send 7643 through the 7644 <span class="emphasis"> 7645 <em>QCG Notification 7646 </em> 7647 </span> interface when 7648 7649 <span class="emphasis"> 7650 <em>QCG Notification 7651 </em> 7652 </span> is already running. In the last 2110 7653 case, the TopicNamespaces are stored also in a files in TopicNamespace 2111 7654 directory so they can be automatically loaded after restart of the 2112 7655 service. The TopicNamespaces loaded from files may be protected from 2113 7656 unwanted removal by unsetting write permissions for a certain 2114 file.</p><p>An XML document describing a sample topic namespace is presented 2115 in the <a class="link" href="#ted" title="Topics, TopicExpressions and Dialects">Section 3.3</a>.</p></div><div class="sect2" title="Starting QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp872368"/>Starting <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div><p>To start <span class="emphasis"><em>QCG Notification</em></span> as a daemon 2116 type:</p><pre class="programlisting">$ ./qcg-ntfd</pre><p>If you start <span class="emphasis"><em>QCG Notification</em></span> with parameter 2117 -h you will get an optional parameters list:</p><pre class="programlisting">$ ./qcg-ntfd -h 7657 file. 7658 </p> 7659 <p>An XML document describing a sample topic namespace is presented 7660 in the 7661 <a class="link" href="#ted" title="Topics, TopicExpressions and Dialects">Section 3.3 7662 </a>. 7663 </p> 7664 </div> 7665 <div class="sect2" title="Starting QCG Notification"> 7666 <div class="titlepage"> 7667 <div> 7668 <div> 7669 <h3 class="title"> 7670 <a id="idp877072"/>Starting 7671 <span class="emphasis"> 7672 <em>QCG Notification 7673 </em> 7674 </span> 7675 </h3> 7676 </div> 7677 </div> 7678 </div> 7679 <p>To start 7680 <span class="emphasis"> 7681 <em>QCG Notification 7682 </em> 7683 </span> as a daemon 7684 type: 7685 </p> 7686 <pre class="programlisting">$ ./qcg-ntfd 7687 </pre> 7688 <p>If you start 7689 <span class="emphasis"> 7690 <em>QCG Notification 7691 </em> 7692 </span> with parameter 7693 -h you will get an optional parameters list: 7694 </p> 7695 <pre class="programlisting">$ ./qcg-ntfd -h 2118 7696 usage: ./qcg-ntfd [-d] [-z config_file] 2119 7697 … … 2122 7700 -z config_file configuration file, default is /opt/qcg/etc/qcg-ntfd.xml 2123 7701 -v print version information 2124 -h print this help</pre><p>Once you run <span class="emphasis"><em>QCG 2125 Notification</em></span> as a daemon, a log file is created. Using 2126 various log levels, you can log less or more details.</p></div><div class="sect2" title="Stopping QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp877840"/>Stopping <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div><p>At the moment, shutdown is performed simply by sending 2127 <code class="filename">SIGINT</code> signal to the service, e.g.:</p><pre class="programlisting">$ kill -SIGINT `pidof qcg-ntfd`</pre></div></div></div> 7702 -h print this help 7703 </pre> 7704 <p>Once you run 7705 <span class="emphasis"> 7706 <em>QCG 7707 Notification 7708 </em> 7709 </span> as a daemon, a log file is created. Using 7710 various log levels, you can log less or more details. 7711 </p> 7712 </div> 7713 <div class="sect2" title="Stopping QCG Notification"> 7714 <div class="titlepage"> 7715 <div> 7716 <div> 7717 <h3 class="title"> 7718 <a id="idp882544"/>Stopping 7719 <span class="emphasis"> 7720 <em>QCG Notification 7721 </em> 7722 </span> 7723 </h3> 7724 </div> 7725 </div> 7726 </div> 7727 <p>At the moment, shutdown is performed simply by sending 7728 7729 <code class="filename">SIGINT 7730 </code> signal to the service, e.g.: 7731 </p> 7732 <pre class="programlisting">$ kill -SIGINT `pidof qcg-ntfd` 7733 </pre> 7734 </div> 7735 </div> 7736 </div> 2128 7737 }}}