User's Guide
Reference Manual
Release Notes
PDF
Top

cosEvent
Reference Manual
Version 2.2

Expand All
Contract All

Table of Contents

- cosEventApp
  - Top of manual page
  - install/0
  - uninstall/0
  - start/0
  - stop/0
  - start_channel/0
  - start_channel/1
  - start_channel_link/0
  - start_channel_link/1
  - stop_channel/1
- CosEventChannelAdmin
- CosEventChannelAdmin_ConsumerAdmin
  - Top of manual page
  - obtain_push_supplier/1
  - obtain_pull_supplier/1
- CosEventChannelAdmin_SupplierAdmin
  - Top of manual page
  - obtain_push_consumer/1
  - obtain_pull_consumer/1
- CosEventChannelAdmin_EventChannel
  - Top of manual page
  - for_consumers/1
  - for_suppliers/1
  - destroy/1
- CosEventChannelAdmin_ProxyPullConsumer
  - Top of manual page
  - connect_pull_supplier/2
  - disconnect_pull_consumer/1
- CosEventChannelAdmin_ProxyPushConsumer
  - Top of manual page
  - connect_push_supplier/2
  - disconnect_push_consumer/1
  - push/2
- CosEventChannelAdmin_ProxyPullSupplier
  - Top of manual page
  - connect_pull_consumer/2
  - disconnect_pull_supplier/1
  - pull/1
  - try_pull/1
- CosEventChannelAdmin_ProxyPushSupplier
  - Top of manual page
  - connect_push_consumer/2
  - disconnect_push_supplier/1

# cosEventApp

### MODULE

cosEventApp

### MODULE SUMMARY

The main module of the cosEvent application.

### DESCRIPTION

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

This module contains the functions for starting and stopping the application.

### EXPORTS

install() -> Return

Types:

Return = ok | {'EXCEPTION', E} | {'EXIT', R}

This operation installs the cosEvent application.

uninstall() -> Return

Types:

Return = ok | {'EXCEPTION', E} | {'EXIT', R}

This operation uninstalls the cosEvent application.

start() -> Return

Types:

Return = ok | {error, Reason}

This operation starts the cosEvent application.

stop() -> Return

Types:

Return = ok | {error, Reason}

This operation stops the cosEvent application.

start_channel() -> Channel

Types:

Channel = #objref

This operation creates a new instance of a Event Channel using the default settings.

start_channel(Options) -> Channel

Types:

Options = [Option]
Option = {pull_interval, Seconds} | {typecheck, Boolean} | {maxEvents, Integer} | {blocking, Boolean}
Channel = #objref

This operation creates a new instance of a Event Channel

- {pull_interval, Seconds} - determine how often Proxy Pull Consumers will check for new events with the client application. The default value is 20 seconds.
- {typecheck, Boolean} - if this option is set to true the proxies will check if the supplied client object is of correct type. The default value is false.
- {maxEvents, Integer} - this option determine how many events the ProxyPullSuppliers will store before discarding events. If the limit is reached events will be discarded in any order. The default value is 300.
- {blocking, Boolean} - this option determine the behavior of the channel when handling events internally. If set to true the risk of a single event supplier floods the system is reduced, but the performance may also be reduced. The default value is true.

start_channel_link() -> Channel

Types:

Channel = #objref

This operation creates a new instance of a Event Channel, which is linked to the invoking process, using the default settings.

start_channel_link(Options) -> Channel

Types:

Options = [Option]
Option = {pull_interval, Seconds} | {typecheck, Boolean} | {maxEvents, Integer} | {blocking, Boolean}
Channel = #objref

This operation creates a new instance of a Event Channel, which is linked to the invoking process, with settings defined by the given options. Allowed options are the same as for cosEventApp:start_channel/1.

stop_channel(Channel) -> Reply

Types:

Channel = #objref
Reply = ok | {'EXCEPTION', E}

This operation stop the target event channel.