CosEventChannelAdmin_ProxyPullConsumer

MODULE

CosEventChannelAdmin_ProxyPullConsumer

MODULE SUMMARY

This module implements a ProxyPullConsumer interface which acts as a middleman between pull supplier and the event channel.

DESCRIPTION

The ProxyPullConsumer interface defines the second step for connecting pull suppliers to the event channel. A proxy consumer is similar to a normal consumer, but includes an additional method for connecting a supplier to the proxy consumer.

There are a number of exceptions that can be returned from functions in this interface.

• AlreadyConnected is defined as -record('AlreadyConnected', {}).
• CORBA standard BAD_PARAM is defined as -record('BAD_PARAM', {'OE_ID', minor, completion_status}).

The first exception is defined in the file event_service.hrl and the second one in the file corba.hrl.

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

EXPORTS

connect_pull_supplier(Object, PullSupplier) -> Return

Types:
Object = #objref
PullSupplier = #objref of PullSupplier type
Return = void

This operation connects PullSupplier object to the ProxyPullConsumer object. If a nil object reference is passed CORBA standard BAD_PARAM exception is raised. If the ProxyPullConsumer is already connected to a PullSupplier, then the AlreadyConnected exception is raised.

disconnect_pull_consumer(Object) -> Return

Types:
Object = #objref
Return = void

This operation disconnects proxy pull consumer from the event channel and sends a notification about the loss of the connection to the pull supplier attached to it.

AUTHORS

Helen Airiyan - support@erlang.ericsson.se