<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" href="../../../../doc/otp_doc.css" type="text/css"> <title>Erlang -- CosEventChannelAdmin</title> </head> <body bgcolor="white" text="#000000" link="#0000ff" vlink="#ff00ff" alink="#ff0000"><div id="container"> <script id="js" type="text/javascript" language="JavaScript" src="../../../../doc/js/flipmenu/flipmenu.js"></script><script id="js2" type="text/javascript" src="../../../../doc/js/erlresolvelinks.js"></script><script language="JavaScript" type="text/javascript"> <!-- function getWinHeight() { var myHeight = 0; if( typeof( window.innerHeight ) == 'number' ) { //Non-IE myHeight = window.innerHeight; } else if( document.documentElement && ( document.documentElement.clientWidth || document.documentElement.clientHeight ) ) { //IE 6+ in 'standards compliant mode' myHeight = document.documentElement.clientHeight; } else if( document.body && ( document.body.clientWidth || document.body.clientHeight ) ) { //IE 4 compatible myHeight = document.body.clientHeight; } return myHeight; } function setscrollpos() { var objf=document.getElementById('loadscrollpos'); document.getElementById("leftnav").scrollTop = objf.offsetTop - getWinHeight()/2; } function addEvent(obj, evType, fn){ if (obj.addEventListener){ obj.addEventListener(evType, fn, true); return true; } else if (obj.attachEvent){ var r = obj.attachEvent("on"+evType, fn); return r; } else { return false; } } addEvent(window, 'load', setscrollpos); //--></script><div id="leftnav"><div class="innertube"> <img alt="Erlang logo" src="../../../../doc/erlang-logo.png"><br><small><a href="users_guide.html">User's Guide</a><br><a href="index.html">Reference Manual</a><br><a href="release_notes.html">Release Notes</a><br><a href="../pdf/cosEvent-2.1.8.pdf">PDF</a><br><a href="../../../../doc/index.html">Top</a></small><p><strong>cosEvent</strong><br><strong>Reference Manual</strong><br><small>Version 2.1.8</small></p> <br><a href="javascript:openAllFlips()">Expand All</a><br><a href="javascript:closeAllFlips()">Contract All</a><p><small><strong>Table of Contents</strong></small></p> <ul class="flipMenu"> <li id="no" title="cosEventApp " expanded="false">cosEventApp<ul> <li><a href="cosEventApp.html"> Top of manual page </a></li> <li title="install-0"><a href="cosEventApp.html#install-0">install/0</a></li> <li title="uninstall-0"><a href="cosEventApp.html#uninstall-0">uninstall/0</a></li> <li title="start-0"><a href="cosEventApp.html#start-0">start/0</a></li> <li title="stop-0"><a href="cosEventApp.html#stop-0">stop/0</a></li> <li title="start_channel-0"><a href="cosEventApp.html#start_channel-0">start_channel/0</a></li> <li title="start_channel-1"><a href="cosEventApp.html#start_channel-1">start_channel/1</a></li> <li title="start_channel_link-0"><a href="cosEventApp.html#start_channel_link-0">start_channel_link/0</a></li> <li title="start_channel_link-1"><a href="cosEventApp.html#start_channel_link-1">start_channel_link/1</a></li> <li title="stop_channel-1"><a href="cosEventApp.html#stop_channel-1">stop_channel/1</a></li> </ul> </li> <li title="CosEventChannelAdmin"><a href="CosEventChannelAdmin.html">CosEventChannelAdmin</a></li> <li id="no" title="CosEventChannelAdmin_ConsumerAdmin " expanded="false">CosEventChannelAdmin_ConsumerAdmin<ul> <li><a href="CosEventChannelAdmin_ConsumerAdmin.html"> Top of manual page </a></li> <li title="obtain_push_supplier-1"><a href="CosEventChannelAdmin_ConsumerAdmin.html#obtain_push_supplier-1">obtain_push_supplier/1</a></li> <li title="obtain_pull_supplier-1"><a href="CosEventChannelAdmin_ConsumerAdmin.html#obtain_pull_supplier-1">obtain_pull_supplier/1</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_SupplierAdmin " expanded="false">CosEventChannelAdmin_SupplierAdmin<ul> <li><a href="CosEventChannelAdmin_SupplierAdmin.html"> Top of manual page </a></li> <li title="obtain_push_consumer-1"><a href="CosEventChannelAdmin_SupplierAdmin.html#obtain_push_consumer-1">obtain_push_consumer/1</a></li> <li title="obtain_pull_consumer-1"><a href="CosEventChannelAdmin_SupplierAdmin.html#obtain_pull_consumer-1">obtain_pull_consumer/1</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_EventChannel " expanded="false">CosEventChannelAdmin_EventChannel<ul> <li><a href="CosEventChannelAdmin_EventChannel.html"> Top of manual page </a></li> <li title="for_consumers-1"><a href="CosEventChannelAdmin_EventChannel.html#for_consumers-1">for_consumers/1</a></li> <li title="for_suppliers-1"><a href="CosEventChannelAdmin_EventChannel.html#for_suppliers-1">for_suppliers/1</a></li> <li title="destroy-1"><a href="CosEventChannelAdmin_EventChannel.html#destroy-1">destroy/1</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_ProxyPullConsumer " expanded="false">CosEventChannelAdmin_ProxyPullConsumer<ul> <li><a href="CosEventChannelAdmin_ProxyPullConsumer.html"> Top of manual page </a></li> <li title="connect_pull_supplier-2"><a href="CosEventChannelAdmin_ProxyPullConsumer.html#connect_pull_supplier-2">connect_pull_supplier/2</a></li> <li title="disconnect_pull_consumer-1"><a href="CosEventChannelAdmin_ProxyPullConsumer.html#disconnect_pull_consumer-1">disconnect_pull_consumer/1</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_ProxyPushConsumer " expanded="false">CosEventChannelAdmin_ProxyPushConsumer<ul> <li><a href="CosEventChannelAdmin_ProxyPushConsumer.html"> Top of manual page </a></li> <li title="connect_push_supplier-2"><a href="CosEventChannelAdmin_ProxyPushConsumer.html#connect_push_supplier-2">connect_push_supplier/2</a></li> <li title="disconnect_push_consumer-1"><a href="CosEventChannelAdmin_ProxyPushConsumer.html#disconnect_push_consumer-1">disconnect_push_consumer/1</a></li> <li title="push-2"><a href="CosEventChannelAdmin_ProxyPushConsumer.html#push-2">push/2</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_ProxyPullSupplier " expanded="false">CosEventChannelAdmin_ProxyPullSupplier<ul> <li><a href="CosEventChannelAdmin_ProxyPullSupplier.html"> Top of manual page </a></li> <li title="connect_pull_consumer-2"><a href="CosEventChannelAdmin_ProxyPullSupplier.html#connect_pull_consumer-2">connect_pull_consumer/2</a></li> <li title="disconnect_pull_supplier-1"><a href="CosEventChannelAdmin_ProxyPullSupplier.html#disconnect_pull_supplier-1">disconnect_pull_supplier/1</a></li> <li title="pull-1"><a href="CosEventChannelAdmin_ProxyPullSupplier.html#pull-1">pull/1</a></li> <li title="try_pull-1"><a href="CosEventChannelAdmin_ProxyPullSupplier.html#try_pull-1">try_pull/1</a></li> </ul> </li> <li id="no" title="CosEventChannelAdmin_ProxyPushSupplier " expanded="false">CosEventChannelAdmin_ProxyPushSupplier<ul> <li><a href="CosEventChannelAdmin_ProxyPushSupplier.html"> Top of manual page </a></li> <li title="connect_push_consumer-2"><a href="CosEventChannelAdmin_ProxyPushSupplier.html#connect_push_consumer-2">connect_push_consumer/2</a></li> <li title="disconnect_push_supplier-1"><a href="CosEventChannelAdmin_ProxyPushSupplier.html#disconnect_push_supplier-1">disconnect_push_supplier/1</a></li> </ul> </li> </ul> </div></div> <div id="content"> <div class="innertube"> <!-- refpage --><center><h1>CosEventChannelAdmin</h1></center> <h3>MODULE</h3> <div class="REFBODY">CosEventChannelAdmin</div> <h3>MODULE SUMMARY</h3> <div class="REFBODY">The CosEventChannelAdmin defines a set if event service interfaces that enables decoupled asynchronous communication between objects and implements generic (untyped) version of the OMG COSS standard event service.</div> <h3>DESCRIPTION</h3> <div class="REFBODY"><p> <p>The event service defines two roles for objects: the supplier role and the consumer role. Suppliers supply event data to the event channel and consumers receive event data from the channel. Suppliers do not need to know the identity of the consumers, and vice versa. Consumers and suppliers are connected to the event channel via proxies, which are managed by ConsumerAdmin and SupplierAdmin objects.</p> <p>There are four general models of communication. These are: </p> <ul> <li>The canonical push model. It allows the suppliers of events to initiate the transfer of event data to consumers. Event channels play the role of <span class="code">Notifier</span>. Active suppliers use event channel to push data to passive consumers registered with the event channel.</li> <li>The canonical pull model. It allows consumers to request events from suppliers. Event channels play the role of <span class="code">Procure</span> since they procure events on behalf of consumers. Active consumers can explicitly pull data from passive suppliers via the event channels.</li> <li>The hybrid push/pull model. It allows consumers request events queued at a channel by suppliers. Event channels play the role of <span class="code">Queue</span>. Active consumers explicitly pull data deposited by active suppliers via the event channels.</li> <li>The hybrid pull/push model. It allows the channel to pull events from suppliers and push them to consumers. Event channels play the role of <span class="code">Intelligent agent</span>. Active event channels can pull data from passive suppliers to push it to passive consumers.</li> </ul> <p>To get access to all definitions, e.g., exceptions, include necessary <span class="code">hrl</span> files by using:<br><span class="code">-include_lib("cosEvent/include/*.hrl").</span></p> <p>There are seven different interfaces supported in the service:</p> <ul> <li>ProxyPushConsumer</li> <li>ProxyPullSupplier</li> <li>ProxyPullConsumer</li> <li>ProxyPushSupplier</li> <li>ConsumerAdmin</li> <li>SupplierAdmin</li> <li>EventChannel</li> </ul> </p></div> </div> <div class="footer"> <hr> <p>Copyright © 1999-2010 Ericsson AB. All Rights Reserved.</p> </div> </div> </div></body> </html>