NAME

       CosEventChannelAdmin_EventChannel  -  This  module  implements an Event Channel interface,
       which plays the role of a  mediator between consumers and suppliers.

DESCRIPTION

       An event channel is an object that allows multiple suppliers to communicate with  multiple
       consumers  in  a  highly  decoupled,  asynchronous  manner.  The event channel is built up
       incrementally. When an event channel is created no suppliers or consumers are connected to
       it.  Event  Channel  can  implement  group  communication  by  serving  as  a  replicator,
       broadcaster, or multicaster that forward events from one or  more  suppliers  to  multiple
       consumers.

       It  is up to the user to decide when an event channel is created and how references to the
       event channel are obtained. By representing the event channel as an object, it has all  of
       the properties that apply to objects. One way to manage an event channel is to register it
       in a naming context, or export it through an operation on an object.

       To get access to all definitions include necessary hrl files by using:
       -include_lib("cosEvent/include/*.hrl").

       Any object  that  possesses  an  object  reference  that  supports  the  ProxyPullConsumer
       interface can perform the following operations:

EXPORTS

       for_consumers(Object) -> Return

              Types:

                 Object = #objref
                 Return = #objref

              This  operation  returns  a ConsumerAdmin object reference. If ConsumerAdmin object
              does not exist already it creates one.

       for_suppliers(Object) -> Return

              Types:

                 Object = #objref
                 Return = #objref

              This operation returns a SupplierAdmin object reference.  If  SupplierAdmin  object
              does not exist already it creates one.

       destroy(Object) -> Return

              Types:

                 Object = #objref
                 Return = #objref