Changes between Version 19 and Version 20 of technicalGuideAndManual
- Timestamp:
- 05/21/13 15:24:13 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
technicalGuideAndManual
v19 v20 1 1 {{{ 2 2 #!html 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, 3 4 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> 5 <html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 6 <title>QCG Notification v. 3.0 Technical Guide and Manual</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"></meta></head><body><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="idp192"></a><span class="emphasis"><em>QCG Notification</em></span> v. 3.0 Technical Guide and 7 Manual</h2></div><div><div class="authorgroup"> 8 <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> 9 10 <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> 11 </div></div><div><p xml:lang="en" class="releaseinfo">3.0.3</p></div><div><p class="copyright">Copyright © 2008-2013 Poznan Supercomputing and Networking Center</p></div></div><hr></hr></div><div class="toc"><p><strong>Table of Contents</strong></p><dl><dt><span class="sect1"><a href="#idp32960">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp35648">Motivations</a></span></dt><dt><span class="sect2"><a href="#idp8704">Purpose of the Document</a></span></dt><dt><span class="sect2"><a href="#idp38656">Status</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp33088">Terminology and WS-Notification Concept</a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp41856">WS-Notification Concept</a></span></dt><dt><span class="sect2"><a href="#idp136496">UML-style Diagrams</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp168048">User Guide for a Publisher, Subscriber and 12 NotificationConsumer<span class="emphasis"><em> </em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp169120">Prefixes and Namespaces</a></span></dt><dt><span class="sect2"><a href="#idp188752">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="#idp217984">Extensions</a></span></dt><dt><span class="sect2"><a href="#idp238384">Methods Description</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp656832">Administration Guide of <span class="emphasis"><em>QCG 13 Notification</em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp659488">Prerequisites</a></span></dt><dt><span class="sect2"><a href="#idp665136">Building</a></span></dt><dt><span class="sect2"><a href="#idp680896">Creating database for <span class="emphasis"><em>QCG Notification</em></span> - the 14 PostgreSQL example</a></span></dt></dl></dd><dt><span class="sect1"><a href="#idp702064">Configuration of <span class="emphasis"><em>QCG Notification</em></span></a></span></dt><dd><dl><dt><span class="sect2"><a href="#idp703168">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="#idp870048">WS-Topics management</a></span></dt><dt><span class="sect2"><a href="#idp875936">Starting <span class="emphasis"><em>QCG Notification</em></span></a></span></dt><dt><span class="sect2"><a href="#idp881408">Stopping <span class="emphasis"><em>QCG Notification</em></span></a></span></dt></dl></dd></dl></div> 15 16 17 <div class="sect1" title="Introduction"><div class="titlepage"><div><div><h2 class="title"><a id="idp32960"></a>Introduction</h2></div></div></div> 18 19 20 <p><span class="bold"><strong>QCG Notification</strong></span> is a reference 21 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 22 OASIS standard)</a></a> for message push/pull-style notification, 275 23 using a topic-based publish/subscribe pattern. It supports standard 276 24 message exchanges to be implemented by any Web Service providers … … 281 29 service providers and requesters that participate in notifications, and an 282 30 XML model that describes topics (i.e., items of interest for 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 31 subscriptions.).</p> 32 33 <div class="sect2" title="Motivations"><div class="titlepage"><div><div><h3 class="title"><a id="idp35648"></a>Motivations</h3></div></div></div> 34 35 36 <p>Reliable notification and messaging services are key components in 296 37 service-oriented architectures (SOA) and distributed computing. However, 297 38 early Web Services, such as those for getting stock or whether daily … … 309 50 standardization body, either implement only partially notification 310 51 standards or do not meet high performance requirements. Therefore, our 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 52 main motivation was to design and implement <span class="emphasis"><em>QCG 53 Notification</em></span> to offer more advanced push/pull 317 54 (synchronous/asynchronous) standard notification routines for QCG 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, 55 Service Bus services as well as any third party Web Services.</p> 56 </div> 57 58 <div class="sect2" title="Purpose of the Document"><div class="titlepage"><div><div><h3 class="title"><a id="idp8704"></a>Purpose of the Document</h3></div></div></div> 59 60 61 <p>The main goal of this document is to define a set of initial use 62 cases, scenarios and specify software requirements for <span class="emphasis"><em>QCG 63 Notification</em></span>, its programming application interface, 338 64 functional units and the integration with both internal and external 339 modules. 340 </p> 341 <p>The document is aimed at software architects and programmers who65 modules.</p> 66 67 <p>The document is aimed at software architects and programmers who 342 68 will be developing software components based on this document. Many 343 requirements and 344 <span class="emphasis"> 345 <em>QCG Notification 346 </em> 347 </span>concept itself 69 requirements and <span class="emphasis"><em>QCG Notification </em></span>concept itself 348 70 might be interesting for developers and end users of any Web 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 71 Services.</p> 72 73 <p>This document assumes that the reader has at least a basic 74 background in Web Service and SOA technologies.</p> 75 </div> 76 77 <div class="sect2" title="Status"><div class="titlepage"><div><div><h3 class="title"><a id="idp38656"></a>Status</h3></div></div></div> 78 79 80 <p>This document is updated periodically on no particular 81 schedule.</p> 82 </div> 83 </div> 84 85 <div class="sect1" title="Terminology and WS-Notification Concept"><div class="titlepage"><div><div><h2 class="title"><a id="idp33088"></a>Terminology and WS-Notification Concept</h2></div></div></div> 381 86 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 87 88 <p>The aim of this section is to capture high-level functionality of 89 <span class="emphasis"><em>QCG Notification</em></span> and/or interaction without providing 90 excessive implementation or technical details of the system.</p> 91 92 <div class="sect2" title="WS-Notification Concept"><div class="titlepage"><div><div><h3 class="title"><a id="idp41856"></a>WS-Notification Concept</h3></div></div></div> 93 94 95 <div class="sect3" title="WS-Notification Fundamentals"><div class="titlepage"><div><div><h4 class="title"><a id="idp42800"></a>WS-Notification Fundamentals</h4></div></div></div> 96 97 98 <p>Notification-based pattern is commonly used for 409 99 interaction between distributed objects. WS-Notification is a family 410 100 of related specifications that standardizes notification concept and 411 101 topic-based information distribution in SOA and Web Service based 412 102 systems. There are three normative OASIS specifications: 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 103 WS-BaseNotification, WS-BrokeredNotification and WS-Topics.</p> 104 105 <div class="variablelist"><dl><dt><span class="term">WS-BaseNotification</span></dt><dd> 106 <p>Standardizes the terminology, concepts, operations, WSDL 423 107 and XML needed to express the basic roles involved in Web 424 108 services publish and subscribe for notification message 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 109 exchange.</p> 110 111 <p>Specification URL:</p> 112 113 <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> 114 </dd></dl></div> 115 116 <div class="variablelist"><dl><dt><span class="term">WS-BrokeredNotification</span></dt><dd> 117 <p>Describes specific objectives for expanded version of 444 118 notification messages exchange with indirect NotificationBroker 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 119 service.</p> 120 121 <p>Specification URL:</p> 122 123 <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> 124 </dd></dl></div> 125 126 <div class="variablelist"><dl><dt><span class="term"><a id="WS-topics"></a>WS-Topics</span></dt><dd> 127 <p>Defines mechanism to organize and categorize items of 128 interest for subscriptions known as "topics".</p> 129 130 <p>Specification URL:</p> 131 132 <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> 133 </dd></dl></div> 134 135 <p>The next subsections will present main notification concepts 136 defined in the mentioned specifications.</p> 137 </div> 138 139 <div class="sect3" title="WS-BaseNotification"><div class="titlepage"><div><div><h4 class="title"><a id="idp54576"></a>WS-BaseNotification</h4></div></div></div> 140 141 142 <p>The WS-BaseNotification document is a basic reference on which 491 143 all the other specifications in the standard WS-Notification family 492 144 depend. In fact, it defines precisely two important notification 493 145 roles/actors called respectively NotificationProducer and 494 146 NotificationConsumer. An example system architecture based on 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 147 WS-BaseNotification is presented below.</p> 148 149 <div class="figure"><a id="BaseEntities"></a><p class="title"><strong>Figure 1. Web Services BaseNotification entities</strong></p><div class="figure-contents"> 150 151 152 <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"></img></div> 153 </div></div><p><br class="figure-break"></br>The basic terminology related to the WS-BaseNotification is 154 following:</p><div class="variablelist"><dl><dt><span class="term">Situation</span></dt><dd> 155 <p>Some occurrence known by a NotificationProducer. A 156 Situation is a reason of dispatching a Notification.</p> 157 </dd><dt><span class="term">Notification</span></dt><dd> 158 <p><a id="a"></a>An artifact of a Situation containing information 531 159 about that Situation. A Notification is represented as an XML 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 160 element and dispatched by a NotificationProducer.</p> 161 </dd><dt><span class="term">Subscription</span></dt><dd> 162 <p>Represents relations between a NotificationProducer and 541 163 a NotificationConsumer. A Subscription is created by a 542 164 Subscriber and is consisted with filtering parameters such as 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 165 a Topic, policies or context information.</p> 166 </dd><dt><span class="term">Subscriber</span></dt><dd> 167 <p>An unit that creates Subscriptions. It sends the 552 168 SubscribeRequest message to a NotificationProducer 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 169 service.</p> 170 </dd><dt><span class="term">NotificationProducer</span></dt><dd> 171 <p>Produces Notifications. In other words 562 172 NotificationProducer detects Situation(s) and translates it to 563 173 Notification message(s). It is also a Web Service responsible 564 174 for creating Subscriptions by the SubscribeRequest 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 175 message.</p> 176 </dd><dt><span class="term">NotificationConsumer</span></dt><dd> 177 <p>An endpoint designated to receive Notifications produced 574 178 by a NotificationProducer as a result of a 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 179 Subscription.</p> 180 </dd><dt><span class="term">PullPoint</span></dt><dd> 181 <p>The purpose of PullPoints is enabling pull-style 584 182 notifications. In general, PullPoints accumulate notifications 585 183 and offer an interface for retrieving these notifications by 586 184 remote consumers. Since a PullPoint implements a 587 185 NotificationConsumer interface it can be selected in a 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 186 Subscription as a receiver of notifications.</p> 187 </dd><dt><span class="term">CurrentMessages</span></dt><dd> 188 <p>CurrentMessages is a buffer that keeps the latest 597 189 messages produced on each topic. A new notification replaces 598 190 the previous related to the same topic and currently buffered 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 191 in CurrentMessages.</p> 192 </dd></dl></div> 193 </div> 194 195 <div class="sect3" title="WS-BrokeredNotification"><div class="titlepage"><div><div><h4 class="title"><a id="idp73792"></a>WS-BrokeredNotification</h4></div></div></div> 196 197 198 <p>In a nutshell, the WS-BrokeredNotification specification is an 616 199 extension of described above the WS-BaseNotification concept. However, 617 200 it introduces a new important notification role called 618 201 NotificationBroker and defines more advanced notification scenarios. 619 202 The figure below shows an example scenario and notification message 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 203 flow where NotificationBroker is present.</p> 204 205 <div class="figure"><a id="idp75776"></a><p class="title"><strong>Figure 2. Web Services BrokeredNotification entities - QCG 206 Notification entities</strong></p><div class="figure-contents"> 207 208 209 <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"></img></div> 210 </div></div><p><br class="figure-break"></br>Note, that there are some important enlargements and 637 211 modifications in the WS-BrokeredNotificatison terminology. Below the 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 212 most relevant definitions are presented.</p> 213 214 <div class="variablelist"><dl><dt><span class="term">Situation</span></dt><dd> 215 <p>Some occurrence, known by a Publisher. A Situation is a 216 reason of dispatching a Notification.</p> 217 </dd><dt><span class="term">Notification</span></dt><dd> 218 <p>An artifact of a Situation containing information about 657 219 that Situation. A Notification is represented as an XML element, 658 220 dispatched by a Publisher and redistributed by a 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 221 NotificationBroker.</p> 222 </dd><dt><span class="term">Publisher</span></dt><dd> 223 <p>An unit that creates Notification(s) - detects 668 224 Situation(s) and translates it to Notification message(s). It 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 225 doesn't have to be a Web Service.</p> 226 </dd><dt><span class="term">Subscription</span></dt><dd> 227 <p>Represents relations between a Publisher and a 678 228 NotificationConsumer. A Subscription is created by a Subscriber 679 229 and is consisted with filtering parameters such as a Topic, 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 230 policies or a context information.</p> 231 </dd><dt><span class="term">Subscriber</span></dt><dd> 232 <p>An unit that creates Subscriptions. It sends the 689 233 SubscribeRequest message to a SubscriptionManager 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 234 interface.</p> 235 </dd><dt><span class="term">NotificationBroker</span></dt><dd> 236 <p>An intermediary Web service that decouples Publishers and 699 237 NotificationConsumers. It redistributes Notifications received 700 238 from Publishers to NotificationConsumers on the basis of 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 239 Subscriptions' parameters.</p> 240 </dd><dt><span class="term">NotificationConsumer</span></dt><dd> 241 <p>An endpoint designated to receive Notifications produced 710 242 by a Publisher and later redistributed by a NotificationBroker 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 243 as a result of a Subscription.</p> 244 </dd><dt><span class="term">PullPoint</span></dt><dd> 245 <p>The purpose of PullPoints is enabling pull-style 720 246 notifications. In general, PullPoints accumulate notifications 721 247 and offer an interface for retrieving these notifications by 722 248 remote consumers. Since a PullPoint implements a 723 249 NotificationConsumer interface it can be selected in a 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 250 Subscription as a receiver of notifications.</p> 251 </dd><dt><span class="term">CurrentMessages</span></dt><dd> 252 <p>CurrentMessages is a buffer that keeps the latest messages 733 253 published on each topic. A new notification replaces the 734 254 previous related to the same topic and currently buffered in 735 CurrentMessages. 736 </p> 737 </dd> 738 </dl> 739 </div> 740 <p>The main difference between WS-Base and WS-Brokered Notification 255 CurrentMessages.</p> 256 </dd></dl></div> 257 258 <p>The main difference between WS-Base and WS-Brokered Notification 741 259 specifications is that in the second case NotificationProducers do not 742 260 have to be implemented as a Web Services. Publishers do not have to … … 745 263 different actors in a notification flow, NotificationConsumers are 746 264 fully separated and do not have to know details about 747 NotificationProducers. 748 </p> 749 <p>Depending on distributed system requirements and use cases265 NotificationProducers.</p> 266 267 <p>Depending on distributed system requirements and use cases 750 268 various notification routines, objects, and roles are usually 751 269 involved. For instance, in the simplest case where an asynchronous … … 753 271 mechanisms defined by WS-BrokeredNotification and basic notification 754 272 routines defined by WS-BaseNotification are good enough to satisfy 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 273 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 758 274 scenarios in service oriented systems we recommend to use notification 759 275 capabilities defined in WS-BrokeredNotification. One of the main 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 276 scenario defined by WS-BrokeredNotification is presented on <a class="link" href="#BrokeredEntities">Figure 2</a> .</p> 277 </div> 278 279 <div class="sect3" title="WS-Topics"><div class="titlepage"><div><div><h4 class="title"><a id="idp98784"></a>WS-Topics</h4></div></div></div> 280 281 282 <p>The third important notification specification document called 776 283 WS-Topics is strictly associated with WS-BaseNotification and 777 284 precisely defines a "topics" mechanism. Important definitions used in 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 285 the WS-Topics specification are presented below:</p> 286 287 <div class="variablelist"><dl><dt><span class="term">Topic</span></dt><dd> 288 <p>A concept used to categorize Notifications and their 788 289 related Notification schemes. Topics are used to determine which 789 290 subscribing NotificationConsumers should receive a specific 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 291 Notification.</p> 292 </dd><dt><span class="term">Topic Tree</span></dt><dd> 293 <p>A hierarchical group of Topics.</p> 294 </dd><dt><span class="term">Topic Namespace</span></dt><dd> 295 <p>A forest of Topic Trees grouped into one namespace</p> 296 </dd><dt><span class="term">TopicExpression</span></dt><dd> 297 <p>An expression that identifies Topics from a Topic 298 Namespace</p> 299 </dd><dt><span class="term">Dialect</span></dt><dd> 300 <p>Identifies the type of a grammar used in a 824 301 TopicExpression. The specification defines four Dialects: 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 302 <span class="emphasis"><em>Simple</em></span>, <span class="emphasis"><em>Concrete</em></span>, 303 <span class="emphasis"><em>Full</em></span> and <span class="emphasis"><em>XPath</em></span>.</p> 304 </dd></dl></div> 305 306 <div class="figure"><a id="idp110368"></a><p class="title"><strong>Figure 3. Example Topic Namespace</strong></p><div class="figure-contents"> 307 308 309 <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"></img></div> 310 </div></div><br class="figure-break"></br> 311 </div> 312 313 <div class="sect3" title="Base of QCG Notification"><div class="titlepage"><div><div><h4 class="title"><a id="idp113248"></a>Base of <span class="emphasis"><em>QCG Notification</em></span></h4></div></div></div> 314 315 316 <p><span class="emphasis"><em>QCG Notification</em></span> is a reference 880 317 implementation of WS-BaseNotification, WS-BrokeredNotification and 881 318 WS-Topics OASIS industry standards. As a consistent and highly 882 319 efficient notification system it supports advanced brokered Web 883 Service notification push/pull scenarios described in the 884 <a class="link" href="#brokerednotifications">Section 2.1.3 885 </a>. It has been 320 Service notification push/pull scenarios described in the <a class="link" href="#brokerednotifications">Section 2.1.3</a>. It has been 886 321 designed to satisfy notification requirements and demands of large 887 322 scale Web Service based systems, SOA environments and it acts as a 888 323 core component in QCG Service Bus. To meet security requirements, 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 324 <span class="emphasis"><em>QCG Notification</em></span> (or <span class="emphasis"><em>QCG Notification 325 Provider</em></span>) exposes well defined Web Service and programming 899 326 interfaces over QCG security mechanisms for dynamic notification, 900 327 subscription, registration, forwarding, etc. As it was explained in 901 328 the previous sections it can be used and integrated with various 902 329 external third party Web Services playing roles of a notification 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 330 Publisher, Subscriber or Consumer.</p> 331 332 <p>A flexible plug-in architecture of <span class="emphasis"><em>QCG Notification 333 </em></span>enables using different communication protocols for 911 334 messages transmission. Currently messages can be transported between 912 913 <span class="emphasis"> 914 <em>QCG Notification 915 </em> 916 </span> and third party entities not 335 <span class="emphasis"><em>QCG Notification</em></span> and third party entities not 917 336 only through HTTP protocol, but also through XMPP (jabber) as well as 918 337 SMTP (e-mail) protocols. It is possible to variously mix channels of 919 338 communication, for example a notification sent by a Publisher being 920 339 WS-Client as a HTTP message can be distributed over XMPP to jabber 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 340 consumers.</p> 341 342 <p>Below we present a set of Web Service notification use cases 343 demonstrating capabilities offered by <span class="emphasis"><em>QCG 344 Notification</em></span>.</p> 345 346 <div class="figure"><a id="notificationConsumers"></a><p class="title"><strong>Figure 4. Notification with multiple Publishers and multiple 347 NotificationConsumers</strong></p><div class="figure-contents"> 348 349 350 <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"></img></div> 351 </div></div><br class="figure-break"></br> 352 353 <p>The <a class="link" href="#notificationConsumers" title="Figure 4. Notification with multiple Publishers and multiple NotificationConsumers">diagram 4</a> shows 354 one of the basic notification flows supported by <span class="emphasis"><em>QCG 355 Notification</em></span>. Depending on records, Notifications produced 356 by a Publisher and received by the <span class="emphasis"><em>QCG 357 Notification</em></span> may or may not be dispatched to concrete 960 358 NotificationConsumer. Note, that Subscriptions represent relationships 961 359 between Topics and NotificationConsumers in this scenario. Before any 962 360 Notification is delivered to a NotificationConsumer, a Subscriber has 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 361 to send first a SubscribeRequest message to <span class="emphasis"><em>QCG 362 Notification</em></span> in which all parameters of a Subscription are 969 363 specified. Main parameters of a SubscribeRequest message are 970 364 ConsumerReference and TopicExpression defined according to the 971 365 specific Dialect type. On the other hand, before a Publisher starts 972 366 sending Notifications it may be obligated to register himself in 973 974 <span class="emphasis"> 975 <em>QCG Notification 976 </em> 977 </span>. The diagram below shows a 367 <span class="emphasis"><em>QCG Notification</em></span>. The diagram below shows a 978 368 sequence of events in order to initialize an asynchronous process of 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 369 notifications between a Publisher and a NotificationConsumer.</p> 370 371 <div class="figure"><a id="idp126512"></a><p class="title"><strong>Figure 5. Message flows: creating a Subscription, notifying 372 NotificationConsumers</strong></p><div class="figure-contents"> 373 374 375 <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"></img></div> 376 </div></div><br class="figure-break"></br> 377 378 <div class="orderedlist"><ol class="orderedlist"><li class="listitem"> 379 <p>A Subscriber sends the SubscribeRequest message with a 999 380 NotificationConsumer location and TopicExpression parameters to 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 381 <span class="emphasis"><em>QCG Notification</em></span>.</p> 382 </li><li class="listitem"> 383 <p><span class="emphasis"><em>QCG Notification</em></span> prepares appropriate 384 records for a Subscription.</p> 385 </li><li class="listitem"> 386 <p>A Publisher register himself in <span class="emphasis"><em>QCG 387 Notification</em></span> by sending the RegisterPublisher 388 message.</p> 389 </li><li class="listitem"> 390 <p>A registered Publisher sends the Notify message on a 391 specified Topic to a <span class="emphasis"><em>QCG Notification 392 </em></span>service.</p> 393 </li><li class="listitem"> 394 <p><span class="emphasis"><em>QCG Notification</em></span> checks if there are 1042 395 NotificationConsumers subscribed on a specified Topic. If so, 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 396 <span class="emphasis"><em>QCG Notification</em></span> sends asynchronous 397 Notifications to these NotifcationConsumers.</p> 398 </li></ol></div> 399 </div> 400 </div> 401 402 <div class="sect2" title="UML-style Diagrams"><div class="titlepage"><div><div><h3 class="title"><a id="idp136496"></a>UML-style Diagrams</h3></div></div></div> 403 404 405 <p>The document uses UML-style use-case diagrams to illustrate 1066 406 high-level use cases. The following list is probably sufficient for this 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 407 version of the document:</p> 408 409 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 410 <p>Stick figures represents actors or roles in a scenario. These 411 can be human beings or software systems.</p> 412 </li><li class="listitem"> 413 <p>Ellipses represent use cases, i.e. actions or units of 414 functionality in a system.</p> 415 </li><li class="listitem"> 416 <p>Lines between actors and use cases indicate a participation of 1083 417 the actor in the use case. At this level, no direction or payload of 1084 418 data flow is expressed by the lines between actors and use 1085 cases. 1086 </p> 1087 </li> 1088 </ul> 1089 </div> 1090 <p>The document uses UML-style sequence diagrams to illustrate 419 cases.</p> 420 </li></ul></div> 421 422 <p>The document uses UML-style sequence diagrams to illustrate 1091 423 detailed use case scenarios and later in the next sections. Meanings of 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 424 graphics in these diagrams are as follows:</p> 425 426 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 427 <p>Boxes at the top of the diagram represent an actor in the 428 scenario.</p> 429 </li><li class="listitem"> 430 <p>Arrows with a solid head represent a message sent from one 431 actor to another. The arrow points from sender to receiver.</p> 432 </li><li class="listitem"> 433 <p>Arrows with a line head represent the return value of a 1108 434 message. The arrow points from the receiver of the earlier message 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 435 to the sender.</p> 436 </li><li class="listitem"> 437 <p>A dotted line running down the diagram from a box indicates 1114 438 that arrows whose endpoints (tail or head) is on the line apply to 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 439 that actor.</p> 440 </li><li class="listitem"> 441 <p>Intersections between arrows and dotted lines are 442 meaningless.</p> 443 </li><li class="listitem"> 444 <p>Vertical layout represents time. Messages (arrows) farther 445 down on the page happen after messages higher on the page.</p> 446 </li><li class="listitem"> 447 <p>Horizontal layout has no formal meaning. Since right-pointing 1130 448 arrows look better, actors that initiate a scenario tend to appear 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 449 leftward of actors they send messages to.</p> 450 </li></ul></div> 451 452 <p>Sequence diagrams are used in this document for more concrete 1137 453 design, and that actors and messages are often objects and object 1138 454 methods. They provide value for this document in that they give a 1139 455 clearly ordered message layout and connections among functional units. 1140 456 The actors and messages in the sequence diagrams are more properly roles 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 457 in a scenario and actions associated with that scenario.</p> 458 459 <div class="sect3" title="`Main Use Cases"><div class="titlepage"><div><div><h4 class="title"><a id="idp149312"></a>`Main Use Cases</h4></div></div></div> 460 461 462 <div class="figure"><a id="idp150128"></a><p class="title"><strong>Figure 6. Use case diagram for a Publisher</strong></p><div class="figure-contents"> 463 464 465 <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"></img></div> 466 </div></div><br class="figure-break"></br> 467 468 <div class="figure"><a id="idp153248"></a><p class="title"><strong>Figure 7. Use case diagram for a Subscriber</strong></p><div class="figure-contents"> 469 470 471 <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"></img></div> 472 </div></div><br class="figure-break"></br> 473 474 <div class="figure"><a id="idp156000"></a><p class="title"><strong>Figure 8. Use case diagram for a NotificationConsumer</strong></p><div class="figure-contents"> 475 476 477 <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"></img></div> 478 </div></div><br class="figure-break"></br> 479 480 <div class="figure"><a id="idp158752"></a><p class="title"><strong>Figure 9. Use case diagram for QCG Notification</strong></p><div class="figure-contents"> 481 482 483 <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"></img></div> 484 </div></div><br class="figure-break"></br> 485 486 <div class="figure"><a id="idp161504"></a><p class="title"><strong>Figure 10. Use case diagram for a QCG Notification Administrator</strong></p><div class="figure-contents"> 487 488 489 <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"></img></div> 490 </div></div><br class="figure-break"></br> 491 </div> 492 493 <div class="sect3" title="Main Sequence Diagrams"><div class="titlepage"><div><div><h4 class="title"><a id="idp164256"></a>Main Sequence Diagrams</h4></div></div></div> 494 495 496 <div class="figure"><a id="idp164896"></a><p class="title"><strong>Figure 11. General sequence diagram</strong></p><div class="figure-contents"> 497 498 499 <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"></img></div> 500 </div></div><br class="figure-break"></br> 501 </div> 502 </div> 503 </div> 504 505 <div class="sect1" title="User Guide for a Publisher, Subscriber and NotificationConsumer"><div class="titlepage"><div><div><h2 class="title"><a id="idp168048"></a>User Guide for a Publisher, Subscriber and 506 NotificationConsumer<span class="emphasis"><em> </em></span></h2></div></div></div> 507 508 509 <div class="sect2" title="Prefixes and Namespaces"><div class="titlepage"><div><div><h3 class="title"><a id="idp169120"></a>Prefixes and Namespaces</h3></div></div></div> 510 511 512 <p>The following table presents namespaces tied with prefixes. The 1271 513 prefixes are used in example SOAP messages presented in the further 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, 514 sections.</p> 515 516 <div class="table"><a id="idp170320"></a><p class="title"><strong>Table 1. Prefixes and Namespaces</strong></p><div class="table-contents"> 517 518 519 <table summary="Prefixes and Namespaces" border="1"><colgroup><col width="70" style="text-align: left"></col><col></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> 520 </div></div><br class="table-break"></br> 521 </div> 522 523 <div class="sect2" title="Interaction with QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp188752"></a>Interaction with <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div> 524 525 526 <p>In the next subsections an issue of cooperation with <span class="emphasis"><em>QCG 527 Notification</em></span> is presented independently for a Publisher, 1399 528 Subscriber and NotificationConsumer. Although a conceptual style of 1400 529 interaction is described here in details, technical particularities of 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 530 constructing messages are presented later.</p> 531 532 <div class="sect3" title="Publisher Interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp190848"></a>Publisher Interaction</h4></div></div></div> 533 534 535 <div class="figure"><a id="idp191488"></a><p class="title"><strong>Figure 12. Publisher interaction sequence diagram</strong></p><div class="figure-contents"> 536 537 538 <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"></img></div> 539 </div></div><br class="figure-break"></br> 540 541 <p>In the most general configuration of the service, a Publisher 1427 542 has to be registered before it starts sending Notifications. In this 1428 543 situation, a Publisher sends the RegisterPublisherRequest message to 1429 1430 <span class="emphasis"> 1431 <em>QCG Notification 1432 </em> 1433 </span>. If everything goes well it 544 <span class="emphasis"><em>QCG Notification</em></span>. If everything goes well it 1434 545 receives the RegisterPublisherResponse message with a session ID. From 1435 546 this time a Publisher is entitled for sending Notify messages - the … … 1439 550 replaces the old one in CurrentMessages. After work, a Publisher 1440 551 should unregister himself by sending DestroyRegistration. This message 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>. 552 has to include a session ID likewise.</p> 553 </div> 554 555 <div class="sect3" title="Subscriber interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp196000"></a>Subscriber interaction</h4></div></div></div> 556 557 558 <div class="figure"><a id="idp196640"></a><p class="title"><strong>Figure 13. Subscriber interaction sequence diagram</strong></p><div class="figure-contents"> 559 560 561 <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"></img></div> 562 </div></div><br class="figure-break"></br> 563 564 <p>When a Subscriber wants to create a Subscription, it sends the 565 SubscribeRequest message to <span class="emphasis"><em>QCG Notification</em></span>. 1473 566 This message should contain an address of NotificationConsumer and a 1474 567 TopicExpression that specifies a Topic or a set of Topics on which … … 1478 571 From the version 2.5.0 of the system, the Subscriber may specify XSLT 1479 572 document that will be used to transform message content by certain 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 573 publishing modules. After creation of a Subscription <span class="emphasis"><em>QCG 574 Notification</em></span> sends the SubscribeResponse message with a 1486 575 created Subscription ID. This ID should be attached to the 1487 576 UnsubscribeRequest message when a Subscription is not wanted and the 1488 577 Renew message when a Subscription should be refreshed. A Subscriber is 1489 allowed to create many equal Subscriptions. 1490 </p> 1491 <p>If a scenario requires pull-style of notifications, a Subscriber578 allowed to create many equal Subscriptions.</p> 579 580 <p>If a scenario requires pull-style of notifications, a Subscriber 1492 581 can create a set of PullPoints. In a such situation, it has to invoke 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 582 the CreatePullPoint method offered by <span class="emphasis"><em>QCG Notification. 583 <span class="emphasis"><em>The response parameter of this method will be an address to 584 the newly created <span class="emphasis"><em>PullPoint resource (Subscribers can assign 1502 585 this resources as NotificationConsumers in theirs Subscriptions). A 1503 586 PullPoint resource can be destroyed by the DestroyPullPoint message 1504 587 sent directly to this resource. 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 588 </em></span></em></span></em></span></p> 589 </div> 590 591 <div class="sect3" title="NotificationConsumer Interaction"><div class="titlepage"><div><div><h4 class="title"><a id="idp203344"></a>NotificationConsumer Interaction</h4></div></div></div> 592 593 594 <div class="figure"><a id="idp204112"></a><p class="title"><strong>Figure 14. NotificationConsumer interaction sequence diagram</strong></p><div class="figure-contents"> 595 596 597 <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"></img></div> 598 </div></div><p><br class="figure-break"></br>The main capability of a NotificationConsumer is a 1538 599 receiving of Notify messages. A NotificationConsumer can implement an 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 600 interface for receiving Notify messages sending by <span class="emphasis"><em>QCG 601 Notification</em></span> or can be a client of a PullPoint. In the 1545 602 second case, a NotificationConsumer can invoke GetMessages method 1546 603 offered by a certain PullPoint. Messages buffered in the PullPoint 1547 604 will be removed from the buffer and delivered in GetMessagesResponse 1548 to the consumer. 1549 </p> 1550 <p>On the other hand, when a NotificationConsumer wants to receive605 to the consumer.</p> 606 607 <p>On the other hand, when a NotificationConsumer wants to receive 1551 608 the last Notification message sent on a specific Topic, it can do this 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> 609 by sending GetCurrentMessageRequest to <span class="emphasis"><em>QCG 610 Notification</em></span>. Requested Notification will be supplied in 611 the GetCurrentMessageResponse message.</p> 612 </div> 613 </div> 614 615 <div xml:lang="" class="sect2" title="Topics, TopicExpressions and Dialects"><div class="titlepage"><div><div><h3 class="title"><a id="ted"></a>Topics, TopicExpressions and Dialects</h3></div></div></div> 616 617 618 <p>Before start-up of a <span class="emphasis"><em>QCG Notification</em></span> 1577 619 service, there should be defined Topic Namespaces in a system. Topic 1578 620 Namespaces should be created (usually by Publishers) and delivered to 1579 a 1580 <span class="emphasis"> 1581 <em> QCG Notification 1582 </em> 1583 </span> administrator in a form of XML 621 a<span class="emphasis"><em> QCG Notification</em></span> administrator in a form of XML 1584 622 documents. A following record presents a sample Topic Namespace 1585 623 identified by 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 624 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics.</em></span></p> 625 626 <pre class="programlisting"><wstop:TopicNamespace 1593 627 xmlns:wstop="http://docs.oasis-open.org/wsn/t-1" 1594 628 targetNamespace="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"> … … 1609 643 </wstop:Topic> 1610 644 </wstop:Topic> 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 645 </wstop:TopicNamespace></pre> 646 647 <p><span class="emphasis"><em>QCG Notification </em></span>supports three types of 648 dialects: <span class="emphasis"><em>Simple</em></span>, <span class="emphasis"><em>Concrete</em></span> and 649 <span class="emphasis"><em>Full</em></span>. If a message refer to Topics, it has to 1632 650 define TopicExpression that identifies one or more Topics (note there 1633 651 are situations when TopicExpression has to refer to exactly one Topic). … … 1636 654 select an appropriate Topic Namespace, the first part of TopicExpression 1637 655 should be presented in a form of a prefix that refers to this 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 656 namespace.</p> 657 658 <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> 659 and check out examples of methods in the <a class="link" href="#methodsdescription">section 3.4.</a></p> 660 </div> 661 662 <div class="sect2" title="Extensions"><div class="titlepage"><div><div><h3 class="title"><a id="idp217984"></a>Extensions</h3></div></div></div> 663 664 665 <p>The Oasis standard for notifications doesn't define details for 1659 666 lower Levels of functionality so an architect of system is obligated 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 667 introduce some extensions and clarifications. In the <span class="emphasis"><em>QCG 668 Notification </em></span>scenario there are several messages that have to 1666 669 be expanded with additional information written as embedded XML. Some of 1667 670 these extensions are related with other Oasis standards but some are 1668 671 quite new. Technical details are described in the successive 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 672 subsections.</p> 673 674 <div class="sect3" title="TopicExpression"><div class="titlepage"><div><div><h4 class="title"><a id="idp219920"></a>TopicExpression</h4></div></div></div> 675 676 677 <p><span class="emphasis"><em>QCG Notification </em></span>remote peers have to use 1686 678 an appropriate TopicExpression XML element. The schema of this element 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 679 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"> 680 http://docs.oasis-open.org/wsn/b-2.xsd</a></a>. Please note 1693 681 here that the Nofity and GetCurrentMessageRequest messages contain a 1694 682 Topic element which contains a required @Dialect attribute. Also … … 1696 684 with the WSDL document, a @Dialect from the Topic element is 1697 685 significant. It is not necessary but preferred to attach the same 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 686 @Dialect in the TopicExpression element against.</p> 687 </div> 688 689 <div class="sect3" title="QCG Notification Extensions"><div class="titlepage"><div><div><h4 class="title"><a id="idp222944"></a><span class="emphasis"><em>QCG Notification</em></span> Extensions</h4></div></div></div> 690 691 692 <p><span class="emphasis"><em>QCG Notification</em></span> introduces some extensions 1720 693 to WSDL as well as schema documents related to the Oasis standard. The 1721 694 following schema defines these extensions. The first three elements … … 1726 699 managing methods, the elements are used in order to: listing 1727 700 Subscriptions, listing PublisherRegistrations and listing 1728 PullPoints. 1729 </p> 1730 <pre class="programlisting"><?xml version="1.0" encoding="UTF-8"?>701 PullPoints.</p> 702 703 <pre class="programlisting"><?xml version="1.0" encoding="UTF-8"?> 1731 704 <xsd:schema 1732 705 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions" … … 2035 1008 </xsd:element> 2036 1009 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 1010 </xsd:schema></pre> 1011 </div> 1012 </div> 1013 1014 <div class="sect2" title="Methods Description"><div class="titlepage"><div><div><h3 class="title"><a id="idp238384"></a>Methods Description</h3></div></div></div> 1015 1016 1017 <p>The main idea of this chapter is to present the types of messages 1018 used in the <span class="emphasis"><em>QCG Notification</em></span> scenario as well as 2057 1019 introduce how to construct and interpret these messages. The majority of 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 1020 them is two-way style and initiated by <span class="emphasis"><em>QCG 1021 Notification</em></span> clients. Exception is the Notify message that is 2064 1022 one-way style. In the first phase it is transported from a Publisher to 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 1023 <span class="emphasis"><em>QCG Notification</em></span> and in the second it is 1024 transported from <span class="emphasis"><em>QCG Notification</em></span> to subscribed 1025 NotificationConsumers.</p> 1026 1027 <p>All supported by <span class="emphasis"><em>QCG Notification</em></span> message 1028 types are presented and explained below.</p> 1029 1030 <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> 1031 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1032 <p>The key information are thick;</p> 1033 </li><li class="listitem"> 1034 <p>A base of the messages structure is a delivered WSDL file, 1035 however there are also extensions;</p> 1036 </li><li class="listitem"> 1037 <p>For all messages it is important to set a correct 2100 1038 WS-Addressing Action property which should be the same as SOAP 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 1039 Action.</p> 1040 </li></ul></div> 1041 </div> 1042 1043 <div class="sect3" title="SubscribeRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp246400"></a>SubscribeRequest</h4></div></div></div> 1044 1045 1046 <p>SubscribeRequest is sent by a Subscriber to <span class="emphasis"><em>QCG 1047 Notification</em></span>. The message should contain information about 2123 1048 a NotificationConsumer and an expression defining Topic or Topics that 2124 1049 the Subscription will affect. If a message processing is successful, a 2125 1050 Subscription is created. It is possible to create many equal 2126 1051 Subscriptions by sending numerously the same SubscribeRequest 2127 message. 2128 </p> 2129 <pre class="programlisting">SOAP-ENV:Envelope ... >1052 message.</p> 1053 1054 <pre class="programlisting">SOAP-ENV:Envelope ... > 2130 1055 <SOAP-ENV:Header> 2131 1056 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2132 2133 <span class="bold"> 2134 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2135 NotificationProducer/SubscribeRequest 2136 </strong> 2137 </span> 1057 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1058 NotificationProducer/SubscribeRequest</strong></span> 2138 1059 </wsa:Action> 2139 1060 ... … … 2143 1064 <wsnt:ConsumerReference> 2144 1065 <wsa:Address> 2145 2146 <span class="bold"> 2147 <strong>https://localhost:2233 2148 </strong> 2149 </span> 1066 <span class="bold"><strong>https://localhost:2233</strong></span> 2150 1067 </wsa:Address> 2151 1068 </wsnt:ConsumerReference> 2152 1069 <wsnt:Filter> 2153 1070 <wsnt:TopicExpression 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> 1071 <span class="bold"><strong>xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"</strong></span> 1072 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1073 <span class="bold"><strong>tns://*</strong></span> 2173 1074 </wsnt:TopicExpression> 2174 1075 <wsnt:MessageContent 2175 2176 <span class="bold"> 2177 <strong>xmlns:smnex=http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage 2178 </strong> 2179 </span> 1076 <span class="bold"><strong>xmlns:smnex=http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage</strong></span> 2180 1077 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 2181 2182 <span class="bold"> 2183 <strong>boolean(//smnex:State[text()="on"]) 2184 </strong> 2185 </span> 1078 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 2186 1079 </wsnt:MessageContent> 2187 1080 </wsnt:Filter> 2188 1081 <wsnt:InitialTerminationTime> 2189 2190 <span class="bold"> 2191 <strong>2007-07-23T10:24:14+02:00 2192 </strong> 2193 </span> 1082 <span class="bold"><strong>2007-07-23T10:24:14+02:00</strong></span> 2194 1083 </wsnt:InitialTerminationTime> 2195 1084 <smn-ext:XSLTTranslation> 2196 <![[CDATA 2197 <span class="bold"> 2198 <strong> 1085 <![[CDATA<span class="bold"><strong> 2199 1086 <?xml version="1.0" encoding="ISO-8859-1"?> 2200 1087 <xsl:stylesheet version 1.0" … … 2209 1096 Value of State is: <xsl:value-of select="."/> 2210 1097 </xsl:template> 2211 </xsl:stylesheet> 2212 </strong> 2213 </span> 1098 </xsl:stylesheet></strong></span> 2214 1099 ]]> 2215 1100 </smn-ext:XSLTTranslation> 2216 1101 </wsnt:Subscribe> 2217 1102 </SOAP-ENV:Body> 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 1103 </SOAP-ENV:Envelope></pre> 1104 1105 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1106 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1107 1108 <p>For this message should always be: 1109 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1110 NotificationProducer/SubscribeRequest. <span class="emphasis"><em>If differ, a 1111 fault will be returned.</em></span></em></span></p> 1112 </li><li class="listitem"> 1113 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:ConsumerReference/wsa:Address</em></span></p> 1114 1115 <p>A Consumer address. It is significant to specify a correct 2251 1116 prefix (http, https, xmpp). The prefix should be adequate to the 2252 expected type of connection between 2253 <span class="emphasis"> 2254 <em>QCG 2255 Notification 2256 </em> 2257 </span> and NotificationConsumer(s): http for 1117 expected type of connection between <span class="emphasis"><em>QCG 1118 Notification</em></span> and NotificationConsumer(s): http for 2258 1119 anonymous, https for ssl-based and xmpp for sending notifications 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 1120 to jabber clients.</p> 1121 </li><li class="listitem"> 1122 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter</em></span></p> 1123 1124 <p>In this element, a Subscriber defines filtering parameters 2270 1125 to the Subscription being created. In other words, it identifies a 2271 1126 type of Notifications that should be forwarded to the selected 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 1127 Notification Consumer.</p> 1128 </li><li class="listitem"> 1129 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression</em></span></p> 1130 1131 <p><span class="emphasis"><em><span class="emphasis"><em>This element defines Topic or Topics 2287 1132 that Subscription should affect. Topics should come from supported 2288 1133 Topic Namespaces that are also defined for the element. … … 2291 1136 TopicExpression element and assigned to some prefix (e.g. tns) or 2292 1137 (2) using inline form (e.g. 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 1138 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}//*).</em></span></em></span></p> 1139 </li><li class="listitem"> 1140 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:TopicExpression/@Dialect</em></span></p> 1141 1142 <p>URI that specifies a TopicExpression Dialect type. Allowed 2308 1143 Dialects types are as follows: 2309 2310 <span class="emphasis"> 2311 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1144 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 2312 1145 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 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 1146 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</em></span></p> 1147 </li><li class="listitem"> 1148 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:Filter/wsnt:MessageContent</em></span></p> 1149 1150 <p>An optional element. If present, the MessageContent should 2326 1151 define an XPath boolean expression that will be evaluated over 2327 1152 redistributed Notification Messages to true or false. If such an … … 2332 1157 boolean(//{http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage}State[text()="on"].The 2333 1158 Dialect should always be: 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 1159 <span class="emphasis"><em>http://www.w3.org/TR/1999/REC-xpath-19991116</em></span></p> 1160 </li><li class="listitem"> 1161 <p><span class="emphasis"><em>//wsnt:Subscribe/wsnt:InitialTerminationTime</em></span></p> 1162 1163 <p>An optional element. If present, must contain a Subscriber 2349 1164 suggestion for the termination time of the Subscription being 2350 1165 created (expressed as a local time with timezone). If not present, 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 1166 the termination time is determined automatically - <span class="emphasis"><em>QCG 1167 Notification <span class="emphasis"><em>specify a default time 1168 period</em></span></em></span> for the Subscription to be 1169 valid.</p> 1170 </li><li class="listitem"> 1171 <p><span class="emphasis"><em>//wsnt:Subscribe/smn-ext:XSLTTranslation</em></span></p> 1172 1173 <p>An optional element. Inside the XSLTTranslation a Subscriber 2373 1174 may deliver an XSLT document that will be used by some publishing 2374 1175 modules to transform notification messages to a different form 2375 1176 (for example user readable). Note that an actual XSLT document 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> 1177 should be enclosed in <![[CDATA and ]]> markers.</p> 1178 </li></ul></div> 1179 </div> 1180 1181 <div class="sect3" title="SubscribeResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp272816"></a>SubscribeResponse</h4></div></div></div> 1182 1183 1184 <p>In answer on SubscribeRequest there is sent the 1185 SubscribeResponse message. <span class="emphasis"><em>QCG Notification</em></span> 2398 1186 deliver in this message a reference to the created Subscription. This 2399 ID can be used for manipulation and to remove the Subscription. 2400 </p> 2401 <pre class="programlisting"><SOAP-ENV:Envelope ... >1187 ID can be used for manipulation and to remove the Subscription.</p> 1188 1189 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2402 1190 <SOAP-ENV:Header> 2403 1191 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2404 2405 <span class="bold"> 2406 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2407 NotificationProducer/SubscribeResponse 2408 </strong> 2409 </span> 1192 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1193 NotificationProducer/SubscribeResponse</strong></span> 2410 1194 </wsa:Action> 2411 1195 ... … … 2415 1199 <wsnt:SubscriptionReference> 2416 1200 <wsa:Address> 2417 2418 <span class="bold"> 2419 <strong>http://some.address 2420 </strong> 2421 </span> 1201 <span class="bold"><strong>http://some.address</strong></span> 2422 1202 </wsa:Address> 2423 1203 <wsa:ReferenceParameters> 2424 2425 <span class="bold"> 2426 <strong><SubscriptionID 1204 <span class="bold"><strong><SubscriptionID 2427 1205 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions"> 2428 1206 506435877 2429 </SubscriptionID> 2430 </strong> 2431 </span> 1207 </SubscriptionID></strong></span> 2432 1208 </wsa:ReferenceParameters> 2433 1209 </wsnt:SubscriptionReference> 2434 1210 </wsnt:SubscribeResponse> 2435 1211 </SOAP-ENV:Body> 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 1212 </SOAP-ENV:Envelope></pre> 1213 1214 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1215 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1216 1217 <p>For this message should always be: 1218 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1219 NotificationProducer/SubscribeResponse. <span class="emphasis"><em>If differ, a 1220 fault will be returned.</em></span></em></span></p> 1221 </li><li class="listitem"> 1222 <p><span class="emphasis"><em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/wsa:Address</em></span></p> 1223 1224 <p>An address of a SubscriptionManager interface. In the 1225 current solution it is the <span class="emphasis"><em>QCG Notification</em></span> 1226 service address.</p> 1227 </li><li class="listitem"> 1228 <p><span class="emphasis"><em>//wsnt:SubscribeResponse/wsnt:SubscriptionReference/</em></span></p> 1229 1230 <p><span class="emphasis"><em>wsa:ReferenceParameters/SubscriptionID</em></span></p> 1231 1232 <p>An extensive element in xsd:any that contains Subscription 1233 ID. At this time it is at most 32 char long string.</p> 1234 </li></ul></div> 1235 </div> 1236 1237 <div class="sect3" title="RenewRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp284192"></a>RenewRequest</h4></div></div></div> 1238 1239 1240 <p>When a Subscriber wants to renew a Subscription, it can send the 1241 RenewRequest message to <span class="emphasis"><em>QCG Notification</em></span>. The 2513 1242 message should contain the Subscription ID element and a new 2514 termination time suggestion. 2515 </p> 2516 <pre class="programlisting"><SOAP-ENV:Envelope ... >1243 termination time suggestion.</p> 1244 1245 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2517 1246 <SOAP-ENV:Header> 2518 1247 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2519 2520 <span class="bold"> 2521 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2522 SubscriptionManager/RenewRequest 2523 </strong> 2524 </span> 1248 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1249 SubscriptionManager/RenewRequest</strong></span> 2525 1250 </wsa:Action> 2526 1251 ... … … 2529 1254 <wsnt:Renew> 2530 1255 <wsnt:TerminationTime> 2531 2532 <span class="bold"> 2533 <strong>2007-07-25T12:24:14+02:00 2534 </strong> 2535 </span> 1256 <span class="bold"><strong>2007-07-25T12:24:14+02:00</strong></span> 2536 1257 </wsnt:TerminationTime> 2537 1258 <smn-ext:SubscriptionID> 2538 2539 <span class="bold"> 2540 <strong>506435877 2541 </strong> 2542 </span> 1259 <span class="bold"><strong>506435877</strong></span> 2543 1260 </smn-ext:SubscriptionID> 2544 1261 </wsnt:Renew> 2545 1262 </SOAP-ENV:Body> 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 1263 </SOAP-ENV:Envelope></pre> 1264 1265 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1266 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1267 1268 <p>For this message should always be: 1269 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1270 SubscriptionManager/RenewRequest. <span class="emphasis"><em>If differ, a fault 1271 will be returned.</em></span></em></span></p> 1272 </li><li class="listitem"> 1273 <p>//wsnt:Renew/wsnt:TerminationTime</p> 1274 1275 <p>A Subscriber suggestion for the new termination time of the 2575 1276 Subscription being renewed (expressed as a local time with 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 1277 timezone).</p> 1278 </li><li class="listitem"> 1279 <p><span class="emphasis"><em>//wsnt:Renew/smn-ext:SubscriptionID</em></span></p> 1280 1281 <p>A Subscription ID that was received in the SubscribeResponse 1282 message.</p> 1283 </li></ul></div> 1284 </div> 1285 1286 <div class="sect3" title="RenewResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp294784"></a>RenewResponse</h4></div></div></div> 1287 1288 1289 <p>An answer to the RenewRequest message is RenewResponse. The 2604 1290 message contains a termination time for the renewed 2605 Subscription. 2606 </p> 2607 <pre class="programlisting"><SOAP-ENV:Envelope ... >1291 Subscription.</p> 1292 1293 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2608 1294 <SOAP-ENV:Header> 2609 1295 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2610 2611 <span class="bold"> 2612 <strong> http://docs.oasis-open.org/wsn/bw-2/ 2613 SubscriptionManager/RenewResponse 2614 </strong> 2615 </span> 1296 <span class="bold"><strong> http://docs.oasis-open.org/wsn/bw-2/ 1297 SubscriptionManager/RenewResponse</strong></span> 2616 1298 </wsa:Action> 2617 1299 ... … … 2620 1302 <wsnt:RenewResponse> 2621 1303 <wsnt:TerminationTime> 2622 2623 <span class="bold"> 2624 <strong>2007-07-25T10:24:14Z 2625 </strong> 2626 </span> 1304 <span class="bold"><strong>2007-07-25T10:24:14Z</strong></span> 2627 1305 </wsnt:TerminationTime> 2628 1306 <wsnt:CurrentTime> 2629 2630 <span class="bold"> 2631 <strong>2007-07-24T10:24:14Z 2632 </strong> 2633 </span> 1307 <span class="bold"><strong>2007-07-24T10:24:14Z</strong></span> 2634 1308 </wsnt:CurrentTime> 2635 1309 </wsnt:RenewResponse> 2636 1310 </SOAP-ENV:Body> 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 ... > 1311 </SOAP-ENV:Envelope></pre> 1312 1313 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1314 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1315 1316 <p>For this message should always be: 1317 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1318 SubscriptionManager/RenewResponse. <span class="emphasis"><em>If differ, a fault 1319 will be returned.</em></span></em></span></p> 1320 </li><li class="listitem"> 1321 <p><span class="emphasis"><em>//wsnt:RenewResponse/wsnt:TerminationTime</em></span></p> 1322 1323 <p>A new termination time for the renewed Subscription 1324 (expressed as UTC Time).</p> 1325 </li></ul></div> 1326 1327 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1328 <p><span class="emphasis"><em>//wsnt:RenewResponse/wsnt:CurrentTime</em></span></p> 1329 1330 <p><span class="emphasis"><em><span class="emphasis"><em>A </em></span>QCG 1331 Notification's</em></span> time when the Subscription was renewing 1332 (expressed as UTC Time).</p> 1333 </li></ul></div> 1334 </div> 1335 1336 <div class="sect3" title="UnsubscribeRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp306512"></a>UnsubscribeRequest</h4></div></div></div> 1337 1338 1339 <p>When a Subscriber wants to terminate a Subscription, it has to 1340 send the UnsubscribeRequest message to <span class="emphasis"><em>QCG 1341 Notification</em></span>. The parameter attached to this request is a 1342 Subscription ID.</p> 1343 1344 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2720 1345 <SOAP-ENV:Header> 2721 1346 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2722 2723 <span class="bold"> 2724 <strong>http://docs.oasis-open.org/wsn/bw-2/ 2725 SubscriptionManager/UnsubscribeRequest 2726 </strong> 2727 </span> 1347 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1348 SubscriptionManager/UnsubscribeRequest</strong></span> 2728 1349 </wsa:Action> 2729 1350 ... … … 2732 1353 <wsnt:Unsubscribe> 2733 1354 <smn-ext:SubscriptionID> 2734 2735 <span class="bold"> 2736 <strong>506435877 2737 </strong> 2738 </span> 1355 <span class="bold"><strong>506435877</strong></span> 2739 1356 </smn-ext:SubscriptionID> 2740 1357 </wsnt:Unsubscribe> 2741 1358 </SOAP-ENV:Body> 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 ... > 1359 </SOAP-ENV:Envelope></pre> 1360 1361 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1362 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1363 1364 <p>For this message should always be: 1365 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1366 SubscriptionManager/UnsubscribeRequest. <span class="emphasis"><em>If differ, a 1367 fault will be returned.</em></span></em></span></p> 1368 </li><li class="listitem"> 1369 <p><span class="emphasis"><em>//wsnt:Unsubscribe/smn-ext:SubscriptionID</em></span></p> 1370 1371 <p>A Subscription ID that was received in the SubscribeResponse 1372 message.</p> 1373 </li></ul></div> 1374 </div> 1375 1376 <div class="sect3" title="UnsubscribeResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp315248"></a>UnsubscribeResponse</h4></div></div></div> 1377 1378 1379 <p>UnsubscribeResponse is returned to a Subscriber after 1380 successfully processing the UnsubscribeRequest message.</p> 1381 1382 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2795 1383 <SOAP-ENV:Header> 2796 1384 <wsa:Action SOAP-ENV:mustUnderstAand="1"> 2797 2798 <span class="bold"> 2799 <strong> http://docs.oasis-open.org/wsn/bw-2/ 2800 SubscriptionManager/UnsubscribeResponse 2801 </strong> 2802 </span> 1385 <span class="bold"><strong> http://docs.oasis-open.org/wsn/bw-2/ 1386 SubscriptionManager/UnsubscribeResponse</strong></span> 2803 1387 </wsa:Action> 2804 1388 ... … … 2808 1392 </wsnt:UnsubscribeResponse> 2809 1393 </SOAP-ENV:Body> 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 ... > 1394 </SOAP-ENV:Envelope></pre> 1395 1396 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1397 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1398 1399 <p>For this message should always be: 1400 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1401 SubscriptionManager/UnsubscribeResponse. <span class="emphasis"><em>If differ, a 1402 fault will be returned.</em></span></em></span></p> 1403 </li></ul></div> 1404 </div> 1405 1406 <div class="sect3" title="RegisterPublisherRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp321392"></a>RegisterPublisherRequest</h4></div></div></div> 1407 1408 1409 <p>In order to sending Notifications, a Publisher can be obligated 1410 to register himself previously in <span class="emphasis"><em>QCG 1411 Notification</em></span>. For this purpose, it sends the 1412 RegisterPublisherRequest message to <span class="emphasis"><em>QCG 1413 Notification</em></span>.</p> 1414 1415 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2863 1416 <SOAP-ENV:Header> 2864 1417 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2865 2866 <span class="bold"> 2867 <strong>http://docs.oasis-open.org/wsn/brw-2/ 2868 RegisterPublisher/RegisterPublisherRequest 2869 </strong> 2870 </span> 1418 <span class="bold"><strong>http://docs.oasis-open.org/wsn/brw-2/ 1419 RegisterPublisher/RegisterPublisherRequest</strong></span> 2871 1420 </wsa:Action> 2872 1421 ... … … 2875 1424 <wsnbr:RegisterPublisher> 2876 1425 <wsnbr:Demand> 2877 2878 <span class="bold"> 2879 <strong>false 2880 </strong> 2881 </span> 1426 <span class="bold"><strong>false</strong></span> 2882 1427 </wsnbr:Demand> 2883 1428 <wsnbr:InitialTerminationTime> 2884 2885 <span class="bold"> 2886 <strong>2007-07-23T10:24:14+02:00 2887 </strong> 2888 </span> 1429 <span class="bold"><strong>2007-07-23T10:24:14+02:00</strong></span> 2889 1430 </wsnbr:InitialTerminationTime> 2890 1431 </wsnbr:RegisterPublisher> 2891 1432 </SOAP-ENV:Body> 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 1433 </SOAP-ENV:Envelope></pre> 1434 1435 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1436 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1437 1438 <p>For this message should always be: 1439 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 1440 RegisterPublisher/RegisterPublisherRequest. <span class="emphasis"><em>If differ, a 1441 fault will be returned.</em></span></em></span></p> 1442 </li><li class="listitem"> 1443 <p><span class="emphasis"><em>//wsnbr:RegisterPublisher/wsnbr:Demand</em></span></p> 1444 1445 <p>Determine a demand-based pattern. At this time this pattern 1446 isn't supported so default <span class="emphasis"><em>false</em></span> is the sole 1447 accepted value.</p> 1448 </li><li class="listitem"> 1449 <p><span class="emphasis"><em>//wsnbr:RegisterPublisher/wsnbr:InitialTerminationTime</em></span></p> 1450 1451 <p>An optional element. If present, must contain the requester 2941 1452 suggestion for the termination time of the Registration being 2942 1453 created (expressed as a local time with timezone). If not present, 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. 1454 the termination time is determined automatically - <span class="emphasis"><em>QCG 1455 Notification <span class="emphasis"><em>specify the default time 1456 period</em></span></em></span> for the Registration to be valid. 1457 Every Notify message renews the termination time.</p> 1458 </li></ul></div> 1459 </div> 1460 1461 <div class="sect3" title="RegisterPublisherResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp334336"></a>RegisterPublisherResponse</h4></div></div></div> 1462 1463 1464 <p>In a response to a successful registration process, 1465 <span class="emphasis"><em>QCG Notification</em></span> sends RegisterPublisherResponse. 2976 1466 This message contains a reference to the created Registration. The 2977 attached ID is necessary to send any Notification message. 2978 </p> 2979 <pre class="programlisting"><SOAP-ENV:Envelope ... >1467 attached ID is necessary to send any Notification message.</p> 1468 1469 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2980 1470 <SOAP-ENV:Header> 2981 1471 <wsa:Action SOAP-ENV:mustUnderstand="1"> 2982 2983 <span class="bold"> 2984 <strong>http://docs.oasis-open.org/wsn/brw-2/ 2985 RegisterPublisher/RegisterPublisherResponse 2986 </strong> 2987 </span> 1472 <span class="bold"><strong>http://docs.oasis-open.org/wsn/brw-2/ 1473 RegisterPublisher/RegisterPublisherResponse</strong></span> 2988 1474 </wsa:Action> 2989 1475 </SOAP-ENV:Header> … … 2992 1478 <wsnbr:PublisherRegistrationReference> 2993 1479 <wsa:Address> 2994 2995 <span class="bold"> 2996 <strong>http://some.address 2997 </strong> 2998 </span> 1480 <span class="bold"><strong>http://some.address</strong></span> 2999 1481 </wsa:Address> 3000 1482 <wsa:ReferenceParameters> 3001 3002 <span class="bold"> 3003 <strong><RegisterPublisherID 1483 <span class="bold"><strong><RegisterPublisherID 3004 1484 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/extensions"> 3005 1485 1207382668 3006 </RegisterPublisherID> 3007 </strong> 3008 </span> 1486 </RegisterPublisherID></strong></span> 3009 1487 </wsa:ReferenceParameters> 3010 1488 </wsnbr:PublisherRegistrationReference> 3011 1489 </wsnbr:RegisterPublisherResponse> 3012 1490 </SOAP-ENV:Body> 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 1491 </SOAP-ENV:Envelope></pre> 1492 1493 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1494 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1495 1496 <p>For this message should always be: 1497 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/RegisterPublisher/RegisterPublisherResponse. 1498 <span class="emphasis"><em>If differ, a fault will be 1499 returned.</em></span></em></span></p> 1500 </li><li class="listitem"> 1501 <p><span class="emphasis"><em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:Address</em></span></p> 1502 1503 <p>An address of a PublisherRegistration Manager interface. In 1504 the current solution it is the <span class="emphasis"><em>QCG 1505 Notification</em></span> service address.</p> 1506 </li><li class="listitem"> 1507 <p><span class="emphasis"><em>//wsnbr:RegisterPublisherResponse/wsnbr:PublisherRegistrationReference/wsa:ReferenceParameters/RegisterPublisherID</em></span></p> 1508 1509 <p>An extensive element in xsd:any that contains a Publisher 3062 1510 Registration ID. It defines a session that is created after 3063 1511 registration and removed by sending the DestroyRegistration 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 1512 message. At this time it is at most 32 char long string.</p> 1513 </li></ul></div> 1514 </div> 1515 1516 <div class="sect3" title="Notify"><div class="titlepage"><div><div><h4 class="title"><a id="idp346192"></a>Notify</h4></div></div></div> 1517 1518 1519 <p>Notify consists of one or many NotificationMessages. Any of them 3081 1520 is a separate Notification message and is processed independently. 3082 1521 NotificationMessage should define a single Topic it concerns. 3083 1522 TopicExpression should be written in the same Dialect that the 3084 1523 Subscription was created in. The Publisher Registration ID has to be 3085 attached to Notify messages. 3086 </p> 3087 <pre class="programlisting"><SOAP-ENV:Envelope ... >1524 attached to Notify messages.</p> 1525 1526 <pre class="programlisting"><SOAP-ENV:Envelope ... > 3088 1527 <SOAP-ENV:Header> 3089 1528 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3090 3091 <span class="bold"> 3092 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3093 NotificationConsumer/Notify 3094 </strong> 3095 </span> 1529 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1530 NotificationConsumer/Notify</strong></span> 3096 1531 </wsa:Action> 3097 1532 </SOAP-ENV:Header> … … 3100 1535 <wsnt:NotificationMessage> 3101 1536 <wsnt:Topic 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> 1537 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span><span class="bold"><strong> 1538 xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"> 1539 tns:House/Kitchen/Light</strong></span> 3117 1540 </wsnt:Topic> 3118 1541 <wsnt:ProducerReference> 3119 1542 <wsa:Address> 3120 3121 <span class="bold"> 3122 <strong>http://some.address 3123 3124 </strong> 3125 </span><wsa:Address> 1543 <span class="bold"><strong>http://some.address 1544 </strong></span><wsa:Address> 3126 1545 <wsnt:ProducerReference> 3127 1546 <wsnt:Message> 3128 3129 <span class="bold"> 3130 <strong><smnex:State 1547 <span class="bold"><strong><smnex:State 3131 1548 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 3132 1549 on 3133 </smnex:State> 3134 </strong> 3135 </span> 1550 </smnex:State></strong></span> 3136 1551 </wsnt:Message> 3137 1552 </wsnt:NotificationMessage> 3138 1553 <smn-ext:RegisterPublisherID> 3139 3140 <span class="bold"> 3141 <strong>1207382668 3142 </strong> 3143 </span> 1554 <span class="bold"><strong>1207382668</strong></span> 3144 1555 </smn-ext:RegisterPublisherID> 3145 1556 </wsnt:Notify> 3146 1557 </SOAP-ENV:Body> 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 1558 </SOAP-ENV:Envelope></pre> 1559 1560 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1561 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1562 1563 <p>For this message should always be: 1564 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer/Notify. 1565 <span class="emphasis"><em>If differ, a fault will be 1566 returned.</em></span></em></span></p> 1567 </li><li class="listitem"> 1568 <p><span class="emphasis"><em>//wsnt:Notify</em></span></p> 1569 1570 <p><span class="emphasis"><em><span class="emphasis"><em>A set of Notification 1571 messages.</em></span></em></span></p> 1572 </li><li class="listitem"> 1573 <p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage</em></span></p> 1574 1575 <p>A single Notification message.</p> 1576 </li><li class="listitem"> 1577 <p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic</em></span></p> 1578 1579 <p>The content of this element is an expression that defines 3209 1580 exactly one Topic in a specified Dialect type. The Topic should be 3210 1581 supported. The Topic may be defined in two ways: (1) using … … 3212 1583 is defined in a Topic element and assigned to some prefix (e.g. 3213 1584 tns) or (2) using inline form (e.g. 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 1585 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light).</p> 1586 </li><li class="listitem"> 1587 <p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Topic/@Dialect</em></span></p> 1588 1589 <p>URI that specifies TopicExpression Dialect type. Allowed 3225 1590 Dialect types are as follows: 3226 3227 <span class="emphasis"> 3228 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1591 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 3229 1592 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 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 ... > 1593 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full".</em></span></p> 1594 </li><li class="listitem"> 1595 <p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address</em></span></p> 1596 1597 <p>A Notification producer (Publisher) address.</p> 1598 </li><li class="listitem"> 1599 <p><span class="emphasis"><em>//wsnt:Notify/wsnt:NotificationMessage/wsnt:Message</em></span></p> 1600 1601 <p>A Notify message content. Currently supported are messages 1602 shorter than 4096 bytes.</p> 1603 </li><li class="listitem"> 1604 <p><span class="emphasis"><em>//wsnt:Notify/smn-ext:RegisterPublisherID</em></span></p> 1605 1606 <p>A Publisher Registration ID that was received in the 1607 RegisterPublisherResponse message.</p> 1608 </li></ul></div> 1609 </div> 1610 1611 <div class="sect3" title="DestroyRegistrationRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp367728"></a>DestroyRegistrationRequest</h4></div></div></div> 1612 1613 1614 <p>A Publisher can terminate a Registration by sending the 1615 DestroyRegistrationRequest message to <span class="emphasis"><em>QCG 1616 Notification</em></span>. The parameter attached to this request is a 1617 Publisher Registration ID.</p> 1618 1619 <pre class="programlisting"><SOAP-ENV:Envelope ... > 3290 1620 <SOAP-ENV:Header> 3291 1621 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3292 3293 <span class="bold"> 3294 <strong>http://docs.oasis-open-org/wsn/brw-2/ 3295 PublisherRegistrationManager/DestroyRegistrationRequest 3296 </strong> 3297 </span> 1622 <span class="bold"><strong>http://docs.oasis-open-org/wsn/brw-2/ 1623 PublisherRegistrationManager/DestroyRegistrationRequest</strong></span> 3298 1624 </wsa:Action> 3299 1625 </SOAP-ENV:Header> … … 3301 1627 <wsnbr:DestroyRegistration> 3302 1628 <smn-ext:RegisterPublisherID> 3303 3304 <span class="bold"> 3305 <strong>387837036 3306 </strong> 3307 </span> 1629 <span class="bold"><strong>387837036</strong></span> 3308 1630 </smn-ext:RegisterPublisherID> 3309 1631 </wsnbr:DestroyRegistration> 3310 1632 </SOAP-ENV:Body> 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/ 1633 </SOAP-ENV:Envelope></pre> 1634 1635 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1636 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1637 1638 <p>For this message should always be: 1639 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 3326 1640 PublisherRegistrationManager/DestroyRegistrationRequest. 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 1641 <span class="emphasis"><em>If differ, a fault will be 1642 returned.</em></span></em></span></p> 1643 </li><li class="listitem"> 1644 <p><span class="emphasis"><em>//wsnbr:DestroyRegistration/smn-ext:RegisterPublisherID</em></span></p> 1645 1646 <p>A Publisher Registration ID that was received in a 1647 RegisterPublisherResponse message.</p> 1648 </li></ul></div> 1649 </div> 1650 1651 <div class="sect3" title="DestroyRegistrationResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp377696"></a>DestroyRegistrationResponse</h4></div></div></div> 1652 1653 1654 <p>DestroyRegistrationResponse is returned to a Publisher after a 3362 1655 successful process of destroying a Publisher Registration, in a 3363 response to the DestroyRegistration message. 3364 </p> 3365 <pre class="programlisting"><SOAP-ENV:Envelope ... >1656 response to the DestroyRegistration message.</p> 1657 1658 <pre class="programlisting"><SOAP-ENV:Envelope ... > 3366 1659 <SOAP-ENV:Header> 3367 1660 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3368 3369 <span class="bold"> 3370 <strong>http://docs.oasis-open-org/wsn/brw-2/ 3371 PublisherRegistrationManager/DestroyRegistrationResponse 3372 </strong> 3373 </span> 1661 <span class="bold"><strong>http://docs.oasis-open-org/wsn/brw-2/ 1662 PublisherRegistrationManager/DestroyRegistrationResponse</strong></span> 3374 1663 </wsa:Action> 3375 1664 </SOAP-ENV:Header> … … 3378 1667 </wsn-br:DestroyRegistrationResponse> 3379 1668 </SOAP-ENV:Body> 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/ 1669 </SOAP-ENV:Envelope></pre> 1670 1671 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1672 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1673 1674 <p>For this message should always be: 1675 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/brw-2/ 3395 1676 PublisherRegistrationManager/DestroyRegistrationResponse. 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 1677 <span class="emphasis"><em>If differ, a fault will be 1678 returned.</em></span></em></span></p> 1679 </li></ul></div> 1680 </div> 1681 1682 <div class="sect3" title="CreatePullPointRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp382608"></a>CreatePullPointRequest</h4></div></div></div> 1683 1684 1685 <p>In scenarios where the pull-style of notifications delivery is 3420 1686 needed, Subscribers can create PullPoints. To do this, a Subscriber 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 ... > 1687 sends the CreatePullPointRequest message to <span class="emphasis"><em>QCG Notification 1688 PullPoint</em></span>.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3429 1689 <SOAP-ENV:Header> 3430 1690 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3431 3432 <span class="bold"> 3433 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3434 CreatePullPoint/CreatePullPointRequest 3435 </strong> 3436 </span> 1691 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1692 CreatePullPoint/CreatePullPointRequest</strong></span> 3437 1693 </wsa:Action> 3438 1694 ... … … 3442 1698 </wsnt:CreatePullPoint> 3443 1699 </SOAP-ENV:Body> 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 1700 </SOAP-ENV:Envelope></pre> 1701 1702 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1703 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1704 1705 <p>For this message should always be: 1706 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointRequest. 1707 <span class="emphasis"><em>If differ, a fault will be 1708 returned.</em></span></em></span></p> 1709 </li></ul></div> 1710 </div> 1711 1712 <div class="sect3" title="CreatePullPointResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp388896"></a>CreatePullPointResponse</h4></div></div></div> 1713 1714 1715 <p>The CreatePullPointResponse message is returned in a response to 3483 1716 the request of PullPoint creation. This message contains a reference 3484 to the just created PullPoint. 3485 </p> 3486 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1717 to the just created PullPoint. </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3487 1718 <SOAP-ENV:Header> 3488 1719 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3489 3490 <span class="bold"> 3491 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3492 CreatePullPoint/CreatePullPointResponse 3493 </strong> 3494 </span> 1720 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1721 CreatePullPoint/CreatePullPointResponse</strong></span> 3495 1722 </wsa:Action> 3496 1723 ... … … 3499 1726 <wsnt:CreatePullPointResponse> 3500 1727 <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing"> 3501 3502 <span class="bold"> 3503 <strong> http://some.address:2211?ppID=1100992448 3504 </strong> 3505 </span> 1728 <span class="bold"><strong> http://some.address:2211?ppID=1100992448</strong></span> 3506 1729 </wsa:Address> 3507 1730 </wsnt:CreatePullPointResponse> 3508 1731 </SOAP-ENV:Body> 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 1732 </SOAP-ENV:Envelope></pre> 1733 1734 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1735 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1736 1737 <p>For this message should always be: 1738 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointResponse. 1739 <span class="emphasis"><em>If differ, a fault will be 1740 returned.</em></span></em></span></p> 1741 </li><li class="listitem"> 1742 <p><span class="emphasis"><em>//wsnt:CreatePullPointResponse/wsa:Address</em></span></p> 1743 1744 <p>An logical address of the created PullPoint.</p> 1745 </li></ul></div> 1746 </div> 1747 1748 <div class="sect3" title="GetMessages"><div class="titlepage"><div><div><h4 class="title"><a id="idp397584"></a>GetMessages</h4></div></div></div> 1749 1750 1751 <p>A Pull-style NotificationConsumer can get messages buffered in a 3558 1752 PullPoint by invoking the GetMessages method. It sends the 3559 1753 GetMessagesRequest message directly to the specified PullPoint. The 3560 1754 message can contain a specification of a maximal number of 3561 1755 Notification messages that NotificationConsumer wants to receive in 3562 the response. 3563 </p> 3564 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1756 the response.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3565 1757 <SOAP-ENV:Header> 3566 1758 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3567 3568 <span class="bold"> 3569 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3570 PullPoint/GetMessagesRequest 3571 </strong> 3572 </span> 1759 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1760 PullPoint/GetMessagesRequest</strong></span> 3573 1761 </wsa:Action> 3574 1762 ... … … 3576 1764 <SOAP-ENV:Body> 3577 1765 <wsnt:GetMessages> 3578 <wsnt:MaximumNumber> 3579 <span class="bold"> 3580 <strong>10 3581 </strong> 3582 </span></wsnt:MaximumNumber> 1766 <wsnt:MaximumNumber><span class="bold"><strong>10</strong></span></wsnt:MaximumNumber> 3583 1767 </wsnt:GetMessages> 3584 1768 </SOAP-ENV:Body> 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 1769 </SOAP-ENV:Envelope></pre> 1770 1771 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1772 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1773 1774 <p>For this message should always be: 1775 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesRequest. 1776 <span class="emphasis"><em>If differ, a fault will be 1777 returned.</em></span></em></span></p> 1778 </li></ul></div> 1779 1780 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1781 <p><span class="emphasis"><em>//wsnt:GetMessages/wsnt:MaximumNumber</em></span></p> 1782 1783 <p><span class="emphasis"><em><span class="emphasis"><em>An optional element. It defines a 3626 1784 maximal number of messages that will be gotten from the 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 1785 PullPoint.</em></span></em></span></p> 1786 </li></ul></div> 1787 </div> 1788 1789 <div class="sect3" title="GetMessagesResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp405392"></a>GetMessagesResponse</h4></div></div></div> 1790 1791 1792 <p>GetMessagesResponse, a response message to GetMessages, consists 3648 1793 of a set of Notifications received from the PullPoint. 3649 3650 </p> 3651 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1794 </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3652 1795 <SOAP-ENV:Header> 3653 1796 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3654 3655 <span class="bold"> 3656 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3657 PullPoint/GetMessagesResponse 3658 </strong> 3659 </span> 1797 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1798 PullPoint/GetMessagesResponse</strong></span> 3660 1799 </wsa:Action> 3661 1800 ... … … 3665 1804 <wsnt:NotificationMessage> 3666 1805 <wsnt:Topic 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> 1806 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1807 <span class="bold"><strong>xmlns:tns="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span>"</strong></span>> 1808 <span class="bold"><strong>tns:House/Kitchen/Light</strong></span> 3686 1809 </wsnt:Topic> 3687 1810 <wsnt:ProducerReference> 3688 1811 <wsa:Address> 3689 3690 <span class="bold"> 3691 <strong>http://some.address 3692 3693 </strong> 3694 </span><wsa:Address> 1812 <span class="bold"><strong>http://some.address 1813 </strong></span><wsa:Address> 3695 1814 <wsnt:ProducerReference> 3696 1815 <wsnt:Message> 3697 3698 <span class="bold"> 3699 <strong> 3700 <span class="bold"> 3701 <strong><smnex:State 1816 <span class="bold"><strong><span class="bold"><strong><smnex:State 3702 1817 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 3703 1818 on 3704 </smnex:State> 3705 </strong> 3706 </span> 3707 </strong> 3708 </span> 1819 </smnex:State></strong></span></strong></span> 3709 1820 </wsnt:Message> 3710 1821 </wsnt:NotificationMessage> … … 3715 1826 </wsnt:GetMessagesResponse> 3716 1827 </SOAP-ENV:Body> 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 1828 </SOAP-ENV:Envelope></pre><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1829 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1830 1831 <p>For this message should always be: 1832 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/GetMessagesResponse. 1833 <span class="emphasis"><em>If differ, a fault will be 1834 returned.</em></span></em></span></p> 1835 </li><li class="listitem"> 1836 <p>//wsnt:GetMessagesResponse</p> 1837 1838 <p>A set of Notification messages. The number of messages is 3746 1839 restricted by the wsnt:MaximumNumber parameter defined in the 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 1840 GetMessagesRequest message.</p> 1841 </li><li class="listitem"> 1842 <p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage</em></span></p> 1843 1844 <p>A single Notification message.</p> 1845 </li><li class="listitem"> 1846 <p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic</em></span></p> 1847 1848 <p>The content of this element is an expression that defines 3768 1849 exactly one Topic in a specified Dialect type. The Topic should 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 1850 be supported.</p> 1851 </li><li class="listitem"> 1852 <p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Topic/@Dialect</em></span></p> 1853 1854 <p>URI that specifies a TopicExpression Dialect type. Allowed 3780 1855 Dialect types are as follows: 3781 3782 <span class="emphasis"> 3783 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1856 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 3784 1857 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 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 1858 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full".</em></span></p> 1859 </li><li class="listitem"> 1860 <p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:ProducerReference/wsa:Address</em></span></p> 1861 1862 <p>A Notification producer (Publisher) address.</p> 1863 </li><li class="listitem"> 1864 <p><span class="emphasis"><em>//wsnt:GetMessagesResponse/wsnt:NotificationMessage/wsnt:Message</em></span></p> 1865 1866 <p>A Notify message content. Currently supported are messages 1867 shorter than 4096 bytes.</p> 1868 </li></ul></div> 1869 </div> 1870 1871 <div class="sect3" title="DestroyPullPointRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp427696"></a>DestroyPullPointRequest</h4></div></div></div> 1872 1873 1874 <p>A PullPoint can be destroyed by invoking a DestroyPullPoint 3825 1875 method. An empty request message should be sent directly to the 3826 PullPoint. 3827 </p> 3828 <pre class="programlisting"><SOAP-ENV:Envelope ... > 1876 PullPoint.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3829 1877 <SOAP-ENV:Header> 3830 1878 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3831 3832 <span class="bold"> 3833 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3834 PullPoint/DestroyPullPointRequest 3835 </strong> 3836 </span> 1879 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1880 PullPoint/DestroyPullPointRequest</strong></span> 3837 1881 </wsa:Action> 3838 1882 ... … … 3842 1886 </wsnt:DestroyPullPoint> 3843 1887 </SOAP-ENV:Body> 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 ... > 1888 </SOAP-ENV:Envelope></pre> 1889 1890 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1891 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1892 1893 <p>For this message should always be: 1894 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointRequest. 1895 <span class="emphasis"><em>If differ, a fault will be 1896 returned.</em></span></em></span></p> 1897 </li></ul></div> 1898 </div> 1899 1900 <div class="sect3" title="DestroyPullPointResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp433584"></a>DestroyPullPointResponse</h4></div></div></div> 1901 1902 1903 <p>A response to a DestroyPullPointRequest message is an empty 1904 DestroyPullPointResponse message.</p><pre class="programlisting"><SOAP-ENV:Envelope ... > 3886 1905 <SOAP-ENV:Header> 3887 1906 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3888 3889 <span class="bold"> 3890 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3891 PullPoint/DestroyPullPointResponse 3892 </strong> 3893 </span> 1907 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1908 PullPoint/DestroyPullPointResponse</strong></span> 3894 1909 </wsa:Action> 3895 1910 ... … … 3899 1914 </wsnt:DestroyPullPointResponse> 3900 1915 </SOAP-ENV:Body> 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 1916 </SOAP-ENV:Envelope></pre> 1917 1918 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1919 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1920 1921 <p>For this message should always be: 1922 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/PullPoint/DestroyPullPointResponse. 1923 <span class="emphasis"><em>If differ, a fault will be 1924 returned.</em></span></em></span></p> 1925 </li></ul></div> 1926 </div> 1927 1928 <div class="sect3" title="GetCurrentMessageRequest"><div class="titlepage"><div><div><h4 class="title"><a id="idp439232"></a>GetCurrentMessageRequest</h4></div></div></div> 1929 1930 1931 <p>GetCurrentMessageRequest is useful especially when a new 3940 1932 NotificationConsumer is connecting and want to get the last published 3941 1933 Notification Message on a specified Topic. Single GetCurrentMessage 3942 1934 should refer exactly one Topic and has to be expressed in a supported 3943 Dialect type. 3944 </p> 3945 <pre class="programlisting"><SOAP-ENV:Envelope ... >1935 Dialect type.</p> 1936 1937 <pre class="programlisting"><SOAP-ENV:Envelope ... > 3946 1938 <SOAP-ENV:Header> 3947 1939 <wsa:Action SOAP-ENV:mustUnderstand="1"> 3948 3949 <span class="bold"> 3950 <strong>http://docs.oasis-open.org/wsn/bw-2/ 3951 NotificationProducer/GetCurrentMessageRequest 3952 </strong> 3953 </span> 1940 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1941 NotificationProducer/GetCurrentMessageRequest</strong></span> 3954 1942 </wsa:Action> 3955 1943 </SOAP-ENV:Header> … … 3957 1945 <wsnt:GetCurrentMessage> 3958 1946 <wsnt:Topic 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> 1947 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 1948 <span class="bold"><strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span>> 1949 <span class="bold"><strong>tns:</strong></span><span class="bold"><strong>House/Kitchen/Light</strong></span> 3978 1950 </wsnt:Topic> 3979 1951 </wsnt:GetCurrentMessage> 3980 1952 </SOAP-ENV:Body> 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 1953 </SOAP-ENV:Envelope></pre> 1954 1955 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 1956 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 1957 1958 <p>For this message should always be: 1959 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 1960 NotificationProducer/GetCurrentMessageRequest. <span class="emphasis"><em>If 1961 differ, a fault will be returned</em></span></em></span>.</p> 1962 </li><li class="listitem"> 1963 <p><span class="emphasis"><em>//wsnt:GetCurrentMessage/wsnt:Topic</em></span></p> 1964 1965 <p>The content of this element is an expression that defines 4014 1966 exactly one Topic in a specified Dialect type. The topic should be 4015 1967 supported. The Topic may be defined in two ways: (1) using … … 4017 1969 is defined in a Topic element and assigned to some prefix (e.g. 4018 1970 tns) or (2) using inline form (e.g. 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 1971 {http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics}House/Kitchen/Light.</p> 1972 </li><li class="listitem"> 1973 <p><span class="emphasis"><em>//wsnt:GetCurrentMessage/wsnt:Topic/@Dialect</em></span></p> 1974 1975 <p>URI that specifies TopicExpression Dialect's type. Allowed 4030 1976 dialect's types are as follows: 4031 4032 <span class="emphasis"> 4033 <em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 1977 <span class="emphasis"><em>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple", 4034 1978 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Concrete", 4035 1979 "http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full". 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 1980 </em></span></p> 1981 </li></ul></div> 1982 </div> 1983 1984 <div class="sect3" title="GetCurrentMessageResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp452432"></a>GetCurrentMessageResponse</h4></div></div></div> 1985 1986 1987 <p>In a response to GetCurrentMessageRequest <span class="emphasis"><em>QCG 1988 Notification</em></span> prepares GetCurrentMessageResponse. This 4060 1989 message includes the content of the last Notification 4061 GetCurrentMessageRequest refers to. 4062 </p> 4063 <pre class="programlisting"><SOAP-ENV:Envelope ... >1990 GetCurrentMessageRequest refers to.</p> 1991 1992 <pre class="programlisting"><SOAP-ENV:Envelope ... > 4064 1993 <SOAP-ENV:Header> 4065 1994 <wsa:Action SOAP-ENV:mustUnderstand="1"> 4066 4067 <span class="bold"> 4068 <strong>http://docs.oasis-open.org/wsn/bw-2/ 4069 NotificationProducer/GetCurrentMessageResponse 4070 </strong> 4071 </span> 1995 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 1996 NotificationProducer/GetCurrentMessageResponse</strong></span> 4072 1997 </wsa:Action> 4073 1998 </SOAP-ENV:Header> … … 4076 2001 <smn-ext:CurrentMessage> 4077 2002 <smn-ext:NotifyTime> 4078 4079 <span class="bold"> 4080 <strong>2007-07-23T10:43:14Z 4081 </strong> 4082 </span> 2003 <span class="bold"><strong>2007-07-23T10:43:14Z</strong></span> 4083 2004 </smn-ext:NotifyTime> 4084 2005 <wsnt:ProducerReference> 4085 2006 <wsa:Address> 4086 4087 <span class="bold"> 4088 <strong>http://some.address 4089 4090 </strong> 4091 </span><wsa:Address> 2007 <span class="bold"><strong>http://some.address 2008 </strong></span><wsa:Address> 4092 2009 <wsnt:ProducerReference> 4093 2010 <smn-ext:Message> 4094 4095 <span class="bold"> 4096 <strong> 4097 <span class="bold"> 4098 <strong><smnex:State 2011 <span class="bold"><strong><span class="bold"><strong><smnex:State 4099 2012 xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"> 4100 2013 on 4101 </smnex:State> 4102 </strong> 4103 </span> 4104 </strong> 4105 </span> 2014 </smnex:State></strong></span></strong></span> 4106 2015 </smn-ext:Message> 4107 2016 </smn-ext:CurrentMessage> 4108 2017 </wsnt:GetCurrentMessageResponse> 4109 2018 </SOAP-ENV:Body> 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 2019 </SOAP-ENV:Envelope></pre> 2020 2021 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2022 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2023 2024 <p>For this message should always be: 2025 <span class="emphasis"><em>http://docs.oasis-open.org/wsn/bw-2/ 2026 NotificationProducer/GetCurrentMessageResponse. <span class="emphasis"><em>If 2027 differ, a fault will be returned</em></span></em></span>.</p> 2028 </li><li class="listitem"> 2029 <p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage</em></span></p> 2030 2031 <p><span class="emphasis"><em><span class="emphasis"><em>The element that contains current 4147 2032 Notification and information related to this 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 2033 notification.</em></span></em></span></p> 2034 </li><li class="listitem"> 2035 <p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:NotifyTime</em></span></p> 2036 2037 <p>The time when notification was received by <span class="emphasis"><em>QCG 2038 Notification</em></span>; expressed as universal time (UTC).</p> 2039 </li><li class="listitem"> 2040 <p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/wsnt:ProducerReference/wsa:Address</em></span></p> 2041 2042 <p>A Notification producer (Publisher) address.</p> 2043 </li><li class="listitem"> 2044 <p><span class="emphasis"><em>//wsnt:GetCurrentMessageResponse/smn-ext:GetCurrentMessage/smn-ext:Message</em></span></p> 2045 2046 <p><span class="emphasis"><em><span class="emphasis"><em>An extensive element. The content of 4192 2047 this element is the last Notification message published to the 4193 2048 Topic specified in GetCurrentMessageRequest. Currently supported 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. 2049 are messages shorter than 4096 bytes.</em></span></em></span></p> 2050 </li></ul></div> 2051 </div> 2052 2053 <div class="sect3" title="ListSubscriptions"><div class="titlepage"><div><div><h4 class="title"><a id="idp469520"></a>ListSubscriptions</h4></div></div></div> 2054 2055 2056 <p>The first method from the the group of administrative methods. 4215 2057 It may be invoked to get an information about available subscriptions 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 ... > 2058 in the <span class="emphasis"><em>QCG Notification</em></span> service. The method 2059 consists of various filtering parameters.</p> 2060 2061 <pre class="programlisting"><SOAP-ENV:Envelope ... > 4224 2062 <SOAP-ENV:Header> 4225 2063 <wsa:Action SOAP-ENV:mustUnderstand="1"> 4226 4227 <span class="bold"> 4228 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4229 QCGNotificationManager/ListSubscriptionsRequest 4230 </strong> 4231 </span> 2064 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2065 QCGNotificationManager/ListSubscriptionsRequest</strong></span> 4232 2066 </wsa:Action> 4233 2067 ... … … 4237 2071 <smn-ext:Filter> 4238 2072 <smn-ext:SubscriptionID> 4239 4240 <span class="bold"> 4241 <strong>1568334 4242 </strong> 4243 </span> 2073 <span class="bold"><strong>1568334</strong></span> 4244 2074 </smn-ext:SubscriptionID> 4245 2075 <smn-ext:ConsumerReference> 4246 2076 <wsa:Address> 4247 4248 <span class="bold"> 4249 <strong>http://localhost:2233 4250 </strong> 4251 </span> 2077 <span class="bold"><strong>http://localhost:2233</strong></span> 4252 2078 </wsa:Address> 4253 2079 </smn-ext:ConsumerReference> 4254 2080 <smn-ext:CreationTimeMin> 4255 4256 <span class="bold"> 4257 <strong>2010-07-09T08:21:58Z 4258 </strong> 4259 </span> 2081 <span class="bold"><strong>2010-07-09T08:21:58Z</strong></span> 4260 2082 </smn-ext:CreationTimeMin> 4261 2083 <smn-ext:CreationTimeMax> 4262 4263 <span class="bold"> 4264 <strong>2010-07-09T10:21:58Z 4265 </strong> 4266 </span> 2084 <span class="bold"><strong>2010-07-09T10:21:58Z</strong></span> 4267 2085 </smn-ext:CreationTimeMax> 4268 2086 <smn-ext:TerminationTimeMin> 4269 4270 <span class="bold"> 4271 <strong>2010-07-09T08:21:58Z 4272 </strong> 4273 </span> 2087 <span class="bold"><strong>2010-07-09T08:21:58Z</strong></span> 4274 2088 </smn-ext:TerminationTimeMin> 4275 2089 <smn-ext:TerminationTimeMax> 4276 4277 <span class="bold"> 4278 <strong>2010-07-09T10:21:58Z 4279 </strong> 4280 </span> 2090 <span class="bold"><strong>2010-07-09T10:21:58Z</strong></span> 4281 2091 </smn-ext:TerminationTimeMax> 4282 2092 <wsnt:Filter> 4283 2093 <wsnt:MessageContent 4284 4285 <span class="bold"> 4286 <strong>xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage" 4287 </strong> 4288 </span> 2094 <span class="bold"><strong>xmlns:smnex="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"</strong></span> 4289 2095 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 4290 4291 <span class="bold"> 4292 <strong>boolean(//smnex:State[text()="on"]) 4293 </strong> 4294 </span> 2096 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 4295 2097 </wsnt:MessageContent> 4296 2098 <wsnt:TopicExpression 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> 2099 <span class="bold"><strong>xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span> 2100 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 2101 <span class="bold"><strong>tns://*</strong></span> 4312 2102 </wsnt:TopicExpression> 4313 2103 </wsnt:Filter> … … 4315 2105 </smn-ext:ListSubscriptions> 4316 2106 </SOAP-ENV:Body> 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 2107 </SOAP-ENV:Envelope></pre> 2108 2109 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2110 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2111 2112 <p>For this message should always be: 2113 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsRequest. 2114 <span class="emphasis"><em>If differ, a fault will be 2115 returned</em></span></em></span>.</p> 2116 </li><li class="listitem"> 2117 <p><span class="emphasis"><em>//smn-ext:ListSubscriptions/smn-ext:Filter</em></span></p> 2118 2119 <p>The expanding element from <span class="emphasis"><em>QCG 2120 Notification</em></span> schema. It consists of a number of 2121 optional filtering parameters.</p> 2122 </li><li class="listitem"> 2123 <p><span class="emphasis"><em>//smn-ext:ListSubscriptions/smn-ext:Filter/SubscriptionID</em></span></p> 2124 2125 <p>A Subscription identifier. Thanks to this parameter 4366 2126 Subscriptions may be simply filtered on the basis of Subscription 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 2127 ID. The value is at most 32 char long string.</p> 2128 </li><li class="listitem"> 2129 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:ConsumerReference/wsa:Address</em></span></p> 2130 2131 <p>The parameter that enables filtering Subscriptions based on 2132 addresses of Notification Consumers.</p> 2133 </li><li class="listitem"> 2134 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p> 2135 2136 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p> 2137 2138 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMin 2139 </em></span></p> 2140 2141 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p> 2142 2143 <p><span class="emphasis"><em><span class="emphasis"><em>All these elements define filtering 4412 2144 parameters related to lifetime of a Subscription, respectively: 4413 2145 minimal creation time, maximal creation time, minimal termination 4414 2146 time and maximal termination time. The content of these elements 4415 2147 is a time expressed as a local time with a 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 2148 timezone.</em></span></em></span></p> 2149 </li><li class="listitem"> 2150 <p><span class="emphasis"><em>/smn-ext:ListSubscriptions/smn-ext:Filter/wsnt:Filter</em></span></p> 2151 2152 <p>The same parameter as the parameter specified in the 4431 2153 Subscribe message. In this method it is utilized to filter 4432 2154 Subscriptions on the basis of notification filtering 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 2155 parameters.</p> 2156 </li></ul></div> 2157 </div> 2158 2159 <div class="sect3" title="ListSubscriptionsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp495728"></a>ListSubscriptionsResponse</h4></div></div></div> 2160 2161 2162 <p>The message is sent in the response to ListSubscriptions. It 4450 2163 includes a list of information sets about available and probably 4451 filtered Subscriptions. 4452 </p> 4453 <pre class="programlisting"><SOAP-ENV:Envelope ... >2164 filtered Subscriptions.</p> 2165 2166 <pre class="programlisting"><SOAP-ENV:Envelope ... > 4454 2167 <SOAP-ENV:Header> 4455 2168 <wsa:Action SOAP-ENV:mustUnderstand="1"> 4456 4457 <span class="bold"> 4458 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2169 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4459 2170 QCGNotificationManager/ListSubscriptionsResponse 4460 4461 </strong> 4462 </span></wsa:Action> 2171 </strong></span></wsa:Action> 4463 2172 ... 4464 2173 </SOAP-ENV:Header> … … 4467 2176 <smn-ext:Subscription> 4468 2177 <smn-ext:SubscriptionID> 4469 4470 <span class="bold"> 4471 <strong>16807 4472 4473 </strong> 4474 </span></smn-ext:SubscriptionID> 2178 <span class="bold"><strong>16807 2179 </strong></span></smn-ext:SubscriptionID> 4475 2180 <smn-ext:ConsumerReference> 4476 2181 <wsa:Address> 4477 4478 <span class="bold"> 4479 <strong>http://localhost:2233 4480 </strong> 4481 </span> 2182 <span class="bold"><strong>http://localhost:2233</strong></span> 4482 2183 </wsa:Address> 4483 2184 </smn-ext:ConsumerReference> 4484 2185 <smn-ext:CreationTime> 4485 4486 <span class="bold"> 4487 <strong>2010-07-09T09:21:48Z 4488 4489 </strong> 4490 </span></smn-ext:CreationTime> 2186 <span class="bold"><strong>2010-07-09T09:21:48Z 2187 </strong></span></smn-ext:CreationTime> 4491 2188 <smn-ext:TerminationTime> 4492 4493 <span class="bold"> 4494 <strong>2010-07-09T09:21:48Z 4495 </strong> 4496 </span> 2189 <span class="bold"><strong>2010-07-09T09:21:48Z</strong></span> 4497 2190 </smn-ext:TerminationTime> 4498 2191 <wsnt:Filter> 4499 2192 <wsnt:MessageContent 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> 2193 <span class="bold"><strong>xmlns:smnex="</strong></span><span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousemessage"</strong></span> 4509 2194 Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116"> 4510 4511 <span class="bold"> 4512 <strong>boolean(//smnex:State[text()="on"]) 4513 </strong> 4514 </span> 2195 <span class="bold"><strong>boolean(//smnex:State[text()="on"])</strong></span> 4515 2196 </wsnt:MessageContent> 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> 2197 <wsnt:TopicExpression <span class="bold"><strong> 2198 xmlns:tns="http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics"</strong></span> 2199 Dialect=<span class="bold"><strong>"http://docs.oasis-open.org/wsn/t-1/TopicExpression/Full"</strong></span>> 2200 <span class="bold"><strong>tns://* 2201 </strong></span></wsnt:TopicExpression> 4533 2202 </wsnt:Filter> 4534 2203 </smn-ext:Subscription> … … 4539 2208 </smn-ext:ListSubscriptionsResponse> 4540 2209 </SOAP-ENV:Body> 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 2210 </SOAP-ENV:Envelope></pre> 2211 2212 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2213 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2214 2215 <p>For this message should always be: 2216 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListSubscriptionsResponse. 2217 <span class="emphasis"><em>If differ, a fault will be 2218 returned</em></span></em></span>.</p> 2219 </li><li class="listitem"> 2220 <p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse</em></span></p> 2221 2222 <p>This element contains a list of subscriptions received from 2223 <span class="emphasis"><em>QCG Notification</em></span> (probably also filtered on 4579 2224 the basis of the smn-ext:Filter element sent in 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 2225 ListSubscriptions).</p> 2226 </li><li class="listitem"> 2227 <p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription</em></span></p> 2228 2229 <p><span class="emphasis"><em><span class="emphasis"><em>The element provides information about a 2230 single Subscription.</em></span></em></span></p> 2231 </li><li class="listitem"> 2232 <p><span class="emphasis"><em>//smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/SubscriptionID</em></span></p> 2233 2234 <p>A Subscription identifier. The value is at most 32 char long 2235 string.</p> 2236 </li><li class="listitem"> 2237 <p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:ConsumerReference/wsa:Address</em></span></p> 2238 2239 <p>An address of Notification Consumer declared in a 2240 Subscription.</p> 2241 </li><li class="listitem"> 2242 <p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:CreationTime</em></span></p> 2243 2244 <p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/smn-ext:TerminationTime</em></span></p> 2245 2246 <p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 4642 2247 Subscription. The content of these elements is a time expressed as 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 2248 UTC time.</em></span></em></span></p> 2249 </li><li class="listitem"> 2250 <p><span class="emphasis"><em>/smn-ext:ListSubscriptionsResponse/smn-ext:Subscription/wsnt:Filter</em></span></p> 2251 2252 <p>The same parameter as the parameter specified in the 4658 2253 Subscribe message. It specifies Notification filtering parameters 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 2254 of a Subscription.</p> 2255 </li></ul></div> 2256 </div> 2257 2258 <div class="sect3" title="ListPublishersRegistrations"><div class="titlepage"><div><div><h4 class="title"><a id="idp520736"></a>ListPublishersRegistrations</h4></div></div></div> 2259 2260 2261 <p>The next method from the group of administrative methods. It may 4676 2262 be utilized to list Publishers Registrations. The method consists of 4677 several filtering parameters. 4678 </p> 4679 <pre class="programlisting"><SOAP-ENV:Envelope ... >2263 several filtering parameters.</p> 2264 2265 <pre class="programlisting"><SOAP-ENV:Envelope ... > 4680 2266 <SOAP-ENV:Header> 4681 2267 <wsa:Action SOAP-ENV:mustUnderstand="1"> 4682 4683 <span class="bold"> 4684 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4685 QCGNotificationManager/ListPublishersRegistrationsRequest 4686 </strong> 4687 </span> 2268 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2269 QCGNotificationManager/ListPublishersRegistrationsRequest</strong></span> 4688 2270 </wsa:Action> 4689 2271 ... … … 4693 2275 <smn-ext:Filter> 4694 2276 <smn-ext:PublisherRegistrationID> 4695 4696 <span class="bold"> 4697 <strong>984943658 4698 </strong> 4699 </span> 2277 <span class="bold"><strong>984943658</strong></span> 4700 2278 </smn-ext:PublisherRegistrationID> 4701 2279 <smn-ext:PublisherReference> 4702 2280 <wsa:Address> 4703 4704 <span class="bold"> 4705 <strong>127.0.0.1 4706 </strong> 4707 </span> 2281 <span class="bold"><strong>127.0.0.1</strong></span> 4708 2282 </wsa5:Address> 4709 2283 </smn-ext:PublisherReference> 4710 2284 <smn-ext:CreationTimeMin> 4711 4712 <span class="bold"> 4713 <strong>2010-07-08T09:37:04Z 4714 </strong> 4715 </span> 2285 <span class="bold"><strong>2010-07-08T09:37:04Z</strong></span> 4716 2286 </smn-ext:CreationTimeMin> 4717 2287 <smn-ext:CreationTimeMax> 4718 4719 <span class="bold"> 4720 <strong>2010-07-08T11:37:04Z 4721 </strong> 4722 </span> 2288 <span class="bold"><strong>2010-07-08T11:37:04Z</strong></span> 4723 2289 </smn-ext:CreationTimeMax> 4724 2290 <smn-ext:TerminationTimeMin> 4725 4726 <span class="bold"> 4727 <strong>2010-07-08T09:37:04Z 4728 </strong> 4729 </span> 2291 <span class="bold"><strong>2010-07-08T09:37:04Z</strong></span> 4730 2292 </smn-ext:TerminationTimeMin> 4731 2293 <smn-ext:TerminationTimeMax> 4732 4733 <span class="bold"> 4734 <strong>2010-07-08T11:37:04Z 4735 </strong> 4736 </span> 2294 <span class="bold"><strong>2010-07-08T11:37:04Z</strong></span> 4737 2295 </smn-ext:TerminationTimeMax> 4738 2296 </smn-ext:Filter> 4739 2297 </smn-ext:ListPublishersRegistrations> 4740 2298 </SOAP-ENV:Body> 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 2299 </SOAP-ENV:Envelope></pre> 2300 2301 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2302 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2303 2304 <p>For this message should always be: 2305 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsRequest. 2306 <span class="emphasis"><em>If differ, a fault will be 2307 returned</em></span></em></span>.</p> 2308 </li><li class="listitem"> 2309 <p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter</em></span></p> 2310 2311 <p>The element from <span class="emphasis"><em>QCG Notification</em></span> 2312 schema. It consists of optional filtering parameters.</p> 2313 </li><li class="listitem"> 2314 <p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrations/smn-ext:Filter/PublisherRegistrationID</em></span></p> 2315 2316 <p>A Publisher Registration identifier. This parameter enables 4789 2317 filtering of Publisher Registrations based on Publishers 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 2318 Registrations ID. The value is at most 32 char long string.</p> 2319 </li><li class="listitem"> 2320 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:PublisherReference/wsa:Address</em></span></p> 2321 2322 <p>This element enables filtering based on an addresses of 4801 2323 Publishers. Depending on configuration, this address may be held 4802 in the 4803 <span class="emphasis"> 4804 <em>QCG Notification 4805 </em> 4806 </span> service as an address 2324 in the <span class="emphasis"><em>QCG Notification</em></span> service as an address 4807 2325 sent in the From element of WSA Header of RegisterPublisher 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 2326 message or an IP address of a Publisher.</p> 2327 </li><li class="listitem"> 2328 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p> 2329 2330 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p> 2331 2332 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMin 2333 </em></span></p> 2334 2335 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrations/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p> 2336 2337 <p><span class="emphasis"><em><span class="emphasis"><em>The elements define filtering parameters 4842 2338 related to lifetime of a Publisher Registration, respectively: 4843 2339 minimal creation time, maximal creation time, minimal termination 4844 2340 time and maximal termination time. The content of these elements 4845 2341 is a time expressed as a local time with a 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 ... > 2342 timezone.</em></span></em></span></p> 2343 </li></ul></div> 2344 </div> 2345 2346 <div class="sect3" title="ListPublisherRegistrationsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp542336"></a>ListPublisherRegistrationsResponse</h4></div></div></div> 2347 2348 2349 <p>The response message to ListPublishersRegistrations. It includes 2350 a list of information sets about Publishers Registrations.</p> 2351 2352 <pre class="programlisting"><SOAP-ENV:Envelope ... > 4870 2353 <SOAP-ENV:Header> 4871 2354 <wsa:Action SOAP-ENV:mustUnderstand="1"> 4872 4873 <span class="bold"> 4874 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2355 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 4875 2356 QCGNotificationManager/ListPublishersRegistrationsResponse 4876 4877 </strong> 4878 </span></wsa:Action> 2357 </strong></span></wsa:Action> 4879 2358 ... 4880 2359 </SOAP-ENV:Header> … … 4883 2362 <smn-ext:PublisherRegistration> 4884 2363 <smn-ext:PublisherRegistrationID> 4885 4886 <span class="bold"> 4887 <strong>16807 4888 4889 </strong> 4890 </span></smn-ext:PublisherRegistrationID> 2364 <span class="bold"><strong>16807 2365 </strong></span></smn-ext:PublisherRegistrationID> 4891 2366 <smn-ext:PublisherReference> 4892 2367 <wsa:Address> 4893 4894 <span class="bold"> 4895 <strong>http://localhost:2233 4896 </strong> 4897 </span> 2368 <span class="bold"><strong>http://localhost:2233</strong></span> 4898 2369 </wsa:Address> 4899 2370 </smn-ext:PublisherReference> 4900 2371 <smn-ext:CreationTime> 4901 4902 <span class="bold"> 4903 <strong>2010-07-09T09:21:48Z 4904 4905 </strong> 4906 </span></smn-ext:CreationTime> 2372 <span class="bold"><strong>2010-07-09T09:21:48Z 2373 </strong></span></smn-ext:CreationTime> 4907 2374 <smn-ext:TerminationTime> 4908 4909 <span class="bold"> 4910 <strong>2010-07-09T09:21:48Z 4911 </strong> 4912 </span> 2375 <span class="bold"><strong>2010-07-09T09:21:48Z</strong></span> 4913 2376 </smn-ext:TerminationTime> 4914 2377 </smn-ext:PublisherRegistration> … … 4919 2382 </smn-ext:ListPublishersRegistrationsResponse> 4920 2383 </SOAP-ENV:Body> 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 2384 </SOAP-ENV:Envelope></pre> 2385 2386 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2387 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2388 2389 <p>For this message should always be: 2390 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPublishersRegistrationsResponse. 2391 <span class="emphasis"><em>If differ, a fault will be 2392 returned</em></span></em></span>.</p> 2393 </li><li class="listitem"> 2394 <p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse</em></span></p> 2395 2396 <p>The element contains a list of Publishers Registrations 2397 received from <span class="emphasis"><em>QCG Notification</em></span> (probably also 4959 2398 filtered on the basis of the smn-ext:Filter element sent 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 2399 ListPublishersRegistrations message).</p> 2400 </li><li class="listitem"> 2401 <p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration</em></span></p> 2402 2403 <p><span class="emphasis"><em><span class="emphasis"><em>The element provides information about a 2404 single Publisher Registration.</em></span></em></span></p> 2405 </li><li class="listitem"> 2406 <p><span class="emphasis"><em>//smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/PublisherRegistrationID</em></span></p> 2407 2408 <p>A Publisher Registration identifier. The value is at most 32 2409 char long string.</p> 2410 </li><li class="listitem"> 2411 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:PublisherReference/wsa:Address</em></span></p> 2412 2413 <p>An address of Publisher. It may be an address defined in a 5001 2414 From element of WSA Header of a RegisterPublisher message or an IP 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 2415 address of a publisher.</p> 2416 </li><li class="listitem"> 2417 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:CreationTime</em></span></p> 2418 2419 <p><span class="emphasis"><em>/smn-ext:ListPublishersRegistrationsResponse/smn-ext:PublisherRegistration/smn-ext:TerminationTime</em></span></p> 2420 2421 <p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 5023 2422 Publisher Registration. The content of these elements is a time 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 2423 expressed as UTC time.</em></span></em></span></p> 2424 </li></ul></div> 2425 </div> 2426 2427 <div class="sect3" title="ListPullPoints"><div class="titlepage"><div><div><h4 class="title"><a id="idp561984"></a>ListPullPoints</h4></div></div></div> 2428 2429 2430 <p>The next administrative method. It enables listing of available 5045 2431 PullPoints. The method consists of several optional filtering 5046 parameters. 5047 </p> 5048 <pre class="programlisting"><SOAP-ENV:Envelope ... >2432 parameters.</p> 2433 2434 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5049 2435 <SOAP-ENV:Header> 5050 2436 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5051 5052 <span class="bold"> 5053 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5054 QCGNotificationManager/ListPullPointsRequest 5055 </strong> 5056 </span> 2437 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2438 QCGNotificationManager/ListPullPointsRequest</strong></span> 5057 2439 </wsa:Action> 5058 2440 ... … … 5062 2444 <smn-ext:Filter> 5063 2445 <smn-ext:PullPointID> 5064 5065 <span class="bold"> 5066 <strong>9342232 5067 </strong> 5068 </span> 2446 <span class="bold"><strong>9342232</strong></span> 5069 2447 </smn-ext:PullPointID> 5070 2448 <smn-ext:PullPointReference> 5071 2449 <wsa:Address> 5072 5073 <span class="bold"> 5074 <strong>http://localhost:2211?ppID=9342232 5075 </strong> 5076 </span> 2450 <span class="bold"><strong>http://localhost:2211?ppID=9342232</strong></span> 5077 2451 </wsa5:Address> 5078 2452 </smn-ext:PullPointReference> 5079 2453 <smn-ext:CreationTimeMin> 5080 5081 <span class="bold"> 5082 <strong>2010-07-08T09:38:03Z 5083 </strong> 5084 </span> 2454 <span class="bold"><strong>2010-07-08T09:38:03Z</strong></span> 5085 2455 </smn-ext:CreationTimeMin> 5086 2456 <smn-ext:CreationTimeMax> 5087 5088 <span class="bold"> 5089 <strong>2010-07-08T11:38:03Z 5090 </strong> 5091 </span> 2457 <span class="bold"><strong>2010-07-08T11:38:03Z</strong></span> 5092 2458 </smn-ext:CreationTimeMax> 5093 2459 <smn-ext:TerminationTimeMin> 5094 5095 <span class="bold"> 5096 <strong>2010-07-08T09:38:03Z 5097 </strong> 5098 </span> 2460 <span class="bold"><strong>2010-07-08T09:38:03Z</strong></span> 5099 2461 </smn-ext:TerminationTimeMin> 5100 2462 <smn-ext:TerminationTimeMax> 5101 5102 <span class="bold"> 5103 <strong>2010-07-08T11:38:03Z 5104 </strong> 5105 </span> 2463 <span class="bold"><strong>2010-07-08T11:38:03Z</strong></span> 5106 2464 </smn-ext:TerminationTimeMax> 5107 2465 </smn-ext:Filter> 5108 2466 </smn-ext:ListPullPoints> 5109 2467 </SOAP-ENV:Body> 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 2468 </SOAP-ENV:Envelope></pre> 2469 2470 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2471 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2472 2473 <p>For this message should always be: 2474 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsRequest. 2475 <span class="emphasis"><em>If differ, a fault will be 2476 returned</em></span></em></span>.</p> 2477 </li><li class="listitem"> 2478 <p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter</em></span></p> 2479 2480 <p>The element from <span class="emphasis"><em>QCG Notification</em></span> 2481 schema. It consists of optional filtering parameters.</p> 2482 </li><li class="listitem"> 2483 <p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointID</em></span></p> 2484 2485 <p>A PullPoint identifier. This parameter enables filtering of 5158 2486 PullPoints based on PullPoint ID. The value is at most 32 char 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 2487 long string.</p> 2488 </li><li class="listitem"> 2489 <p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:PullPointReference/wsa:Address</em></span></p> 2490 2491 <p>This element enables filtering based on an addresses of 5170 2492 PullPoint. The PullPoint address is assigned after creation of a 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 2493 PullPoint in <span class="emphasis"><em>QCG Notification</em></span> and returned 2494 inside CreatePullPointResponse.</p> 2495 </li><li class="listitem"> 2496 <p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMin</em></span></p> 2497 2498 <p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:CreationTimeMax</em></span></p> 2499 2500 <p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMin 2501 </em></span></p> 2502 2503 <p><span class="emphasis"><em>/smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:TerminationTimeMax</em></span></p> 2504 2505 <p><span class="emphasis"><em><span class="emphasis"><em>The elements define filtering parameters 5210 2506 related to PullPoint lifetime, respectively: minimal creation 5211 2507 time, maximal creation time, minimal termination time and maximal 5212 2508 termination time. The content of these elements is a time 5213 2509 expressed as a local time with a 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 ... > 2510 timezone.</em></span></em></span></p> 2511 </li></ul></div> 2512 </div> 2513 2514 <div class="sect3" title="ListPullPointsResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp582752"></a>ListPullPointsResponse</h4></div></div></div> 2515 2516 2517 <p>The response message to ListPullPoints. It includes a list of 2518 information sets about filtered Pullpoints.</p> 2519 2520 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5238 2521 <SOAP-ENV:Header> 5239 2522 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5240 5241 <span class="bold"> 5242 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2523 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5243 2524 QCGNotificationManager/ListPullPointsResponse 5244 5245 </strong> 5246 </span></wsa:Action> 2525 </strong></span></wsa:Action> 5247 2526 ... 5248 2527 </SOAP-ENV:Header> … … 5251 2530 <smn-ext:PullPoint> 5252 2531 <smn-ext:PullPointID> 5253 5254 <span class="bold"> 5255 <strong>9342232 5256 5257 </strong> 5258 </span></smn-ext:PullPointID> 2532 <span class="bold"><strong>9342232 2533 </strong></span></smn-ext:PullPointID> 5259 2534 <smn-ext:PullPointReference> 5260 2535 <wsa:Address> 5261 5262 <span class="bold"> 5263 <strong>http://localhost:2211?ppID=9342232 5264 </strong> 5265 </span> 2536 <span class="bold"><strong>http://localhost:2211?ppID=9342232</strong></span> 5266 2537 </wsa:Address> 5267 2538 </smn-ext:PullPointReference> 5268 2539 <smn-ext:CreationTime> 5269 5270 <span class="bold"> 5271 <strong>2010-07-09T09:31:28Z 5272 5273 </strong> 5274 </span></smn-ext:CreationTime> 2540 <span class="bold"><strong>2010-07-09T09:31:28Z 2541 </strong></span></smn-ext:CreationTime> 5275 2542 <smn-ext:TerminationTime> 5276 5277 <span class="bold"> 5278 <strong>2010-07-09T09:31:28Z 5279 </strong> 5280 </span> 2543 <span class="bold"><strong>2010-07-09T09:31:28Z</strong></span> 5281 2544 </smn-ext:TerminationTime> 5282 2545 </smn-ext:PullPoint> … … 5287 2550 </smn-ext:ListPullPointsResponse> 5288 2551 </SOAP-ENV:Body> 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 2552 </SOAP-ENV:Envelope></pre> 2553 2554 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2555 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2556 2557 <p>For this message should always be: 2558 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListPullPointsResponse. 2559 <span class="emphasis"><em>If differ, a fault will be 2560 returned</em></span></em></span>.</p> 2561 </li><li class="listitem"> 2562 <p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse</em></span></p> 2563 2564 <p>The element contains a list of PullPoints received from 2565 <span class="emphasis"><em>QCG Notification</em></span> (probably also previously 5327 2566 filtered on the basis of the smn-ext:Filter element sent in a 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 2567 ListPullPoints message).</p> 2568 </li><li class="listitem"> 2569 <p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint</em></span></p> 2570 2571 <p><span class="emphasis"><em><span class="emphasis"><em>The element provides particular 2572 information about a single PullPoint.</em></span></em></span></p> 2573 </li><li class="listitem"> 2574 <p><span class="emphasis"><em>//smn-ext:ListPullPointsResponse/smn-ext:PullPoint/PullPointID</em></span></p> 2575 2576 <p>A PullPoint identifier. The value is at most 32 char long 2577 string.</p> 2578 </li><li class="listitem"> 2579 <p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:PullPointReference/wsa:Address</em></span></p> 2580 2581 <p>An address of PullPoint. For particular PullPoint it is the 5369 2582 same address as the address from a corresponding 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 2583 CreatePullPointResponse message.</p> 2584 </li><li class="listitem"> 2585 <p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:CreationTime</em></span></p> 2586 2587 <p><span class="emphasis"><em>/smn-ext:ListPullPointsResponse/smn-ext:PullPoint/smn-ext:TerminationTime</em></span></p> 2588 2589 <p><span class="emphasis"><em><span class="emphasis"><em>Creation time and termination time of a 5391 2590 PullPoint. The content of these elements is a time expressed as 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 ... > 2591 UTC time.</em></span></em></span></p> 2592 </li></ul></div> 2593 </div> 2594 2595 <div class="sect3" title="ListTopicNamespaces"><div class="titlepage"><div><div><h4 class="title"><a id="idp601968"></a>ListTopicNamespaces</h4></div></div></div> 2596 2597 2598 <p>An administrative method. It is designed to listing available 2599 Topic Namespaces and Topics assigned to this namespaces.</p> 2600 2601 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5416 2602 <SOAP-ENV:Header> 5417 2603 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5418 5419 <span class="bold"> 5420 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5421 QCGNotificationManager/ListTopicNamespacesRequest 5422 </strong> 5423 </span> 2604 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2605 QCGNotificationManager/ListTopicNamespacesRequest</strong></span> 5424 2606 </wsa:Action> 5425 2607 ... … … 5429 2611 <smn-ext:Filter> 5430 2612 <smn-ext:targetNamespace> 5431 5432 <span class="bold"> 5433 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics 5434 </strong> 5435 </span> 2613 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span> 5436 2614 </smn-ext:targetNamespace> 5437 2615 </smn-ext:Filter> 5438 2616 </smn-ext:ListTopicNamespaces> 5439 2617 </SOAP-ENV:Body> 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 2618 </SOAP-ENV:Envelope></pre> 2619 2620 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2621 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2622 2623 <p>For this message should always be: 2624 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesRequest. 2625 <span class="emphasis"><em>If differ, a fault will be 2626 returned</em></span></em></span>.</p> 2627 </li><li class="listitem"> 2628 <p><span class="emphasis"><em>//smn-ext:ListTopicNamespaces/smn-ext:Filter</em></span></p> 2629 2630 <p>The element from <span class="emphasis"><em>QCG Notification</em></span> 2631 schema. It consists of optional filtering parameters.</p> 2632 </li><li class="listitem"> 2633 <p><span class="emphasis"><em>//smn-ext:ListPullPoints/smn-ext:Filter/smn-ext:targetNamespace</em></span></p> 2634 2635 <p>A targetNamespace of a TopicNamespace. This parameter 5488 2636 enables filtering of TopicNamespaces based on their 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 2637 targetNamespace names.</p> 2638 </li></ul></div> 2639 </div> 2640 2641 <div class="sect3" title="ListTopicNamespacesResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp612816"></a>ListTopicNamespacesResponse</h4></div></div></div> 2642 2643 2644 <p>The response message to ListTopicNamespaces. The message 5506 2645 consists of information sets for each filtered TopicNamespace. A 5507 single set includes targetNamespaces and a list of topics. 5508 </p> 5509 <pre class="programlisting"><SOAP-ENV:Envelope ... >2646 single set includes targetNamespaces and a list of topics.</p> 2647 2648 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5510 2649 <SOAP-ENV:Header> 5511 2650 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5512 5513 <span class="bold"> 5514 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2651 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5515 2652 QCGNotificationManager/ListPullPointsResponse 5516 5517 </strong> 5518 </span></wsa:Action> 2653 </strong></span></wsa:Action> 5519 2654 ... 5520 2655 </SOAP-ENV:Header> … … 5523 2658 <smn-ext:TopicNamespace> 5524 2659 <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> 2660 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics</strong></span><span class="bold"><strong> 2661 </strong></span></smn-ext:targetNamespace> 5535 2662 <smn-ext:Topic> 5536 5537 <span class="bold"> 5538 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics/House 5539 </strong> 5540 </span> 2663 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics/House</strong></span> 5541 2664 </smn-ext:Topic> 5542 2665 <smn-ext:Topic> … … 5551 2674 </smn-ext:ListTopicNamespacesResponse> 5552 2675 </SOAP-ENV:Body> 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 2676 </SOAP-ENV:Envelope></pre> 2677 2678 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2679 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2680 2681 <p>For this message should always be: 2682 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/ListTopicNamespacesResponse. 2683 <span class="emphasis"><em>If differ, a fault will be 2684 returned</em></span></em></span>.</p> 2685 </li><li class="listitem"> 2686 <p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse</em></span></p> 2687 2688 <p>The element contains a list of information about 2689 TopicNamespaces received from <span class="emphasis"><em>QCG 2690 Notification</em></span> (optionally filtered on the basis of the 5592 2691 smn-ext:Filter element sent in a ListTopicNamespaces 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 2692 message).</p> 2693 </li><li class="listitem"> 2694 <p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace</em></span></p> 2695 2696 <p><span class="emphasis"><em><span class="emphasis"><em>The element provides particular 5608 2697 information about a single 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 ... > 2698 TopicNamespace.</em></span></em></span></p> 2699 </li><li class="listitem"> 2700 <p><span class="emphasis"><em>//smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:targetNamespace</em></span></p> 2701 2702 <p>A targetNamespace identifying single TopicNamespace. The 2703 value should be compliant with anyURI.</p> 2704 </li><li class="listitem"> 2705 <p><span class="emphasis"><em>/smn-ext:ListTopicNamespacesResponse/smn-ext:TopicNamespace/smn-ext:Topic</em></span></p> 2706 2707 <p>A list of topics belonging to a TopicNamespace. Each listed 2708 topic is proceeded by a targetNamespace so it is Unix.</p> 2709 </li></ul></div> 2710 </div> 2711 2712 <div class="sect3" title="AddTopicNamespace"><div class="titlepage"><div><div><h4 class="title"><a id="idp628080"></a>AddTopicNamespace</h4></div></div></div> 2713 2714 2715 <p>An administrative method. The method may be invoked to add a new 2716 TopicNamespace to the <span class="emphasis"><em>QCG Notification</em></span>.</p> 2717 2718 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5659 2719 <SOAP-ENV:Header> 5660 2720 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5661 5662 <span class="bold"> 5663 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5664 QCGNotificationManager/AddTopicNamespaceRequest 5665 </strong> 5666 </span> 2721 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2722 QCGNotificationManager/AddTopicNamespaceRequest</strong></span> 5667 2723 </wsa:Action> 5668 2724 ... … … 5671 2727 <smn-ext:AddTopicNamespace> 5672 2728 <wstop:TopicNamespace 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>"> 2729 targetNamespace="<span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2</strong></span>"> 2730 <wstop:Topic final="false" name="<span class="bold"><strong>House</strong></span>"> 5683 2731 <wstop:Topic ...> 5684 2732 ... … … 5690 2738 </smn-ext:AddTopicNamespace> 5691 2739 </SOAP-ENV:Body> 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 2740 </SOAP-ENV:Envelope></pre> 2741 2742 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2743 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2744 2745 <p>For this message should always be: 2746 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceRequest. 2747 <span class="emphasis"><em>If differ, a fault will be 2748 returned</em></span></em></span>.</p> 2749 </li><li class="listitem"> 2750 <p><span class="emphasis"><em>//smn-ext:AddTopicNamespaces/wstop:TopicNamespace</em></span></p> 2751 2752 <p>The element defining a single Topic Namespace. It cames from 2753 WS-Topics schema.</p> 2754 </li></ul></div> 2755 </div> 2756 2757 <div class="sect3" title="AddTopicNamespaceResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp637824"></a>AddTopicNamespaceResponse</h4></div></div></div> 2758 2759 2760 <p>A response message to a AddTopicNamespaceRequest. It is empty 5742 2761 and only confirms successful addition of a TopicNamespace to the 5743 5744 <span class="emphasis"> 5745 <em>QCG Notification 5746 </em> 5747 </span> service. 5748 </p> 5749 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2762 <span class="emphasis"><em>QCG Notification</em></span> service. </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5750 2763 <SOAP-ENV:Header> 5751 2764 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5752 5753 <span class="bold"> 5754 <strong>http://docs.oasis-open.org/wsn/bw-2/ 5755 PullPoint/AddTopicNamespaceResponse 5756 </strong> 5757 </span> 2765 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 2766 PullPoint/AddTopicNamespaceResponse</strong></span> 5758 2767 </wsa:Action> 5759 2768 ... … … 5763 2772 </smn-ext:AddTopicNamespaceResponse> 5764 2773 </SOAP-ENV:Body> 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. 2774 </SOAP-ENV:Envelope></pre> 2775 2776 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2777 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2778 2779 <p>For this message should always be: 2780 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/AddTopicNamespaceResponse.</em></span><span class="emphasis"><em><span class="emphasis"><em> 2781 If differ, a fault will be returned.</em></span></em></span></p> 2782 </li></ul></div> 2783 </div> 2784 2785 <div class="sect3" title="RemoveTopicNamespace"><div class="titlepage"><div><div><h4 class="title"><a id="idp643072"></a>RemoveTopicNamespace</h4></div></div></div> 2786 2787 2788 <p>The next administrative method. It is used to remove a 2789 TopicNamespace from the <span class="emphasis"><em>QCG Notification</em></span> system. 5812 2790 Note that the removing may be only temporary (active to the restart of 5813 2791 the system) if the TopicNamespace file is protected by disabling write 5814 permission. 5815 </p> 5816 <pre class="programlisting"><SOAP-ENV:Envelope ... >2792 permission.</p> 2793 2794 <pre class="programlisting"><SOAP-ENV:Envelope ... > 5817 2795 <SOAP-ENV:Header> 5818 2796 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5819 5820 <span class="bold"> 5821 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 5822 QCGNotificationManager/RemoveTopicNamespaceRequest 5823 </strong> 5824 </span> 2797 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/ 2798 QCGNotificationManager/RemoveTopicNamespaceRequest</strong></span> 5825 2799 </wsa:Action> 5826 2800 ... … … 5829 2803 <smn-ext:RemoveTopicNamespace> 5830 2804 <smn-ext:targetNamespace> 5831 5832 <span class="bold"> 5833 <strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2/House 5834 </strong> 5835 </span> 2805 <span class="bold"><strong>http://schemas.qoscosgrid.org/ntf/2011/04/sample/myhousetopics2/House</strong></span> 5836 2806 </smn-ext:targetNamespace> 5837 2807 </smn-ext:RemoveTopicNamespace> 5838 2808 </SOAP-ENV:Body> 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 2809 </SOAP-ENV:Envelope></pre> 2810 2811 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2812 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2813 2814 <p>For this message should always be: 2815 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceRequest. 2816 <span class="emphasis"><em>If differ, a fault will be 2817 returned</em></span></em></span>.</p> 2818 </li><li class="listitem"> 2819 <p><span class="emphasis"><em>//smn-ext:RemoveTopicNamespaces/smn-ext:targetNamespace</em></span></p> 2820 2821 <p>The targetNamespace name of a TopicNamespace dedicated to 2822 remove - anyURI.</p> 2823 </li></ul></div> 2824 </div> 2825 2826 <div class="sect3" title="RemoveTopicNamespaceResponse"><div class="titlepage"><div><div><h4 class="title"><a id="idp653056"></a>RemoveTopicNamespaceResponse</h4></div></div></div> 2827 2828 2829 <p>A response message to a RemoveTopicNamespaceRequest. It is empty 5889 2830 and confirms the successful deletion of a TopicNamespace. 5890 5891 </p> 5892 <pre class="programlisting"><SOAP-ENV:Envelope ... > 2831 </p><pre class="programlisting"><SOAP-ENV:Envelope ... > 5893 2832 <SOAP-ENV:Header> 5894 2833 <wsa:Action SOAP-ENV:mustUnderstand="1"> 5895 5896 <span class="bold"> 5897 <strong>http://docs.oasis-open.org/wsn/bw-2/ 5898 PullPoint/RemoveTopicNamespaceResponse 5899 </strong> 5900 </span> 2834 <span class="bold"><strong>http://docs.oasis-open.org/wsn/bw-2/ 2835 PullPoint/RemoveTopicNamespaceResponse</strong></span> 5901 2836 </wsa:Action> 5902 2837 ... … … 5906 2841 </smn-ext:RemoveTopicNamespaceResponse> 5907 2842 </SOAP-ENV:Body> 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 2843 </SOAP-ENV:Envelope></pre> 2844 2845 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2846 <p><span class="emphasis"><em>//SOAP-ENV:Header/wsa:Action</em></span></p> 2847 2848 <p>For this message should always be: 2849 <span class="emphasis"><em>http://schemas.qoscosgrid.org/ntf/2011/04/QCGNotificationManager/RemoveTopicNamespaceResponse.</em></span><span class="emphasis"><em><span class="emphasis"><em> 2850 If differ, a fault will be returned.</em></span></em></span></p> 2851 </li></ul></div> 2852 </div> 2853 </div> 2854 </div> 2855 2856 <div class="sect1" title="Administration Guide of QCG Notification"><div class="titlepage"><div><div><h2 class="title"><a id="idp656832"></a>Administration Guide of <span class="emphasis"><em>QCG 2857 Notification</em></span></h2></div></div></div> 2858 2859 2860 <div class="sect2" title="Prerequisites"><div class="titlepage"><div><div><h3 class="title"><a id="idp659488"></a>Prerequisites</h3></div></div></div> 2861 2862 2863 <p>In order to build and install <span class="emphasis"><em>QCG 2864 Notification</em></span>, an administrator has to appropriately configure 5972 2865 operating system. There is some dependencies to external software that 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 2866 should be satisfied.</p> 2867 2868 <div class="sect3" title="QCG Core library"><div class="titlepage"><div><div><h4 class="title"><a id="idp661264"></a>QCG Core library</h4></div></div></div> 2869 2870 2871 <p><span class="emphasis"><em>QCG Notification</em></span> is based on the 2872 <span class="emphasis"><em>QCG Core</em></span> library developed by the 2873 <span class="emphasis"><em>QCG</em></span> team. QCG Core is a common utility library 6000 2874 providing set of basic modules used by other components within QCG 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 2875 Project. For more information see QCG Core documentation.</p> 2876 2877 <p>The QCG Core library should be properly configured in prior to 2878 preparation of <span class="emphasis"><em>QCG Notification</em></span>.</p> 2879 </div> 2880 </div> 2881 2882 <div class="sect2" title="Building"><div class="titlepage"><div><div><h3 class="title"><a id="idp665136"></a>Building</h3></div></div></div> 2883 2884 2885 <p>Before you compile <span class="emphasis"><em>QCG Notification</em></span>, you need 6027 2886 to run the configuration script first. It will try to check if all the 6028 2887 requirements are met and whether needed third party software is 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 you2888 available. Simply type the following command:</p> 2889 2890 <pre class="programlisting">$ ./configure</pre> 2891 2892 <p>There are several options that can be passed to the script. If you 6034 2893 type the --help parameter you will see all available options. These are 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 2894 the most important ones:</p> 2895 2896 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 2897 <p>--prefix=DIR</p> 2898 2899 <p>specifies directory where <span class="emphasis"><em>QCG 2900 Notification</em></span> will be installed.</p> 2901 2902 <p>Default: /opt/qcg</p> 2903 </li><li class="listitem"> 2904 <p>--with-qcg-core=PFX</p> 2905 2906 <p>specifies where QCG Core library is installed.</p> 2907 2908 <p>Default: no default value. qcg-core-config script is used to 2909 determine necessary paths</p> 2910 </li><li class="listitem"> 2911 <p>--with-client</p> 2912 2913 <p>Determine if the test client program should be build</p> 2914 </li><li class="listitem"> 2915 <p>--with-consumer</p> 2916 2917 <p>Determine if the test NotificationConsumer service should be 2918 build</p> 2919 </li><li class="listitem"> 2920 <p>--with-addressing-handler</p> 2921 2922 <p>Determine if the test Web Services Addressing handler 2923 service should be build</p> 2924 </li></ul></div><p>After successful configuration step, compiling and 2925 installing of <span class="emphasis"><em>QCG Notification</em></span> should be a 2926 straightforward process:</p> 2927 2928 <pre class="programlisting">$ make 2929 $ make install</pre> 2930 2931 <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> 2932 <p>The installation step should be done either as 2933 <code class="filename">root</code> or the user that will execute <span class="emphasis"><em>QCG 2934 Notification</em></span> service, assuming he has necessary privileges 2935 to do this.</p> 2936 </div> 2937 </div> 2938 2939 <div class="sect2" title="Creating database for QCG Notification - the PostgreSQL example"><div class="titlepage"><div><div><h3 class="title"><a id="idp680896"></a>Creating database for <span class="emphasis"><em>QCG Notification</em></span> - the 2940 PostgreSQL example</h3></div></div></div> 2941 2942 2943 <p><span class="emphasis"><em>QCG Notification</em></span> can be run in two basic 6130 2944 modes related to the database connection: without database or with 6131 2945 database. Although the first option is sufficient for simple scenarios, 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 2946 it reduces the overall functionality of the <span class="emphasis"><em>QCG 2947 Notification</em></span> (e.g. disable PullPoints). Therefore using the 2948 database is recomended and can be often essential.</p> 2949 2950 <p>You will find more detailed description of administrative tasks in 6141 2951 PostgreSQL tutorial. However, the following basic steps are needed to 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 2952 set up a database and appropriate tables for <span class="emphasis"><em>QCG 2953 Notification</em></span> assuming that you have already setup a 2954 PostgreSQL database:</p> 2955 2956 <p>By default, the first database user created will also be named 2957 <code class="filename">postgres</code>. In order to create a user for 2958 <span class="emphasis"><em>QCG Notification</em></span> usage, for instance 2959 <code class="filename">qcg-ntf</code>, type the following:</p> 2960 2961 <pre class="programlisting">$ createuser -U postgres -W qcg-ntf -P</pre> 2962 2963 <p>If you use a password then remember to supply it in 2964 <code class="filename">qcg-ntfd.xml</code> configuration file. Create a database, 2965 for example <code class="filename">qcg-ntf</code>, by typing the following 2966 command:</p> 2967 2968 <pre class="programlisting">$ createdb qcg-ntf</pre> 2969 2970 <p>and set up a table structure using the 2971 <code class="filename">qcg-ntf-psql.sql</code> file from <span class="emphasis"><em>QCG 2972 Notification</em></span> distribution - it can be found in 2973 <code class="filename">/opt/qcg/share/tools</code> directory by default.</p> 2974 2975 <pre class="programlisting">$ psql -d qcg-ntf -U qcg-ntf < qcg-ntf-psql.sql</pre> 2976 2977 <p>Eventually you need to add this database as the ODBC Data Source 6192 2978 Name. You can do this by editing system-wide configuration file (e.g. 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] 2979 <code class="filename">/etc/odbc.ini)</code> or <code class="filename">.odbc.ini</code> in 2980 home directory of the user that will be used to start <span class="emphasis"><em>QCG 2981 Notification</em></span>.</p> 2982 2983 <p>Assuming that ODBC are installed in /usr/local/lib and the choosed 2984 name for <span class="emphasis"><em>QCG Notification</em></span> is 2985 <code class="filename">qcg-ntf</code> the configuration file should looks 2986 simmilar to the following:</p> 2987 2988 <pre class="programlisting">[qcg-ntf] 6217 2989 Description = QCG Notification database 6218 2990 Driver = /usr/local/lib/libodbcpsql.so … … 6225 2997 TraceFile = odbc.trace 6226 2998 Debug = 0 6227 DebugFile = odbc.debug 6228 </pre> 6229 <p>You can also try some GUI tools to set up and manage ODBC and2999 DebugFile = odbc.debug</pre> 3000 3001 <p>You can also try some GUI tools to set up and manage ODBC and 6230 3002 databases. Check out if the following tools are available on your 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 3003 machine:</p> 3004 3005 <pre class="programlisting">$ DataManager</pre> 3006 3007 <pre class="programlisting">$ ODBCConfig</pre> 3008 </div> 3009 </div> 3010 3011 <div class="sect1" title="Configuration of QCG Notification"><div class="titlepage"><div><div><h2 class="title"><a id="idp702064"></a>Configuration of <span class="emphasis"><em>QCG Notification</em></span></h2></div></div></div> 3012 3013 3014 <div class="sect2" title="Configuration File: qcg-ntfd.xml"><div class="titlepage"><div><div><h3 class="title"><a id="idp703168"></a>Configuration File: <code class="filename">qcg-ntfd.xml</code></h3></div></div></div> 3015 3016 3017 <pre class="programlisting"><sm:QCGCore 6266 3018 xmlns:sm="http://schemas.qoscosgrid.org/core/2011/04/config" 6267 3019 xmlns="http://schemas.qoscosgrid.org/ntf/2011/04/config" … … 6352 3104 6353 3105 </Configuration> 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 3106 </sm:QCGCore></pre> 3107 3108 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 3109 <p><span class="emphasis"><em>//sm:ModuleManager/sm:Directory 3110 <span class="emphasis"><em>[string]</em></span></em></span></p> 3111 3112 <p>Directories with modules that will be used in the 3113 service.</p> 3114 </li><li class="listitem"> 3115 <p><span class="emphasis"><em>//sm:Service 3116 <span class="emphasis"><em>[sm:QCGBaseServiceType]</em></span></em></span></p> 3117 3118 <p>Configuration of the services. It is possible to configure 3119 many instances of the service in the one configuration file.</p> 3120 </li><li class="listitem"> 3121 <p><span class="emphasis"><em>//sm:Service/sm:Logger</em></span> 3122 [sm:LoggerType]</p> 3123 3124 <p>Configuration of the logging.</p> 3125 </li><li class="listitem"> 3126 <p><span class="emphasis"><em>//sm:Service/sm:Logger/sm:FileName 3127 <span class="emphasis"><em>[string]</em></span></em></span></p> 3128 3129 <p>A log file path.</p> 3130 </li><li class="listitem"> 3131 <p><span class="emphasis"><em>//sm:Service/sm:Logger/sm:Level 3132 <span class="emphasis"><em>[enumeration]</em></span></em></span></p> 3133 3134 <p>DEBUG, INFO, NOTICE, WARNING, ERROR, CRIT, EMERG - filter less 3135 important messages.</p> 3136 </li><li class="listitem"> 3137 <p><span class="emphasis"><em>//sm:Service/sm:Transport</em></span> 3138 [sm:TransportType]</p> 3139 3140 <p>This element aggregates configuration of transport modules. At 6441 3141 least one module of type ecm* should by specified in this place. For 6442 3142 full list of supported ecm* modules see the QCG Core 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 3143 documentation</p> 3144 </li><li class="listitem"> 3145 <p><span class="emphasis"><em>//sm:Service/sm:Transport/sm:Module[@type=sm:ecm_gsoap.service]</em></span></p> 3146 3147 <p>Basic configuration of the Web Service interface. The most 6454 3148 important configuration covers such aspects as host and port where 6455 3149 the service will be listening. The instruction of using other 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 3150 options is located in QCG Core documentation.</p> 3151 </li><li class="listitem"> 3152 <p><span class="emphasis"><em>//sm:Service/sm:Transport/sm:Module[@type=smn:ntf-service-gsoap]</em></span></p> 3153 3154 <p>Define ntf-service-gsoap module as a default module for the 3155 service. This option shouldn't be changed.</p> 3156 </li><li class="listitem"> 3157 <p><span class="emphasis"><em>//sm:Service/sm:Authentication</em></span> 3158 [sm:AuthenticationType]</p> 3159 3160 <p>Configuration of authentication modules for the service. For 6479 3161 full list of supported authentication modules see the QCG Core 6480 3162 documentation (the most basic are: sm:atc_transport_http for 6481 3163 anonymous communication and sm:atc_transport_https for SSL based 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 3164 communication).</p> 3165 </li><li class="listitem"> 3166 <p><span class="emphasis"><em>//sm:Service/sm:Module/[@type=smn:ntf-publisher*]</em></span></p> 3167 3168 <p>Initialization and configuration of the modules for the 3169 Publisher side of <span class="emphasis"><em>QCG Notification</em></span>. The 3170 following modules are currently supported:</p> 3171 3172 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 3173 <p>smn:ntf-publisher-gsoap-anonymous for anonymous SOAP 3174 communication;</p> 3175 </li><li class="listitem"> 3176 <p>smn:ntf-publisher-gsoap-ssl for SSL based SOAP 3177 communication;</p> 3178 </li><li class="listitem"> 3179 <p>smn:ntf-publisher-xmpp for XMPP communication;</p> 3180 </li><li class="listitem"> 3181 <p>smn:ntf-publisher-smtp for SMTP communication;</p> 3182 </li></ul></div> 3183 3184 <p>For details see the <a class="link" href="#moduleoptions" title="Module configuration">Section 3185 5.2</a>.</p> 3186 </li><li class="listitem"> 3187 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar 3188 </em></span>[smn:NotificationsVarType]</p> 3189 3190 <p>Various notification settings closely related to QCG 3191 Notification service implementation.</p> 3192 </li><li class="listitem"> 3193 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:TopicNsDir 3194 <span class="emphasis"><em>[string]</em></span></em></span></p> 3195 3196 <p>Location of the directory with files containing Topic 3197 definitions.</p> 3198 </li><li class="listitem"> 3199 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:StrictCorrectnessCheckingEnabled</em></span> 3200 [boolean]</p> 3201 3202 <p>true, false - determines a strict validation of incoming 6565 3203 messages; if true, it allows receiving detailed information about 6566 3204 faults but it causes greatest delays; if false, then faults 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; 3205 processing is minimal and delays are smaller. Default: false</p> 3206 </li><li class="listitem"> 3207 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:DisableCurrentMessages</em></span> 3208 [boolean]</p> 3209 3210 <p>true, false - enable or disable support for CurrentMessages; 6579 3211 If set to true, the last notification messages wouldn't be stored in 6580 3212 a buffer for the gathering by the GetCurrentMessage method. Default: 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 3213 false</p> 3214 </li><li class="listitem"> 3215 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/ 3216 </em></span>[smn:SubscriptionManagerType]</p> 3217 3218 <p>Settings related to Subscriptions management.</p> 3219 </li><li class="listitem"> 3220 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:ContentFilteringEnabled</em></span> 3221 [boolean]</p> 3222 3223 <p>true, false - determines if a content filtering of 6604 3224 notification messages can be used; if true, Subscribers can specify 6605 3225 content filters in their Subscriptions, if false, it is disallowed. 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 3226 Default: true</p> 3227 </li><li class="listitem"> 3228 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPolicy</em></span> 3229 [enumeration]</p> 3230 3231 <p>DUPLICATE, DELETE_OLD, RETURN_FAULT - parameter defines an 6618 3232 action which should be taken when a Subscriber wants to create a 6619 3233 Subscription with the same parameters as the parameters of already 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 3234 existing Subscription. Default: <span class="bold"><strong>DELETE_OLD 3235 (before the version 2.6.2 it was DUPLICATE)</strong></span></p> 3236 </li><li class="listitem"> 3237 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:DialectConsistencyRequired</em></span> 3238 [boolean]</p> 3239 3240 <p>true, false - determines if a Subscription covers the Notify 6637 3241 messages with a different Topics Dialect than the Topic Dialect of 6638 3242 the Subscription; if true, the Subscription covers only Notify … … 6640 3244 Notify messages with simpler Dialects (i.e. Subscription with Full 6641 3245 type of Dialect covers notifications sent with Concrete or Simple 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 3246 type). Default: true</p> 3247 </li><li class="listitem"> 3248 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:SubscriptionPeriod</em></span> 3249 [integer]</p> 3250 3251 <p>A default time period for a Subscription to be valid; in 6654 3252 minutes; if negative the Subscription time checking will be 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 3253 disabled. Default: <span class="bold"><strong>43200 (before the version 3254 2.6.2 it was 10)</strong></span></p> 3255 </li><li class="listitem"> 3256 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:SubscriptionManager/smn:RefreshRate</em></span> 3257 [integer]</p> 3258 3259 <p>A time period between successive Subscription Manager 6672 3260 refreshing events (events when outdated Subscriptions are deleted); 6673 3261 the time period is measured in seconds; if value is set to 0 or 6674 3262 negative then the periodical refreshing is disabled. Default: 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 3263 3600</p> 3264 </li><li class="listitem"> 3265 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/ 3266 </em></span>[smn:PublisherManagerType]</p> 3267 3268 <p>Settings related to Publishers management.</p> 3269 </li><li class="listitem"> 3270 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationRequired</em></span> 3271 [boolean]</p> 3272 3273 <p>true, false - determines a requirement of Publishers 6698 3274 Registrations; if true, a Publisher has to register himself before 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 3275 sending notifications; if false, it has not. Default: false</p> 3276 </li><li class="listitem"> 3277 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RegistrationPeriod</em></span> 3278 [integer]</p> 3279 3280 <p>A default time period for a Publisher Registration to be 6711 3281 valid; in minutes; if negative the Registration time checking will 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 3282 be disabled. <span class="bold"><strong>Default: 43200 (before the 3283 version 2.6.2 it was 10)</strong></span></p> 3284 </li><li class="listitem"> 3285 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PublisherManager/smn:RefreshRate</em></span> 3286 [integer]</p> 3287 3288 <p>A time period between successive Publisher Manager refreshing 6729 3289 events (events when outdated Publishers are deleted); the time 6730 3290 period is measured in seconds; if value is set to 0 or negative then 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 3291 the periodical refreshing is disabled. Default: 3600</p> 3292 </li><li class="listitem"> 3293 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/ 3294 </em></span>[smn:PullPointManagerType]</p> 3295 3296 <p>Settings related to PullPoints management.</p> 3297 </li><li class="listitem"> 3298 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointsEnabled 3299 <span class="emphasis"><em>[boolean]</em></span></em></span></p> 3300 3301 <p>true, false - determines if PullPoints for pull style of 3302 notifications can be used. Default: true</p> 3303 </li><li class="listitem"> 3304 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointSize</em></span> 3305 [integer]</p> 3306 3307 <p>A maximal number of messages that can be buffered in a single 6770 3308 PullPoint; if negative then the number of messages is unbounded. 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; 3309 Default: <span class="bold"><strong>1000 (before the version 2.6.2 it was 3310 100)</strong></span></p> 3311 </li><li class="listitem"> 3312 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:PullPointPeriod</em></span> 3313 [integer]</p> 3314 3315 <p>A default time period for a PullPoint to be valid; in minutes; 6788 3316 if negative the PullPoint time checking will be disabled. Default: 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 3317 <span class="bold"><strong>43200 (before the version 2.6.2 it was 3318 10)</strong></span></p> 3319 </li><li class="listitem"> 3320 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:PullPointManager/smn:RefreshRate</em></span> 3321 [integer]</p> 3322 3323 <p>A time period between successive PullPoint Manager refreshing 6806 3324 events (events when outdated PullPoints are deleted); the time 6807 3325 period is measured in seconds; if value is set to 0 or negative then 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 3326 the periodical refreshing is disabled. Default: 3600</p> 3327 </li><li class="listitem"> 3328 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/ 3329 </em></span>[smn:PublishingType]</p> 3330 3331 <p>A group of settings related to Publishing procedure.</p> 3332 </li><li class="listitem"> 3333 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferEnabled 3334 </em></span>[boolean]</p> 3335 3336 <p>true, false - determines if Notifications Buffer should be 6831 3337 enabled; Notifications Buffer is used for resending Notifications if 6832 3338 those weren't sent successfully at the first attempt. Default: 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 3339 true</p> 3340 </li><li class="listitem"> 3341 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsBufferSize 3342 </em></span>[integer]</p> 3343 3344 <p>A maximal number of Notifications that can be buffered in 3345 Notifications Buffer. Default: <span class="bold"><strong>10000 (before 3346 the version 2.6.2 it was 1000)</strong></span></p> 3347 </li><li class="listitem"> 3348 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:NotificationsResendingRate 3349 </em></span>[integer]</p> 3350 3351 <p>A time period between successive notification resending 6862 3352 procedures; in seconds; if 0 or negative then the resending will be 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 3353 disabled. Default: 60</p> 3354 </li><li class="listitem"> 3355 <p><span class="emphasis"><em>//smn:Core/smn:NotificationsVar/smn:Publishing/smn:MaxSendTries</em></span> 3356 [integer]</p> 3357 3358 <p>A maximal number of consecutive unsuccessful tries of sending 6875 3359 notification; unsuccessful tries of sending notifications are 6876 3360 counted independently for every Subscription; a certain Subscription 6877 3361 will be delayed if its counter become equal to 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> 3362 <span class="emphasis"><em>MaxSendTries</em></span>; if value is set to 0 or negative 3363 then this option is disabled. Default: 5</p> 3364 </li><li class="listitem"> 3365 <p><span class="emphasis"><em>//smn:Core/Database/DatabaseEnabled 3366 <span class="emphasis"><em>[boolean]</em></span></em></span></p> 3367 3368 <p>true, false - determines if a database should be enabled; in 3369 the simplest configuration, <span class="emphasis"><em>QCG Notification</em></span> 6904 3370 can be used also without a database connection, however many options 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 3371 will be then unavailable. Default: true</p> 3372 </li><li class="listitem"> 3373 <p><span class="emphasis"><em>//smn:Core/Database/DSN 3374 <span class="emphasis"><em>[string]</em></span></em></span></p> 3375 3376 <p>Data Source Name of a database. Note, that you should use ODBC 3377 DSN <span class="bold"><strong>not</strong></span> the database name.</p> 3378 </li><li class="listitem"> 3379 <p><span class="emphasis"><em>//smn:Core/Database/User 3380 <span class="emphasis"><em>[string]</em></span></em></span></p> 3381 3382 <p>A database user name.</p> 3383 </li><li class="listitem"> 3384 <p><span class="emphasis"><em>//smn:Core/Database/Password 3385 <span class="emphasis"><em>[string]</em></span></em></span></p> 3386 3387 <p>A password for a database user.</p> 3388 </li><li class="listitem"> 3389 <p><span class="emphasis"><em>//smn:Core/Database/CleanAtStart 3390 <span class="emphasis"><em>[boolean]</em></span></em></span></p> 3391 3392 <p>true, false - determines whether all information stored in a 6971 3393 database should be cleaned at starting of the QCG Notification 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. 3394 service.</p> 3395 </li></ul></div> 3396 </div> 3397 3398 <div class="sect2" title="Module configuration"><div class="titlepage"><div><div><h3 class="title"><a id="moduleoptions"></a>Module configuration</h3></div></div></div> 3399 3400 3401 <p>Modules are located in the PREFIX/*/lib/modules directories and 3402 are loaded during the<span class="emphasis"><em> QCG Notification</em></span> run time. 6994 3403 Module definitions are specified in appropriate sections of the 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 3404 configuration file.</p> 3405 3406 <div class="sect3" title="Publisher modules"><div class="titlepage"><div><div><h4 class="title"><a id="idp794784"></a>Publisher modules</h4></div></div></div> 3407 3408 3409 <p>As it was discussed in the previous sections, in a typical 7008 3410 brokered notification scenario there are two types of communication 7009 3411 and notification channels that need to be setup. The first one is a 7010 3412 communication channel between Subscriber/Publisher clients and 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 3413 <span class="emphasis"><em>QCG Notification. </em></span>This type of communication is 3414 currently completely based on QCG Core library.</p> 3415 3416 <p>The second type is an outgoing communication between 3417 <span class="emphasis"><em>QCG Notification</em></span> and NotificationConsumers and it 3418 is particular for <span class="emphasis"><em>QCG Notification</em></span>. In this 3419 situation <span class="emphasis"><em>QCG Notification</em></span> plays a role of a 7034 3420 Notification Publisher. At this time, supported modules for this 7035 3421 channel utilize a Web Service interface, XMPP interface and SMTP 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 3422 interface.</p> 3423 3424 <div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"> 3425 <p><span class="bold"><strong>Publisher Anonymous WS 3426 transport</strong></span></p> 3427 3428 <p><span class="emphasis"><em><span class="emphasis"><em>This type of transport is recommended 7053 3429 only for internal, secure network environments or 7054 testing. 7055 </em> 7056 </span> 7057 </em> 7058 </span> 7059 </p> 7060 <pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-anonymous"> 3430 testing.</em></span></em></span></p><pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-anonymous"> 7061 3431 <smn:UseWSA>true</smn:UseWSA> 7062 3432 <smn:RecvTimeout>10</smn:RecvTimeout> 7063 3433 <smn:SendTimeout>10</smn:SendTimeout> 7064 3434 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 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"> 3435 </Module></pre> 3436 </li><li class="listitem"> 3437 <p><span class="bold"><strong>Publisher SSL WS transport and 3438 authentication</strong></span></p><pre class="programlisting"><Module xsi:type="smn:ntf-publisher-gsoap-ssl"> 7077 3439 <smn:UseWSA>true</smn:UseWSA> 7078 3440 <smn:RecvTimeout>10</smn:RecvTimeout> … … 7083 3445 <smn:TrustedCAPath>/opt/qcg/etc/ssl/certs/qcg-ntf/ca.pem</smn:TrustedCAPath> 7084 3446 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 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. 3447 </Module></pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"> 3448 <p dir="lro"><span class="emphasis"><em>//smn:UseWSA 3449 <span class="emphasis"><em>[boolean]</em></span></em></span></p> 3450 3451 <p>Determine if WS-Addressing should be used.</p> 3452 </li><li dir="lro" class="listitem"> 3453 <p dir="lro"><span class="emphasis"><em>//smn:RecvTimeout 3454 <span class="emphasis"><em>[positiveInteger]</em></span></em></span></p> 3455 3456 <p>The timeout in seconds for stall on the recv function. 3457 If negative, time is measured in microseconds.</p> 3458 </li><li dir="lro" class="listitem"> 3459 <p dir="lro"><span class="emphasis"><em>//smn:SendTimeout 3460 <span class="emphasis"><em>[positiveInteger]</em></span></em></span></p> 3461 3462 <p>The timeout in seconds for stall on the send function. 3463 If negative, time is measured in microseconds.</p> 3464 </li><li dir="lro" class="listitem"> 3465 <p dir="lro"><span class="emphasis"><em>//smn:X509CertKeyFile 3466 <span class="emphasis"><em>[string]</em></span></em></span></p> 3467 3468 <p>A path to the file with both X509 certificate and 3469 private key. Mandatory argument.</p> 3470 </li><li class="listitem"> 3471 <p><span class="emphasis"><em>//smn:X509KeyPass 3472 <span class="emphasis"><em>[string]</em></span></em></span></p> 3473 3474 <p>An optional password to X509 private key.</p> 3475 </li><li class="listitem"> 3476 <p><span class="emphasis"><em>//smn:TrutedCAFile 3477 <span class="emphasis"><em>[string]</em></span></em></span></p> 3478 3479 <p>A path to the file with trusted CAs certificates. 7180 3480 Either TrustedCAFile or TrustedCAPath must be 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 3481 specified.</p> 3482 </li><li class="listitem"> 3483 <p><span class="emphasis"><em>//smn:TrutedCAPath 3484 <span class="emphasis"><em>[string]</em></span></em></span></p> 3485 3486 <p>A path to the directory with the files with trusted 7197 3487 CAs certificates. Either TrustedCAFile or TrustedCAPath must 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 3488 be specified.</p> 3489 </li><li class="listitem"> 3490 <p><span class="emphasis"><em>//smn:NotifyTopicConversion 3491 <span class="emphasis"><em>[enumeration]</em></span></em></span></p> 3492 3493 <p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 7214 3494 type of conversion that will be applied (if needed) to the 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 3495 Topic element of Notify messages.</p> 3496 </li></ul></div> 3497 </li><li class="listitem"> 3498 <p><span class="bold"><strong>Publisher XMPP 3499 transport</strong></span></p> 3500 3501 <p><span class="bold"><strong><span class="emphasis"><em>The XMPP publisher module 7234 3502 can send two versions of notifications via XMPP. The first version 7235 3503 are notifications expressed as SOAP messages, the second are … … 7238 3506 document was provided in Subscribe message: the XSLT document will 7239 3507 be used to transform the message to the appropriate 7240 form. 7241 </em> 7242 </span> 7243 </strong> 7244 </span> 7245 </p> 7246 <pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-xmpp"> 3508 form.</em></span></strong></span></p><pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-xmpp"> 7247 3509 <smn:Server>xmppserver.qcg.com</smn:Server> 7248 3510 <smn:Port>5222</smn:Port> … … 7254 3516 <smn:CertFingerprint>00112233445566778899AABBCCDDEE</smn:CertFingerprint> 7255 3517 <smn:NotifyTopicConversion>WSN</smn:NotifyTopicConversion> 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" 3518 </sm:Module></pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"> 3519 <p dir="lro"><span class="emphasis"><em>//smn:Server 3520 <span class="emphasis"><em>[string]</em></span></em></span></p> 3521 3522 <p>Hostname of the XMPP server on which the XMPP account 3523 is set up.</p> 3524 </li><li dir="lro" class="listitem"> 3525 <p dir="lro"><span class="emphasis"><em>//smn<span class="emphasis"><em>:Port 3526 [positiveInteger]</em></span></em></span></p> 3527 3528 <p>Port number of the XMPP server. Default is 3529 5222.</p> 3530 </li><li dir="lro" class="listitem"> 3531 <p dir="lro"><span class="emphasis"><em>//smn:Username<span class="emphasis"><em>[string]</em></span></em></span></p> 3532 3533 <p>Username used for the XMPP account.</p> 3534 </li><li dir="lro" class="listitem"> 3535 <p dir="lro"><span class="emphasis"><em>//smn:Password<span class="emphasis"><em>[string]</em></span></em></span></p> 3536 3537 <p>The secret key for the XMPP account.</p> 3538 </li><li class="listitem"> 3539 <p><span class="emphasis"><em>//smn:Jid 3540 <span class="emphasis"><em>[string]</em></span></em></span></p> 3541 3542 <p>JID of the XMPP account</p> 3543 </li><li class="listitem"> 3544 <p><span class="emphasis"><em>//smn:ResourceName 3545 <span class="emphasis"><em>[string]</em></span></em></span></p> 3546 3547 <p>Resource name used by publisher's client 3548 connection.</p> 3549 </li><li class="listitem"> 3550 <p><span class="emphasis"><em>//smn:Encryption 3551 <span class="emphasis"><em>[string]</em></span></em></span></p> 3552 3553 <p>Encryption to use. By default it's "none". Use "TLS" 7364 3554 for STARTTLS connection encryption. Use "SSL" for old-style 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 3555 SSL encryption (typically port 5223).</p> 3556 </li><li class="listitem"> 3557 <p><span class="emphasis"><em>//smn:CertFingerprint 3558 <span class="emphasis"><em>[string]</em></span></em></span></p> 3559 3560 <p>MD5 fingerprint of the encryption certificate used by 7381 3561 the XMPP server. Upon mismatch, the connection will fail. 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 3562 Use empty string to accept any certificate.</p> 3563 </li><li class="listitem"> 3564 <p><span class="emphasis"><em>//smn:NotifyTopicConversion 3565 <span class="emphasis"><em>[enumeration]</em></span></em></span></p> 3566 3567 <p>WSN, WSN_WITH_ADDITIONAL_NS, INLINE, LACK - defines a 7398 3568 type of conversion that will be applied (only if needed) to 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 3569 the Topic element of Notify messages.</p> 3570 </li></ul></div> 3571 </li><li class="listitem"> 3572 <p><span class="bold"><strong>Publisher SMTP 3573 transport</strong></span></p> 3574 3575 <p><span class="bold"><strong><span class="emphasis"><em>Similarly to the XMPP 7418 3576 publisher module, the SMTP module utilizes the XSLT documents to 7419 3577 transform the content of the notification to the human-friendly 7420 form. 7421 </em> 7422 </span> 7423 </strong> 7424 </span> 7425 </p> 7426 <pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-smtp"> 3578 form. </em></span></strong></span></p><pre class="programlisting"><sm:Module xsi:type="smn:ntf-publisher-smtp"> 7427 3579 <smn:ServerURL>smtp://localhost:25</smn:ServerURL> 7428 3580 <smn:User>someuser</smn:User> … … 7435 3587 <smn:Trace>false</smn:Trace> 7436 3588 <smn:SendTimeout>10</smn:SendTimeout> 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 3589 </sm:Module> </pre><div class="itemizedlist"><ul class="itemizedlist"><li dir="lro" class="listitem"> 3590 <p dir="lro"><span class="emphasis"><em>//smn:Server 3591 <span class="emphasis"><em>[string]</em></span></em></span></p> 3592 3593 <p>URL of the SMTP server. Mandatory argument.</p> 3594 </li><li dir="lro" class="listitem"> 3595 <p dir="lro"><span class="emphasis"><em>//smn:User 3596 <span class="emphasis"><em>[string]</em></span></em></span></p> 3597 3598 <p>Name of the account on SMTP server. Optional 3599 argument.</p> 3600 </li><li dir="lro" class="listitem"> 3601 <p dir="lro"><span class="emphasis"><em>//smn:Password 3602 <span class="emphasis"><em>[string]</em></span></em></span></p> 3603 3604 <p>The secret key for the account. Optional 3605 argument.</p> 3606 </li><li class="listitem"> 3607 <p><span class="emphasis"><em>//smn:Encryption 3608 <span class="emphasis"><em>[string]</em></span></em></span></p> 3609 3610 <p>Used to enable encryption. The only supported type of 7501 3611 encryption is "TLS". If not present, encryption will be 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 3612 switched off. Optional argument.</p> 3613 </li><li class="listitem"> 3614 <p><span class="emphasis"><em>//smn:TrutedCAFile 3615 <span class="emphasis"><em>[string]</em></span></em></span></p> 3616 3617 <p>A path to the file with trusted CAs certificates. 3618 Optional argument.</p> 3619 </li><li class="listitem"> 3620 <p><span class="emphasis"><em>//smn:TrutedCAPath 3621 <span class="emphasis"><em>[string]</em></span></em></span></p> 3622 3623 <p>A path to the directory with the files with trusted 3624 CAs certificates. Optional argument.</p> 3625 </li><li class="listitem"> 3626 <p><span class="emphasis"><em>//smn:From 3627 <span class="emphasis"><em>[string]</em></span></em></span></p> 3628 3629 <p>Defines a name that will be placed in From field of 3630 the e-mail message. Optional argument.</p> 3631 </li><li class="listitem"> 3632 <p><span class="emphasis"><em>//smn:Subject 3633 <span class="emphasis"><em>[string]</em></span></em></span></p> 3634 3635 <p>Defines a Subject of the e-mail message. Optional 3636 argument.</p> 3637 </li><li class="listitem"> 3638 <p><span class="emphasis"><em>//smn:Trace 3639 <span class="emphasis"><em>[boolean]</em></span></em></span></p> 3640 3641 <p>Switches trace logging. Optional argument, default is 3642 false.</p> 3643 </li><li class="listitem"> 3644 <p><span class="emphasis"><em>//smn:SendTimeout 3645 <span class="emphasis"><em>[int]</em></span></em></span></p> 3646 3647 <p>The timeout in seconds for stall on the send function. 3648 Optional argument, default is 10.</p> 3649 </li></ul></div> 3650 </li></ul></div> 3651 </div> 3652 </div> 3653 3654 <div class="sect2" title="WS-Topics management"><div class="titlepage"><div><div><h3 class="title"><a id="idp870048"></a>WS-Topics management</h3></div></div></div> 3655 3656 3657 <p>In the current release, a topics management in <span class="emphasis"><em>QCG 3658 Notification</em></span> is relatively simple. The first step is a 7624 3659 preparation of an XML document with a Topic Namespace definition. This 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 3660 step can be done by one of the peers cooperating with <span class="emphasis"><em>QCG 3661 Notification</em></span>. Then the document should be delivered to the 3662 computer where <span class="emphasis"><em>QCG Notification</em></span> is installed. It 7636 3663 can be done in two ways: the document may be copied manually by QCG 7637 3664 Notification administrator to TopicNamespaces directory in prior to 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 3665 <span class="emphasis"><em>a QCG Notification</em></span> startup or it can be send 3666 through the <span class="emphasis"><em>QCG Notification</em></span> interface when 3667 <span class="emphasis"><em>QCG Notification</em></span> is already running. In the last 7653 3668 case, the TopicNamespaces are stored also in a files in TopicNamespace 7654 3669 directory so they can be automatically loaded after restart of the 7655 3670 service. The TopicNamespaces loaded from files may be protected from 7656 3671 unwanted removal by unsetting write permissions for a certain 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 3672 file.</p> 3673 3674 <p>An XML document describing a sample topic namespace is presented 3675 in the <a class="link" href="#ted" title="Topics, TopicExpressions and Dialects">Section 3.3</a>.</p> 3676 </div> 3677 3678 <div class="sect2" title="Starting QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp875936"></a>Starting <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div> 3679 3680 3681 <p>To start <span class="emphasis"><em>QCG Notification</em></span> as a daemon 3682 type:</p> 3683 3684 <pre class="programlisting">$ ./qcg-ntfd</pre> 3685 3686 <p>If you start <span class="emphasis"><em>QCG Notification</em></span> with parameter 3687 -h you will get an optional parameters list:</p><pre class="programlisting">$ ./qcg-ntfd -h 7696 3688 usage: ./qcg-ntfd [-d] [-z config_file] 7697 3689 … … 7700 3692 -z config_file configuration file, default is /opt/qcg/etc/qcg-ntfd.xml 7701 3693 -v print version information 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 3694 -h print this help</pre><p>Once you run <span class="emphasis"><em>QCG 3695 Notification</em></span> as a daemon, a log file is created. Using 3696 various log levels, you can log less or more details.</p> 3697 </div> 3698 3699 <div class="sect2" title="Stopping QCG Notification"><div class="titlepage"><div><div><h3 class="title"><a id="idp881408"></a>Stopping <span class="emphasis"><em>QCG Notification</em></span></h3></div></div></div> 7728 3700 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>3701 3702 <p>At the moment, shutdown is performed simply by sending 3703 <code class="filename">SIGINT</code> signal to the service, e.g.:</p> 3704 3705 <pre class="programlisting">$ kill -SIGINT `pidof qcg-ntfd`</pre> 3706 </div> 3707 </div> 7736 3708 </div> 7737 3709 }}}