org.omg.DsTypedEventLogAdmin
Interface TypedEventLogFactoryOperations

All Superinterfaces:

ConsumerAdminOperations, LogMgrOperations

All Known Subinterfaces:

TypedEventLogFactory

public interface TypedEventLogFactoryOperations
extends LogMgrOperations, ConsumerAdminOperations

TypedEventLogFactory provides the following additional functions:

• Create TypedEventLog.
• Create TypedEventLog with id.
• Emit log creation events and forward log generated events as untyped events.

Method Summary

TypedEventLog	create_with_id(int id, short full_action, long max_size, short[] thresholds) Create TypedEventLog with id.
TypedEventLog	create(short full_action, long max_size, short[] thresholds, IntHolder id) Create TypedEventLog.

Methods inherited from interface org.omg.DsLogAdmin.LogMgrOperations

find_log, list_logs_by_id, list_logs

Methods inherited from interface org.omg.CosEventChannelAdmin.ConsumerAdminOperations

obtain_pull_supplier, obtain_push_supplier

Method Detail

create_with_id

TypedEventLog create_with_id(int id,
                             short full_action,
                             long max_size,
                             short[] thresholds)
                             throws LogIdAlreadyExists,
                                    InvalidLogFullAction,
                                    InvalidThreshold

Create TypedEventLog with id. An ObjectCreation event is generated whenever a log is created.

Parameters:

id - The id of the log.

full_action - The action that will be taken when the maximum size of the log has been reached.

max_size - The size of the log measured in number of bytes.

thresholds - A sequence of value that specifies, as a percentage of max log size, the points at which a ThresholdAlarm event will be generated.

Returns:

the reference to the created TypedEventLog.

Throws:

DsLogAdmin::LogIdAlreadyExists - if this log id exists within the scope of the log factory

org.omg.DsLogAdmin::InvalidLogFullAction - raised if the full_action specified is not valid.

org.omg.DsLogAdmin::InvalidThreshold - if the threshold list passed to the operation contains invalid values.

LogIdAlreadyExists

InvalidLogFullAction

InvalidThreshold

create

TypedEventLog create(short full_action,
                     long max_size,
                     short[] thresholds,
                     IntHolder id)
                     throws InvalidLogFullAction,
                            InvalidThreshold

Create TypedEventLog. An ObjectCreation event is generated whenever a log is created.

Parameters:

full_action - The action that will be taken when the maximum size of the log has been reached.

max_size - The size of the log measured in number of bytes.

thresholds - A sequence of value that specifies, as a percentage of max log size, the points at which a ThresholdAlarm event will be generated.

id - The id of a log. Log objects are created by a log factory and each log is assigned an id that uniquely identifies the log object within the factory.

Returns:

the reference to the created TypedEventLog.

Throws:

org.omg.DsLogAdmin::InvalidLogFullAction - raised if the full_action specified is not valid

org.omg.DsLogAdmin::InvalidThreshold - if the threshold list passed to the operation contains invalid values.

InvalidLogFullAction

InvalidThreshold