Previous Notification Service Configuration Next

NotificationSingleton Configuration

The Notification Singleton exists as a single object within a given instance of the Notification Service providing the core service functionality

Persistence Properties

Enable Write Ahead Log

When the write-ahead log is enabled, information that is normally written to the underlying database is written to a log file instead. When the log file reaches a specific size (defined by the Write Ahead Log Maximum Size property), the database is updated and the log file is reused. The location of the log file is defined by the Write Ahead Log Directory property.

The write-ahead log may increase performance when persistent events are required, particularly when events are being delivered quickly (when consumers are available and responding quickly).

The write-ahead log is enabled when this property is set TRUE (checked).

Property Name

DB.WAL

Property Type

FIXED

Data Type

BOOLEAN

Accessibility

READ/WRITE

Mandatory

NO

Write Ahead Log Directory

The directory used to contain write-ahead log files. This directory must be local to the host running the service. The default location is:

<INSTALL>/domains/<domain>/<node>/NotificationService/data

where <INSTALL> is the OpenFusion installation path. See The Object Hierarchy for details of the domains directory structure.

Property Name

DB.WAL.Dir

Property Type

FIXED

Data Type

DIRECTORY

Accessibility

READ/WRITE

Mandatory

YES

Write Ahead Log Maximum Size

The maximum number of entries that can be stored in the write-ahead log before flushing (writing to the underlying database) takes place.

Property Name

DB.WAL.MaxSize

Property Type

STATIC

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Database Plugin Class

This property is used when a database plugin is available to OpenFusion to enhance the event persistence mechanism. Leave this field blank when the plugin is not available.

Property Name

DB.Plugin

Property Type

STATIC

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

CORBA Properties

The General properties are useful for setting the start-up parameters of a Notification Service Singleton object. These properties are all static and mainly read -write. All these properties are optional, but can only be set prior to starting the Notification Service Singleton.

IOR Name Service Entry

The Naming Service entry for the Singleton.

Property Name

Object.Name

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

IOR URL

The IOR URL property specifies the location of an Interoperable Object Reference (IOR) for the Service, using the Universal Resource Locator (URL) format. This information is used when a client attempts to resolve a reference to the Service. Currently only http and file URLs are supported, for example:

file:/usr/users/openfusion/NotificationSingleton.ior
http://www.prismtechnologies.com/openfusion/NotificationSingleton.ior

Property Name

IOR.URL

Property Type

FIXED

Data Type

URL

Accessibility

READ/WRITE

Mandatory

NO

IOR File Name

The IOR File Name option specifies the name and location of the IOR file for the Singleton. If this property is not set, the IOR file name will be:

<INSTALL>/domains/<domain>/<node>/<service>/<singleton>/<singleton>.ior

where <INSTALL> is the OpenFusion installation path. See The Object Hierarchy for details of the domains directory structure.

Property Name

IOR.File

Property Type

FIXED

Data Type

FILE

Accessibility

READ/WRITE

Mandatory

NO

IOR Name Service

The name of the Naming Service which will be used to resolve the Singleton object.

Property Name

IOR.Server

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

Resolve Name

The ORB Service resolution name used to resolve calls to the Singleton.

Property Name

ResolveName

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

YES

Messaging Loggers

Service Log File Location

The location of the service log file. Each individual component logger (the scheduler logger, the transaction manager logger, and so on) writes to the same service log file. By default, this is the same log file used at the Service level.

The default location of the service log file is:

<INSTALL>/domains/OpenFusion/localhost/NotificationService/
log/NotificationService.log

Property Name

logkit/targets/file/filename

Property Type

FIXED

Data Type

FILE

Accessibility

READ/WRITE

Mandatory

NO

Service Log File Format

The format for entries in the service log file. The default format is:

%{priority} [%{category}] %{time:yyyy-MM-dd' 'HH:mm:ss.SSS}
%{message}\n%{throwable}

The same format is used by each component logger. This format overrides the format specified in the Log Pattern property at the Service level.

Property Name

logkit/targets/file/format

Property Type

FIXED

Data Type

STRING

Accessibility

READ/WRITE

Mandatory

NO

Set All Loggers To

Each component of the Notification Service (the scheduler, the transaction manager, and so on) has its own individual logger. For convenience, every component logger can be set to the same level using this property. Options are:

The default level is Set Individually.

For fine-grained control over logging, set this property to Set Individually. This allows each individual logger to be configured using the individual properties on this tab (described below).

Property Name

GlobalSetting

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Scheduler Logger Level

The logger level for the scheduler. Options are:

The default level is Warning.

Property Name

logcategory/scheduler

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Role Manager Logger Level

The logger level for the role manager. Options are:

The default level is Warning.

Property Name

logcategory/rolemanager

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

JTO Logger Level

The logger level for JTO. Options are:

The default level is Warning.

Property Name

logcategory/jto

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Messenger Logger Level

The logger level for the messenger. Options are:

The default level is Warning.

Property Name

logcategory/messenger

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Task Manager Logger Level

The logger level for the task manager. Options are:

The default level is Warning.

Property Name

logcategory/taskmanager

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

ORB Logger Level

The logger level for the ORB. Options are:

The default level is Warning.

Property Name

logcategory/orb

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Transaction Manager Logger Level

The logger level for the transaction manager. Options are:

The default level is Warning.

Property Name

logcategory/transactionmanager

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Blobstore Logger Level

The logger level for the blobstore. Options are:

The default level is Warning.

Logger level for the blobstore

Property Name

logcategory/blobstore

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

State Factory Logger Level

The logger level for the state factory. Options are:

The default level is Warning.

Property Name

logcategory/statefactory

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

State Machine Factory Logger Level

The logger level for the state machine factory. Options are:

The default level is Warning.

Property Name

logcategory/statemachinefactory

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Thread Pool Logger Level

The logger level for the thread pool. Options are:

The default level is Warning.

Property Name

logcategory/threadpool

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Notification Service Logger Level

The logger level for the event channel factory (which is the root object of the Notification Service). Options are:

The default level is Warning.

Property Name

logcategory/ecfc

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Component Manager Logger Level

The logger level for the component manager. Options are:

The default level is Warning.

Property Name

logcategory/ecm

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Lock Set Factory Logger Level

The logger level for the lock set factory. Options are:

The default level is Warning.

Property Name

logcategory/locksetfactory

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Instrumentation Properties

The interfaces for setting the instrumentation properties are given below. For information on managing instrumentation, please refer to the System Guide.


Instrumentation is not implemented in the initial version 4 release. These properties appear in the Administration Manager but are all locked (disabled). They are described here for completeness.

Structured Push Events Received

This property monitors the total number of structured push events received by the Notification Service during execution of the service. In other words, the count of events sent by push suppliers via proxy push consumers.

Property Name

StructuredPushEventsReceived

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Structured Proxy Push Consumers

This property monitors the current number of structured proxy push consumers in existence on the service.

Property Name

StructuredProxyPushConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Sequence Proxy Push Consumers

This property monitors the current number of sequence proxy push consumers in existence on the service.

Property Name

SequenceProxyPushConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Structured Push Events Delivered

This property monitors the total number of structured push events delivered by the Notification Service during execution of the service. In other words, the count of events received by push consumers via proxy push suppliers.

Property Name

StructuredPushEventsDelivered

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Consumer Admins

This property monitors the current number of consumer admins in existence on the service.

Property Name

ConsumerAdmins

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Structured Proxy Pull Suppliers

This property monitors the current number of structured proxy pull supplier objects in existence on the service.

Property Name

StructuredProxyPullSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Sequence Proxy Pull Suppliers

This property monitors the current number of sequence proxy pull supplier objects in existence on the service.

Property Name

SequenceProxyPullSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Current Total of Events in Channels

This property monitors the total number of events in channels.

Property Name

CurrentEvents

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Current Total of Events Awaiting Delivery

This property monitors the total number of events awaiting delivery. This count gives the current load on the Service.

This figure is calculated as follows:

Events in queues + (Events in channel * Number of proxies)

Where:

Number of Structured Proxy Push Suppliers

This property monitors the current number of structured proxy push supplier objects in existence on the service.

Property Name

StructuredProxyPushSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Sequence Proxy Push Suppliers

This property monitors the current number of sequence proxy push supplier objects in existence on the service.

Property Name

SequenceProxyPushSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Supplier Admins

This property monitors the current number of Typed Supplier Admins in existence on the service.

Property Name

TypedSupplierAdmins

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Reconnecting Consumers

This property monitors the current number of unavailable push consumer objects in existence on the service.

Property Name

ReconnectingConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Reconnecting Suppliers

This property monitors the current number of unavailable pull supplier objects in existence on the service.

Property Name

ReconnectingSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Supplier Admins

This property monitors the current number of Supplier Admin objects in existence on the service.

Property Name

SupplierAdmins

Property Type

DYNAMC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Proxy Pull Consumers

This property monitors the current number of Typed Proxy Pull Consumer objects in existence on the service.

Property Name

TypedProxyPullConsumers

Property Type

DYNAMCI

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Proxy Push Consumers

This property monitors the current number of Typed Proxy Push Consumer objects in existence on the service.

Property Name

TypedProxyPushConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Proxie Pull Suppliers

This property monitors the current number of Typed Proxy Pull Supplier objects in existence on the service.

Property Name

TypedProxyPullSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Consumer Admins

This property monitors the current number of Typed Consumer Admins in existence on the service.

Property Name

TypedConsumerAdmins

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Delivery Queue Threshold

This property sets the threshold over which delivery queues will raise alarms. The threshold should be expressed as a percentage of the queue's maximum size. So to raise an alarm when a queue is three-quarters full, enter 75.

When this threshold is reached, a DeliveryQueueAlarm event containing the ID of the relevant queue is sent.

Property Name

DeliveryQueueThreshold

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ/WRITE

Mandatory

NO

Number of Typed Proxy Push Suppliers

This property monitors the current number of Typed Proxy Push Supplier objects in existence on the service.

Property Name

TypedProxyPushSuppliers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Event Channels

This property monitors the current number of Event Channel objects in existence on the service.

Property Name

Channels

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Typed Event Channels

This property monitors the current number of Typed Event Channel objects in existence on the service.

Property Name

TypedChannels

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Structured Proxy Push Consumers

This property monitors the current number of Structured Proxy Push Consumer objects in existence on the service.

Property Name

StructuredProxyPushConsumers

Property Type

Dynamic

Data Type

Counter

Accessibility

Read Only

Mandatory

NO

Number of Sequence Proxy Pull Consumers

This property monitors the current number of Sequence Proxy Pull Consumer objects in existence on the service.

Property Name

SequenceProxyPullConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

Number of Structured Proxy Pull Consumers

This property monitors the current number of Structured Proxy Pull Consumer objects in existence on the service.

Property Name

StructuredProxyPullConsumers

Property Type

DYNAMIC

Data Type

COUNTER

Accessibility

READ ONLY

Mandatory

NO

General Properties

Maximum Queue Size

The maximum queue size of the event delivery manager. When the maximum queue size is exceeded, events are removed from the queue, oldest first, if the EventReliability QoS is set to BestEffort. In the case of Persistent, the events are stored and re-sent when appropriate.

Property Name

MaxQueueSize

Property Type

STATIC

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Messaging

Lock Set Factory: Fairness Policy

The fairness policy for the lock set factory. Options are:


Although JVM is shown as an option, it is not implemented in the initial version 4 release. FIFO will be be used, regardless of which option is selected for this property.

Property Name

components/LockSetFactory/fairness

Property Type

FIXED

Data Type

ENUM

Accessibility

READ/WRITE

Mandatory

NO

Task Manager: Period

The frequency with which the task manager reschedules tasks, expressed in milliseconds. The default is 1000 milliseconds (1 second).

Property Name

components/TaskManager/period

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Task Manager: Maximum Activity

This property specifies the number of tasks that the task manager will attempt to keep running at any point in time. This acts as a "soft" limit on thread resource usage. The default number is 10.

Property Name

components/TaskManager/maxactivity

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Task Manager: Priority

The priority for the task manager's own thread. This must be in the range 1 - 10. The default value is 6.

Property Name

components/TaskManager/priority

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Thread Pool: Minimum Pool Size

The minimum pool size for the thread pool. The default is 0 (zero).

Property Name

components/ThreadPool/pool-min

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Thread Pool: Maximum Pool Size

The maximum size of the thread pool. The default is 20.

Property Name

components/ThreadPool/pool-max

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Thread Pool: Initial Pool Size

The initial size for the thread pool. The default is 0 (zero).

Property Name

components/ThreadPool/pool-initial

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Thread Pool: Thread Timeout

How long, in milliseconds, an idle thread remains in the pool before being discarded. This controls how long an The default timeout is 1000 milliseconds (1 second).

Property Name

components/ThreadPool/thread-timeout

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO

Transaction Manager: Domain Timeout

The maximum time allowed before a transaction times out, in milliseconds. The default timeout is 60000 milliseconds (60 seconds).

Property Name

components/TransactionManager/domain/
timeout

Property Type

FIXED

Data Type

INTEGER

Accessibility

READ/WRITE

Mandatory

NO



Previous Notification Service Configuration Next