User's Guide
Reference Manual
Release Notes
PDF
Top

cosNotification
Reference Manual
Version 1.1.12

Expand All
Contract All

Table of Contents

# CosNotifyChannelAdmin_EventChannel

### MODULE

CosNotifyChannelAdmin_EventChannel

### MODULE SUMMARY

This module implements the OMG CosNotifyChannelAdmin::EventChannel interface.

### DESCRIPTION

To get access to the record definitions for the structures use:
-include_lib("cosNotification/include/*.hrl").

This module also exports the functions described in:

- CosNotification_QoSAdmin

- CosNotification_AdminPropertiesAdmin

### EXPORTS

_get_MyFactory(Channel) -> ChannelFactory

Types:

Channel = #objref
ChannelFactory = #objref

This readonly attribute maintains the reference of the event channel factory that created the target channel.

_get_default_consumer_admin(Channel) -> ConsumerAdmin

Types:

Channel = #objref
ConsumerAdmin = #objref

This is a readonly attribute which maintains a reference to a default ConsumerAdmin object associated with the target object.

_get_default_supplier_admin(Channel) -> SupplierAdmin

Types:

Channel = #objref
SupplierAdmin = #objref

This is a readonly attribute which maintains a reference to a default SupplierAdmin object associated with the target object.

_get_default_filter_factory(Channel) -> FilterFactory

Types:

Channel = #objref
FilterFactory = #objref

The default FilterFactory associated with the target channel is maintained by this readonly attribute.

new_for_consumers(Channel, OpType) -> Return

Types:

Channel = #objref
OpType = 'AND_OP' | 'OR_OP'
Return = {ConsumerAdmin, AdminID}
ConsumerAdmin = #objref
AdminID = long()

This operation creates a new instance of a ConsumerAdmin and supplies an Id which may be used when invoking other operations exported by this module. The returned object will inherit the Quality of Service properties of the target channel.

for_consumers(Channel) -> ConsumerAdmin

Types:

Channel = #objref
ConsumerAdmin = #objref

A new new instance of a ConsumerAdmin object is created but no Id is returned. The returned object's operation type, i.e., 'AND_OP' or 'OR_OP', will be set to the value of the configuration parameter filterOp. The target object's Quality of Service properties will be inherited by the returned ConsumerAdmin.

new_for_suppliers(Channel, OpType) -> Return

Types:

Channel = #objref
OpType = 'AND_OP' | 'OR_OP'
Return = {SupplierAdmin, AdminID}
SupplierAdmin = #objref
AdminID = long()

Enables us to create a new instance of a SupplierAdmin. An Id, which may be used when invoking other operations exported by this module, is also returned. The current Quality of Service settings associated with the target object will be inherited by the SupplierAdmin.

for_suppliers(Channel) -> SupplierAdmin

Types:

Channel = #objref
SupplierAdmin = #objref

To create a new SupplierAdmin with the target object's current Quality of Service settings we can use this function. The returned object's operation type ('AND_OP' or 'OR_OP') will be determined by the configuration variable filterOp.

get_consumeradmin(Channel, AdminID) -> ConsumerAdmin

Types:

Channel = #objref
AdminID = long()
ConsumerAdmin = #objref | {'EXCEPTION', #'CosNotifyChannelAdmin_AdminNotFound'{}}

If the given Id is associated with a ConsumerAdmin the object reference is returned. If such association never existed or the ConsumerAdmin have terminated an exception is raised.

get_supplieradmin(Channel, AdminID) -> SupplierAdmin

Types:

Channel = #objref
AdminID = long()
SupplierAdmin = #objref | {'EXCEPTION', #'CosNotifyChannelAdmin_AdminNotFound'{}}

Equal to the operation get_consumeradmin/2 but a reference to a SupplierAdmin is returned.

get_all_consumeradmins(Channel) -> Reply

Types:

Channel = #objref
Reply = [AdminID]
AdminID = long()

To get access to all ConsumerAdmin Id's created by the target object, and still alive, this operation could be invoked.

get_all_supplieradmins(Channel) -> Reply

Types:

Channel = #objref
Reply = [AdminID]
AdminID = long()

Equal to the operation get_all_consumeradmins/1 but returns a list of all SupplierAdmin object ID's.

destroy(Channel) -> ok

Types:

Channel = #objref

The destroy operation will terminate the target channel and all associated Admin objects.