2001 2009 Ericsson AB. All Rights Reserved.
The contents of this file are subject to the Erlang Public License, Version 1.1, (the "License"); you may not use this file except in compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

Event Domain Service

Niclas Eklund
2001-08-20
A ch_event_domain_service.xml

## Overview of the CosEventDomain Service

The Event Domain service allows programmers to manage a cluster of information channels.

### Event Domain Service Components

There are two components in the OMG CosEventDomainAdmin service architecture:

EventDomainFactory: a factory for creating EventDomains. EventDomain: supplies a tool, which makes it easy to create topologies of interconnected channels (i.e. a directed graph).

### A Tutorial on How to Create a Simple Service

To be able to use the cosEventDomain application, the cosNotification and, possibly, the cosTime application must be installed.

### How to Run Everything

Below is a short transcript on how to run cosEventDomain.

`%% Start Mnesia and Orber mnesia:delete_schema([node()]), mnesia:create_schema([node()]), orber:install([node()]), mnesia:start(), orber:start(), %% Install and start cosNotification. cosNotificationApp:install(), cosNotificationApp:start(), %% Install and start cosEventDomain. cosEventDomainApp:install(), cosEventDomainApp:start(), %% Start a CosEventDomainAdmin factory. AdminFac = cosEventDomainApp:start_factory(), %% Define the desired QoS settings: QoS = [#'CosNotification_Property' {name='CosEventDomainAdmin':'DiamondDetection'(), value=any:create(orber_tc:short(), 'CosEventDomainAdmin':'AuthorizeDiamonds'())}, #'CosNotification_Property' {name='CosEventDomainAdmin':'CycleDetection'(), value=any:create(orber_tc:short(), 'CosEventDomainAdmin':'ForbidCycles'())}], %% Create a new EventDomain: {ED, EDId} = 'CosEventDomainAdmin_EventDomainFactory': create_event_domain(Fac, QoS, []), %% Now we can add Notification Channels to the Domain. How this %% is done, see the cosNotification documentation. Let us assume %% that we have gained access to two Channel Objects; add them to the %% domain: ID1 = 'CosEventDomainAdmin_EventDomain':add_channel(ED, Ch1), ID2 = 'CosEventDomainAdmin_EventDomain':add_channel(ED, Ch2), %% To connect them, we must first define a connection struct: C1 = #'CosEventDomainAdmin_Connection'{supplier_id=ID1, consumer_id=ID2, ctype='STRUCTURED_EVENT', notification_style='Pull'}, %% Connect them: 'CosEventDomainAdmin_EventDomain':add_connection(ED, C1),`