~rdoering/ubuntu/karmic/erlang/fix-535090

« back to all changes in this revision

Viewing changes to lib/cosEventDomain/doc/src/CosEventDomainAdmin_EventDomain.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sergei Golovan
  • Date: 2009-02-15 16:42:52 UTC
  • mfrom: (3.1.2 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090215164252-q5x4rcf8a5pbesb1
Tags: 1:12.b.5-dfsg-2
Upload to unstable after lenny is released.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="latin1" ?>
 
2
<!DOCTYPE erlref SYSTEM "erlref.dtd">
 
3
 
 
4
<erlref>
 
5
  <header>
 
6
    <copyright>
 
7
      <year>2001</year>
 
8
      <year>2008</year>
 
9
      <holder>Ericsson AB, All Rights Reserved</holder>
 
10
    </copyright>
 
11
    <legalnotice>
 
12
  The contents of this file are subject to the Erlang Public License,
 
13
  Version 1.1, (the "License"); you may not use this file except in
 
14
  compliance with the License. You should have received a copy of the
 
15
  Erlang Public License along with this software. If not, it can be
 
16
  retrieved online at http://www.erlang.org/.
 
17
 
 
18
  Software distributed under the License is distributed on an "AS IS"
 
19
  basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 
20
  the License for the specific language governing rights and limitations
 
21
  under the License.
 
22
 
 
23
  The Initial Developer of the Original Code is Ericsson AB.
 
24
    </legalnotice>
 
25
 
 
26
    <title>CosEventDomainAdmin_&shy;EventDomain</title>
 
27
    <shorttitle>..._EventDomain</shorttitle>
 
28
    <prepared></prepared>
 
29
    <docno></docno>
 
30
    <approved>Niclas Eklund</approved>
 
31
    <checked></checked>
 
32
    <date>2001-08-20</date>
 
33
    <rev>PA1</rev>
 
34
  </header>
 
35
  <module>CosEventDomainAdmin_EventDomain</module>
 
36
  <modulesummary>This module implements the Event Domain interface.</modulesummary>
 
37
  <description>
 
38
    <p>To get access to all definitions include necessary <c><![CDATA[hrl]]></c> files by using:<br></br><c><![CDATA[-include_lib("cosEventDomain/include/*.hrl").]]></c></p>
 
39
    <p>This module also exports the functions described in:</p>
 
40
    <list type="bulleted">
 
41
      <item><em>CosNotification_QoSAdmin</em></item>
 
42
      <item><em>CosNotification_AdminPropertiesAdmin</em></item>
 
43
    </list>
 
44
  </description>
 
45
  <funcs>
 
46
    <func>
 
47
      <name>add_channel(EventDomain, Channel) -> MemberID</name>
 
48
      <fsummary>Add a new channel to the EventDomain</fsummary>
 
49
      <type>
 
50
        <v>EventDomain = Channel = #objref</v>
 
51
        <v>MemberID    = long()</v>
 
52
      </type>
 
53
      <desc>
 
54
        <p>Adds the given channel to the target domain. The channel
 
55
          must be a <c><![CDATA[CosNotifyChannelAdmin::EventChannel]]></c>.</p>
 
56
      </desc>
 
57
    </func>
 
58
    <func>
 
59
      <name>get_all_channels(EventDomain) -> MemberIDSeq</name>
 
60
      <fsummary>Return all channel id's associated with target object</fsummary>
 
61
      <type>
 
62
        <v>EventDomain = #objref</v>
 
63
        <v>MemberIDSeq = [long()]</v>
 
64
      </type>
 
65
      <desc>
 
66
        <p>Returns a a sequence of all channels associated with
 
67
          the target object.</p>
 
68
      </desc>
 
69
    </func>
 
70
    <func>
 
71
      <name>get_channel(EventDomain, MemberID) -> Reply</name>
 
72
      <fsummary>Return the channel associated with the given id</fsummary>
 
73
      <type>
 
74
        <v>EventDomain = #objref</v>
 
75
        <v>MemberID    = long()</v>
 
76
        <v>Reply       = Channel | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
77
        <v>Channel     = #objref</v>
 
78
      </type>
 
79
      <desc>
 
80
        <p>If the target domain have a <c><![CDATA[CosNotifyChannelAdmin::EventChannel]]></c>
 
81
          represented by the given id this channel is returned. Otherwise,
 
82
          an exception is raised.</p>
 
83
      </desc>
 
84
    </func>
 
85
    <func>
 
86
      <name>remove_channel(EventDomain, MemberID) -> Reply</name>
 
87
      <fsummary>Remove the channel associated with the given id and remove all connections of that channel</fsummary>
 
88
      <type>
 
89
        <v>EventDomain = #objref</v>
 
90
        <v>MemberID    = long()</v>
 
91
        <v>Reply       = ok | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
92
      </type>
 
93
      <desc>
 
94
        <p>If a  <c><![CDATA[CosNotifyChannelAdmin::EventChannel]]></c> with the 
 
95
          <c><![CDATA[MemberID]]></c> exists it will removed and all its <c><![CDATA[Connections]]></c>
 
96
          terminated. Otherwise an exception is raised.</p>
 
97
      </desc>
 
98
    </func>
 
99
    <func>
 
100
      <name>add_connection(EventDomain, Connection) -> Reply</name>
 
101
      <fsummary>If possible, setup a connection described by the <c><![CDATA[#'CosEventDomainAdmin_Connection'{}]]></c>struct</fsummary>
 
102
      <type>
 
103
        <v>EventDomain  = #objref</v>
 
104
        <v>Connection   = 'CosEventDomainAdmin_Connection'{supplier_id=MemberID, consumer_id=MemberID, ctype=Type, notification_style=Style}</v>
 
105
        <v>MemberID     = long()</v>
 
106
        <v>Type         = 'ANY_EVENT' | 'STRUCTURED_EVENT' | 'SEQUENCE_EVENT'</v>
 
107
        <v>Style        = 'Pull' | 'Push'</v>
 
108
        <v>Reply        = ConnectionID | {'EXCEPTION', Exc}</v>
 
109
        <v>ConnectionID = long()</v>
 
110
        <v>Exc          = #'CosNotifyChannelAdmin_ChannelNotFound'{} | #'CosNotifyChannelAdmin_TypeError'{} | #'CosEventDomainAdmin_AlreadyExists'{} | #'CosEventDomainAdmin_DiamondCreationForbidden'{diam=RouteSeq} | #'CosEventDomainAdmin_CycleCreationForbidden'{cyc=MemberIDSeq}</v>
 
111
        <v>RouteSeq  = [MemberIDSeq]</v>
 
112
        <v>MemberIDSeq  = [long()]</v>
 
113
      </type>
 
114
      <desc>
 
115
        <p>The Connection parameter must contain valid data to enable
 
116
          the target domain to setup a connection between two channels.
 
117
          The struct members <c><![CDATA[supplier_id]]></c> and <c><![CDATA[consumer_id]]></c>
 
118
          determines which channel should produce and consume events.
 
119
          which type of events and if the supplier should push or the
 
120
          consumer pull events is determined by <c><![CDATA[ctype]]></c> and
 
121
          <c><![CDATA[notification_style]]></c> respectively.</p>
 
122
        <p>If the target domain is not able to setup the connection
 
123
          the appropriate exception is raised.</p>
 
124
      </desc>
 
125
    </func>
 
126
    <func>
 
127
      <name>get_all_connections(EventDomain) -> ConnectionIDSeq</name>
 
128
      <fsummary>Return a sequence of all connections within the target domain</fsummary>
 
129
      <type>
 
130
        <v>EventDomain     = #objref</v>
 
131
        <v>ConnectionIDSeq = [long()]</v>
 
132
      </type>
 
133
      <desc>
 
134
        <p>This operation returns a sequnce of all connections within
 
135
          the target domain.</p>
 
136
      </desc>
 
137
    </func>
 
138
    <func>
 
139
      <name>get_connection(EventDomain, ConnectionID) -> Reply</name>
 
140
      <fsummary>Return a <c><![CDATA[#'CosEventDomainAdmin_Connection'{}]]></c>struct describing the connection associated with the given id  within the target domain</fsummary>
 
141
      <type>
 
142
        <v>EventDomain  = #objref</v>
 
143
        <v>ConnectionID = long()</v>
 
144
        <v>Reply        = Connection | {'EXCEPTION', #'CosEventDomainAdmin_ConnectionNotFound'{}}</v>
 
145
        <v>Connection   = 'CosEventDomainAdmin_Connection'{supplier_id=MemberID, consumer_id=MemberID, ctype=Type, notification_style=Style}</v>
 
146
        <v>MemberID     = long()</v>
 
147
        <v>Type         = 'ANY_EVENT' | 'STRUCTURED_EVENT' | 'SEQUENCE_EVENT'</v>
 
148
        <v>Style        = 'Pull' | 'Push'</v>
 
149
      </type>
 
150
      <desc>
 
151
        <p>If a connection identified by the given id exists within the
 
152
          target domain, a <c><![CDATA[#'CosEventDomainAdmin_Connection'{}]]></c> which
 
153
          describe the connection is returned. Otherwise, an exception
 
154
          is raised.</p>
 
155
      </desc>
 
156
    </func>
 
157
    <func>
 
158
      <name>remove_connection(EventDomain, ConnectionID) -> Reply</name>
 
159
      <fsummary>Remove the connection identified by the given id from  the target domain</fsummary>
 
160
      <type>
 
161
        <v>EventDomain  = #objref</v>
 
162
        <v>ConnectionID = long()</v>
 
163
        <v>Reply        = ok | {'EXCEPTION', #'CosEventDomainAdmin_ConnectionNotFound'{}}</v>
 
164
      </type>
 
165
      <desc>
 
166
        <p>If the supplied connection id exists, the connection the
 
167
          id represents is terminated. Otherwise, an exception is raised.</p>
 
168
      </desc>
 
169
    </func>
 
170
    <func>
 
171
      <name>get_offer_channels(EventDomain, MemberID) -> Reply</name>
 
172
      <fsummary>Return all id's of the channels which produce events received by the channel identified by the given id</fsummary>
 
173
      <type>
 
174
        <v>EventDomain = #objref</v>
 
175
        <v>MemberID    = long()</v>
 
176
        <v>Reply       = MemberIDSeq | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
177
      </type>
 
178
      <desc>
 
179
        <p>This operation returns a sequence, containing the member id's
 
180
          of all channels within the target domain which will supply events
 
181
          to the channel identified by the given id. But, if no such
 
182
          id exists in this domain, an exception is raised.</p>
 
183
      </desc>
 
184
    </func>
 
185
    <func>
 
186
      <name>get_subscription_channels(EventDomain, MemberID) -> Reply</name>
 
187
      <fsummary>Return all id's of the channels which consume events supplied by the channel identified by the given id</fsummary>
 
188
      <type>
 
189
        <v>EventDomain = #objref</v>
 
190
        <v>Reply       = MemberIDSeq | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
191
      </type>
 
192
      <desc>
 
193
        <p>This operations behaves like <c><![CDATA[get_subscription_channels]]></c>;
 
194
          the difference is that the id's returned identifies channels
 
195
          which will consume events supplied by the channel associated
 
196
          with the given id.</p>
 
197
      </desc>
 
198
    </func>
 
199
    <func>
 
200
      <name>destroy(EventDomain) -> ok</name>
 
201
      <fsummary>Destroy the event domain and all connections within it</fsummary>
 
202
      <type>
 
203
        <v>EventDomain = #objref</v>
 
204
      </type>
 
205
      <desc>
 
206
        <p>Calling this operation will terminate all connections
 
207
          within the target domain. The domain will terminate but
 
208
          all channels will not be affected.</p>
 
209
      </desc>
 
210
    </func>
 
211
    <func>
 
212
      <name>get_cycles(EventDomain) -> RouteSeq</name>
 
213
      <fsummary>Return a list of all cycles which exists within  the target domain</fsummary>
 
214
      <type>
 
215
        <v>EventDomain = #objref</v>
 
216
        <v>RouteSeq    = [MemberIDSeq]</v>
 
217
        <v>MemberIDSeq = [long()]</v>
 
218
      </type>
 
219
      <desc>
 
220
        <p>Returns a list of all cycles within the target domain.</p>
 
221
      </desc>
 
222
    </func>
 
223
    <func>
 
224
      <name>get_diamonds(EventDomain) -> DiamondSeq</name>
 
225
      <fsummary>Return a list of all diamonds which exists within  the target domain</fsummary>
 
226
      <type>
 
227
        <v>EventDomain = #objref</v>
 
228
        <v>DiamondSeq  = [RouteSeq]</v>
 
229
        <v>RouteSeq    = [MemberIDSeq]</v>
 
230
        <v>MemberIDSeq = [long()]</v>
 
231
      </type>
 
232
      <desc>
 
233
        <p>Returns a list of all diamonds within the target domain</p>
 
234
      </desc>
 
235
    </func>
 
236
    <func>
 
237
      <name>set_default_consumer_channel(EventDomain, MemberID) -> Reply</name>
 
238
      <fsummary>Set the channel represented by the given id as default for supplier clients</fsummary>
 
239
      <type>
 
240
        <v>EventDomain = #objref</v>
 
241
        <v>Reply       = MemberID | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
242
        <v>MemberID    = long()</v>
 
243
      </type>
 
244
      <desc>
 
245
        <p>If the given id represents a channel within the target domain,
 
246
          this channel will be used when connection a supplier client
 
247
          without specifying a certain channel. If no such channel exists
 
248
          an exceptions is raised.</p>
 
249
      </desc>
 
250
    </func>
 
251
    <func>
 
252
      <name>set_default_supplier_channel(EventDomain, MemberID) -> Reply</name>
 
253
      <fsummary>Set the channel represented by the given id as default for supplier clients</fsummary>
 
254
      <type>
 
255
        <v>EventDomain = #objref</v>
 
256
        <v>Reply       = MemberID | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
257
        <v>MemberID    = long()</v>
 
258
      </type>
 
259
      <desc>
 
260
        <p>If the given id represents a channel within the target domain,
 
261
          this channel will be used when connection a consumer client
 
262
          without specifying a certain channel. If no such channel exists
 
263
          an exceptions is raised.</p>
 
264
      </desc>
 
265
    </func>
 
266
    <func>
 
267
      <name>connect_push_consumer(EventDomain, Consumer) -> Reply</name>
 
268
      <fsummary>Connect the PushConsumer to the default Channel</fsummary>
 
269
      <type>
 
270
        <v>EventDomain = #objref</v>
 
271
        <v>Consumer    = CosEventComm::PushConsumer</v>
 
272
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
273
      </type>
 
274
      <desc>
 
275
        <p>If a default Channel have been set, this operation connects the given
 
276
          PushConsumer to it. Otherwise, the
 
277
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
278
      </desc>
 
279
    </func>
 
280
    <func>
 
281
      <name>connect_pull_consumer(EventDomain, Consumer) -> Reply</name>
 
282
      <fsummary>Connect the PullConsumer to the default Channel</fsummary>
 
283
      <type>
 
284
        <v>EventDomain = #objref</v>
 
285
        <v>Consumer    = CosEventComm::PullConsumer</v>
 
286
        <v>Reply       = CosNotifyChannelAdmin::ProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
287
      </type>
 
288
      <desc>
 
289
        <p>If a default Channel have been set, this operation connects the given
 
290
          PullConsumer to it. Otherwise, the
 
291
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
292
      </desc>
 
293
    </func>
 
294
    <func>
 
295
      <name>connect_push_supplier(EventDomain, Supplier) -> Reply</name>
 
296
      <fsummary>Connect the PushSupplier to the default Channel</fsummary>
 
297
      <type>
 
298
        <v>EventDomain = #objref</v>
 
299
        <v>Supplier    = CosEventComm::PushSupplier</v>
 
300
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
301
      </type>
 
302
      <desc>
 
303
        <p>If a default Channel have been set, this operation connects the given
 
304
          PushSupplier to it. Otherwise, the
 
305
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
306
      </desc>
 
307
    </func>
 
308
    <func>
 
309
      <name>connect_pull_supplier(EventDomain, Supplier) -> Reply</name>
 
310
      <fsummary>Connect the PullSupplier to the default Channel</fsummary>
 
311
      <type>
 
312
        <v>EventDomain = #objref</v>
 
313
        <v>Supplier    = CosEventComm::PullSupplier</v>
 
314
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
315
      </type>
 
316
      <desc>
 
317
        <p>If a default Channel have been set, this operation connects the given
 
318
          PullSupplier to it. Otherwise, the
 
319
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
320
      </desc>
 
321
    </func>
 
322
    <func>
 
323
      <name>connect_structured_push_consumer(EventDomain, Consumer) -> Reply</name>
 
324
      <fsummary>Connect the StructuredPushConsumer to the default Channel</fsummary>
 
325
      <type>
 
326
        <v>EventDomain = #objref</v>
 
327
        <v>Consumer    = CosNotifyComm::StructuredPushConsumer</v>
 
328
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
329
      </type>
 
330
      <desc>
 
331
        <p>If a default Channel have been set, this operation connects the given
 
332
          StructuredPushConsumer to it. Otherwise, the
 
333
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
334
      </desc>
 
335
    </func>
 
336
    <func>
 
337
      <name>connect_structured_pull_consumer(EventDomain, Consumer) -> Reply</name>
 
338
      <fsummary>Connect the StructuredPullConsumer to the default Channel</fsummary>
 
339
      <type>
 
340
        <v>EventDomain = #objref</v>
 
341
        <v>Consumer    = CosNotifyComm::StructuredPullConsumer</v>
 
342
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
343
      </type>
 
344
      <desc>
 
345
        <p>If a default Channel have been set, this operation connects the given
 
346
          StructuredPullConsumer to it. Otherwise, the
 
347
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
348
      </desc>
 
349
    </func>
 
350
    <func>
 
351
      <name>connect_structured_push_supplier(EventDomain, Supplier) -> Reply</name>
 
352
      <fsummary>Connect the StructuredPushSupplier to the default Channel</fsummary>
 
353
      <type>
 
354
        <v>EventDomain = #objref</v>
 
355
        <v>Supplier    = CosNotifyComm::StructuredPushSupplier</v>
 
356
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
357
      </type>
 
358
      <desc>
 
359
        <p>If a default Channel have been set, this operation connects the given
 
360
          StructuredPushSupplier to it. Otherwise, the
 
361
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
362
      </desc>
 
363
    </func>
 
364
    <func>
 
365
      <name>connect_structured_pull_supplier(EventDomain, Supplier) -> Reply</name>
 
366
      <fsummary>Connect the StructuredPullSupplier to the default Channel</fsummary>
 
367
      <type>
 
368
        <v>EventDomain = #objref</v>
 
369
        <v>Supplier    = CosNotifyComm::StructuredPullSupplier</v>
 
370
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPullConsume | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
371
      </type>
 
372
      <desc>
 
373
        <p>If a default Channel have been set, this operation connects the given
 
374
          StructuredPullSupplier to it. Otherwise, the
 
375
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
376
      </desc>
 
377
    </func>
 
378
    <func>
 
379
      <name>connect_sequence_push_consumer(EventDomain, Consumer) -> Reply</name>
 
380
      <fsummary>Connect the SequencePushConsumer to the default Channel</fsummary>
 
381
      <type>
 
382
        <v>EventDomain = #objref</v>
 
383
        <v>Consumer    = CosNotifyComm::SequencePushConsumer</v>
 
384
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
385
      </type>
 
386
      <desc>
 
387
        <p>If a default Channel have been set, this operation connects the given
 
388
          SequencePushConsumer to it. Otherwise, the
 
389
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
390
      </desc>
 
391
    </func>
 
392
    <func>
 
393
      <name>connect_sequence_pull_consumer(EventDomain, Consumer) -> Reply</name>
 
394
      <fsummary>Connect the SequencePullConsumer to the default Channel</fsummary>
 
395
      <type>
 
396
        <v>EventDomain = #objref</v>
 
397
        <v>Consumer    = CosNotifyComm::SequencePullConsumer</v>
 
398
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
399
      </type>
 
400
      <desc>
 
401
        <p>If a default Channel have been set, this operation connects the given
 
402
          SequencePullConsumer to it. Otherwise, the
 
403
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
404
      </desc>
 
405
    </func>
 
406
    <func>
 
407
      <name>connect_sequence_push_supplier(EventDomain, Supplier) -> Reply</name>
 
408
      <fsummary>Connect the SequencePushSupplier to the default Channel</fsummary>
 
409
      <type>
 
410
        <v>EventDomain = #objref</v>
 
411
        <v>Supplier    = CosNotifyComm::SequencePushSupplier</v>
 
412
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
413
      </type>
 
414
      <desc>
 
415
        <p>If a default Channel have been set, this operation connects the given
 
416
          SequencePushSupplier to it. Otherwise, the
 
417
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
418
      </desc>
 
419
    </func>
 
420
    <func>
 
421
      <name>connect_sequence_pull_supplier(EventDomain, Supplier) -> Reply</name>
 
422
      <fsummary>Connect the SequencePullSupplier to the default Channel</fsummary>
 
423
      <type>
 
424
        <v>EventDomain = #objref</v>
 
425
        <v>Supplier    = CosNotifyComm::SequencePullSupplier</v>
 
426
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPullConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
427
      </type>
 
428
      <desc>
 
429
        <p>If a default Channel have been set, this operation connects the given
 
430
          SequencePullSupplier to it. Otherwise, the 
 
431
          <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c> exception is raised.</p>
 
432
      </desc>
 
433
    </func>
 
434
    <func>
 
435
      <name>connect_push_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
436
      <fsummary>Connect the PushConsumer to the Channel with the given MemberID</fsummary>
 
437
      <type>
 
438
        <v>EventDomain = #objref</v>
 
439
        <v>Consumer    = CosEventComm::PushConsumer</v>
 
440
        <v>MemberID    = long()</v>
 
441
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
442
      </type>
 
443
      <desc>
 
444
        <p>If a Channel associated with the given MemberID exists within the
 
445
          target Domain, this operation connects the given PushConsumer 
 
446
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
447
          exception is raised.</p>
 
448
      </desc>
 
449
    </func>
 
450
    <func>
 
451
      <name>connect_pull_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
452
      <fsummary>Connect the PullConsumer to the Channel with the given MemberID</fsummary>
 
453
      <type>
 
454
        <v>EventDomain = #objref</v>
 
455
        <v>Consumer    = CosEventComm::PullConsumer</v>
 
456
        <v>MemberID    = long()</v>
 
457
        <v>Reply       = CosNotifyChannelAdmin::ProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
458
      </type>
 
459
      <desc>
 
460
        <p>If a Channel associated with the given MemberID exists within the
 
461
          target Domain, this operation connects the given PullConsumer 
 
462
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
463
          exception is raised.</p>
 
464
      </desc>
 
465
    </func>
 
466
    <func>
 
467
      <name>connect_push_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
468
      <fsummary>Connect the PushSupplier to the Channel with the given MemberID</fsummary>
 
469
      <type>
 
470
        <v>EventDomain = #objref</v>
 
471
        <v>Supplier    = CosEventComm::PushSupplier</v>
 
472
        <v>MemberID    = long()</v>
 
473
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
474
      </type>
 
475
      <desc>
 
476
        <p>If a Channel associated with the given MemberID exists within the
 
477
          target Domain, this operation connects the given PushSupplier 
 
478
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
479
          exception is raised.</p>
 
480
      </desc>
 
481
    </func>
 
482
    <func>
 
483
      <name>connect_pull_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
484
      <fsummary>Connect the PullSupplier to the Channel with the given MemberID</fsummary>
 
485
      <type>
 
486
        <v>EventDomain = #objref</v>
 
487
        <v>Supplier    = CosEventComm::PullSupplier</v>
 
488
        <v>MemberID    = long()</v>
 
489
        <v>Reply       = CosNotifyChannelAdmin::ProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
490
      </type>
 
491
      <desc>
 
492
        <p>If a Channel associated with the given MemberID exists within the
 
493
          target Domain, this operation connects the given PullSupplier 
 
494
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
495
          exception is raised.</p>
 
496
      </desc>
 
497
    </func>
 
498
    <func>
 
499
      <name>connect_structured_push_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
500
      <fsummary>Connect the StructuredPushConsumer to the Channel with the given MemberID</fsummary>
 
501
      <type>
 
502
        <v>EventDomain = #objref</v>
 
503
        <v>Consumer    = CosNotifyComm::StructuredPushConsumer</v>
 
504
        <v>MemberID    = long()</v>
 
505
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
506
      </type>
 
507
      <desc>
 
508
        <p>If a Channel associated with the given MemberID exists within the
 
509
          target Domain, this operation connects the given StructuredPushConsumer 
 
510
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
511
          exception is raised.</p>
 
512
      </desc>
 
513
    </func>
 
514
    <func>
 
515
      <name>connect_structured_pull_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
516
      <fsummary>Connect the StructuredPullConsumer to the Channel with the given MemberID</fsummary>
 
517
      <type>
 
518
        <v>EventDomain = #objref</v>
 
519
        <v>Consumer    = CosNotifyComm::StructuredPullConsumer</v>
 
520
        <v>MemberID    = long()</v>
 
521
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
522
      </type>
 
523
      <desc>
 
524
        <p>If a Channel associated with the given MemberID exists within the
 
525
          target Domain, this operation connects the given StructuredPullConsumer 
 
526
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
527
          exception is raised.</p>
 
528
      </desc>
 
529
    </func>
 
530
    <func>
 
531
      <name>connect_structured_push_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
532
      <fsummary>Connect the StructuredPushSupplier to the Channel with the given MemberID</fsummary>
 
533
      <type>
 
534
        <v>EventDomain = #objref</v>
 
535
        <v>Supplier    = CosNotifyComm::StructuredPushSupplier</v>
 
536
        <v>MemberID    = long()</v>
 
537
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
538
      </type>
 
539
      <desc>
 
540
        <p>If a Channel associated with the given MemberID exists within the
 
541
          target Domain, this operation connects the given StructuredPushSupplier 
 
542
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
543
          exception is raised.</p>
 
544
      </desc>
 
545
    </func>
 
546
    <func>
 
547
      <name>connect_structured_pull_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
548
      <fsummary>Connect the StructuredPullSupplier to the Channel with the given MemberID</fsummary>
 
549
      <type>
 
550
        <v>EventDomain = #objref</v>
 
551
        <v>Supplier    = CosNotifyComm::StructuredPullSupplier</v>
 
552
        <v>MemberID    = long()</v>
 
553
        <v>Reply       = CosNotifyChannelAdmin::StructuredProxyPullConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
554
      </type>
 
555
      <desc>
 
556
        <p>If a Channel associated with the given MemberID exists within the
 
557
          target Domain, this operation connects the given StructuredPullSupplier 
 
558
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
559
          exception is raised.</p>
 
560
      </desc>
 
561
    </func>
 
562
    <func>
 
563
      <name>connect_sequence_push_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
564
      <fsummary>Connect the SequencePushConsumer to the Channel with the given MemberID</fsummary>
 
565
      <type>
 
566
        <v>EventDomain = #objref</v>
 
567
        <v>Consumer    = CosNotifyComm::SequencePushConsumer</v>
 
568
        <v>MemberID    = long()</v>
 
569
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPushSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
570
      </type>
 
571
      <desc>
 
572
        <p>If a Channel associated with the given MemberID exists within the
 
573
          target Domain, this operation connects the given SequencePushConsumer
 
574
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
575
          exception is raised.</p>
 
576
      </desc>
 
577
    </func>
 
578
    <func>
 
579
      <name>connect_sequence_pull_consumer_with_id(EventDomain, Consumer, MemberID) -> Reply</name>
 
580
      <fsummary>Connect the SequencePullConsumer to the Channel with the given MemberID</fsummary>
 
581
      <type>
 
582
        <v>EventDomain = #objref</v>
 
583
        <v>Consumer    = CosNotifyComm::SequencePullConsumer</v>
 
584
        <v>MemberID    = long()</v>
 
585
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPullSupplier | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
586
      </type>
 
587
      <desc>
 
588
        <p>If a Channel associated with the given MemberID exists within the
 
589
          target Domain, this operation connects the given SequencePullConsumer
 
590
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
591
          exception is raised.</p>
 
592
      </desc>
 
593
    </func>
 
594
    <func>
 
595
      <name>connect_sequence_push_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
596
      <fsummary>Connect the SequencePushSupplier to the Channel with the given MemberID</fsummary>
 
597
      <type>
 
598
        <v>EventDomain = #objref</v>
 
599
        <v>Supplier    = CosNotifyComm::SequencePushSupplier</v>
 
600
        <v>MemberID    = long()</v>
 
601
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPushConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
602
      </type>
 
603
      <desc>
 
604
        <p>If a Channel associated with the given MemberID exists within the
 
605
          target Domain, this operation connects the given SequencePushSupplier
 
606
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
607
          exception is raised.</p>
 
608
      </desc>
 
609
    </func>
 
610
    <func>
 
611
      <name>connect_sequence_pull_supplier_with_id(EventDomain, Supplier, MemberID) -> Reply</name>
 
612
      <fsummary>Connect the SequencePullSupplier to the Channel with the given MemberID</fsummary>
 
613
      <type>
 
614
        <v>EventDomain = #objref</v>
 
615
        <v>Supplier    = CosNotifyComm::SequencePullSupplier</v>
 
616
        <v>MemberID    = long()</v>
 
617
        <v>Reply       = CosNotifyChannelAdmin::SequenceProxyPullConsumer | {'EXCEPTION', #'CosNotifyChannelAdmin_ChannelNotFound'{}}</v>
 
618
      </type>
 
619
      <desc>
 
620
        <p>If a Channel associated with the given MemberID exists within the
 
621
          target Domain, this operation connects the given SequencePullSupplier
 
622
          to it. Otherwise, the <c><![CDATA[#'CosNotifyChannelAdmin_ChannelNotFound'{}]]></c>
 
623
          exception is raised.</p>
 
624
      </desc>
 
625
    </func>
 
626
  </funcs>
 
627
  
 
628
</erlref>
 
629