CosNotifyChannelAdmin_EventChannel.3erl - Man Page
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.