# 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.

### AUTHORS

support - support@erlang.ericsson.se

cosEvent 2.1
Copyright © 1991-2007 Ericsson AB