Using the CORBA Notification Service

Overview

Introduction

Functional Overview

Product Components

CORBA Notification Service API Reference

Introduction

Quality of Service

Persistent Subscriptions

Transient Subscriptions

Obtaining the Channel Factory

Using Transactions

Structured Event Fields, Types, and Filters

Designing Events

Creating FML Field Table Files for Events

Interoperability with BEA Tuxedo Applications

Posting Events

Receiving Events

Parameters Used When Creating Subscriptions

BEA Simple Events API

TOBJ_SimpleEvents::Channel Interface

Channel::subscribe

Channel::unsubscribe

Channel::push_structured_event

Channel::exists

TOBJ_SimpleEvents::ChannelFactory Interface

Channel_Factory::find_channel

CosNotification Service API

Overview of Supported CosNotification Service Classes

Detailed Descriptions of CosNotification Service Classes

CosNotifyFilter::Filter Class

CosNotifyFilter::Filter::add_constraints

CosNotifyFilter::Filter::destroy

CosNotifyFilter::FilterFactory Class

CosNotifyFilter::FilterFactory::create_filter

CosNotifyChannelAdmin::StructuredProxyPushSupplier Class

CosNotifyChannelAdmin::StructuredProxyPushSupplier:: connect_structured_push_consumer

CosNotifyChannelAdmin::StructuredProxyPushSupplier::set_qos

CosNotifyChannelAdmin::StructuredProxyPushSupplier::add_filter

CosNotifyChannelAdmin::StructuredProxyPushSupplier::get_filter

CosNotifyChannelAdmin::StructuredProxyPushSupplier:: disconnect_structured_push_supplier

CosNotifyChannelAdmin::StructuredProxyPushSupplier::MyType

CosNotifyChannelAdmin::StructuredProxyPushConsumer Class

CosNotifyChannelAdmin::StructuredProxyPushConsumer:: connect_structured_push_supplier

CosNotifyChannelAdmin::StructuredProxyPushConsumer:: push_structured_event

CosNotifyChannelAdmin::StructuredProxyPushConsumer:: disconnect_structured_push_consumer

CosNotifyChannelAdmin::StructuredProxyPushConsumer::MyType

CosNotifyChannelAdmin::ConsumerAdmin Class

CosNotifyChannelAdmin::ConsumerAdmin:: obtain_notification_push_supplier

CosNotifyChannelAdmin::ConsumerAdmin::get_proxy_supplier

CosNotifyChannelAdmin::SupplierAdmin Class

CosNotifyChannelAdmin::SupplierAdmin:: obtain_notification_push_consumer

CosNotifyChannelAdmin::EventChannel Class

CosNotifyChannelAdmin::EventChannel:: ConsumerAdmin default_consumer_admin

CosNotifyChannelAdmin::EventChannel:: ConsumerAdmin default_supplier_admin

CosNotifyChannelAdmin::EventChannel::default_filter_factory

CosNotifyChannelAdmin::EventChannelFactory Class

CosNotifyChannelAdmin::EventChannelFactory::get_event_channel

CosNotifyComm::StructuredPushConsumer Interface

CosNotifyComm::StructuredPushConsumer::push_structured_event

CosNotifyComm::StructuredPushConsumer:: disconnect_structured_push_consumer

CosNotifyComm::StructuredPushConsumer::Offer_change

Exception Minor Codes

Using the BEA Simple Events API

Development Process

Designing Events

Step 1: Writing an Application to Post Events

Getting the Event Channel

Creating and Posting Events

Step 2: Writing an Application to Subscribe to Events

Implementing the CosNotifyComm::StructuredPushConsumer Interface

Getting the Event Channel

Creating a Callback Object

Creating a Subscription

Threading Considerations for C++ Joint Client/Server Applications

Step 3: Compiling and Running Notification Service Applications

Generating the Client Stub and Skeleton Files

Building and Running Applications

Using the CosNotification Service API

Development Process

Designing Events

Step 1: Writing an Application to Post Events

Getting the Event Channel

Creating and Posting Events

Step 2: Writing an Application to Subscribe to Events

Implementing the CosNotifyComm::StructuredPushConsumer Interface

Getting the Event Channel, ConsumerAdmin Object, and Filter Factory Object

Creating a Callback Object

Creating a Subscription

Step 3: Compiling and Running Notification Service Applications

Generating the Client Stub and Skeleton Files

Compiling and Linking the Application Code

Building the Introductory Sample Application

Overview

Building and Running the Introductory Sample Application

Verifying the Settings of the Environment Variables

Copying the Files for the Introductory Sample Application into a Work Directory

Changing the Protection Attribute on the Files for the Introductory Sample Application

Setting Up the Environment

Building the Introductory Sample Application

Makefile Summary

Executing the Makefile

Starting the Introductory Sample Application

Using the Introductory Sample Application

Using the Subscriber Application to Subscribe to Events

Using the Reporter Application to Post Events

Shutting Down the System and Cleaning Up the Directory

Building the Advanced Sample Application

Overview

Building and Running the Advanced Sample Application

Verifying the Settings of the Environment Variables

Copying the Files for the Advanced Sample Application into a Work Directory

Changing the Protection Attribute on the Files for the Advanced Sample Application

Setting Up the Environment

Building the Advanced Sample Application

Makefile Summary

Executing the Makefile

Starting the Advanced Sample Application

Using the Advanced Sample Application

Using the Subscriber Application to Subscribe to Events

Using the Reporter Application to Post Events

Shutting Down the System and Cleaning Up the Directory

CORBA Notification Service Administration

Introduction

Configuring the Notification Service

Configuring Data Filters

Setting the Host and Port

Creating a Transaction Log

Creating Event Queues

Determining Space Parameters for Transient and Persistent Subscriptions

IPC Queue Space for Transient Subscriptions

/Q Queue Size Parameter Persistent Subscriptions

Creating a Device on Disk for the Queue Space

Configuring a Queue Space

Creating the Queues

Setting IPC Parameters on Microsoft Windows

Creating the UBBCONFIG File and the TUXCONFIG File

Managing the Notification Service

Synchronizing Databases

Purging the System of Dead Subscriptions

Monitoring Queue Utilization

Purging the Queues of Unwanted Events

Managing the Error Queue

Notification Service Administration Utility and Commands

ntsadmin Utility

ntsadmin

ntsadmin Commands

Using the ntsadmin Utility

Notification Servers

TMNTS

TMNTSFWD_T

TMNTSFWD_P