Using the CORBA Notification Service

 

This document describes using the CORBA Notification Service in the BEA Tuxedo® product. This document defines concepts associated with using the Notification Service and describes the development process for CORBA applications. In addition, instructions for building and running the Notification sample applications and descriptions of the Notification Service application programming interface (API) and administrative tasks and tools are included in this document.

 

Overview

Introduction

Functional Overview

Product Components

 

CORBA Notification Service API Reference

Introduction

Quality of Service

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

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::add_constraints

CosNotifyFilter::Filter::destroy

CosNotifyFilter::FilterFactory::create_filter

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::
connect_structured_push_supplier

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
push_structured_event

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
disconnect_structured_push_consumer

CosNotifyChannelAdmin::StructuredProxyPushConsumer::MyType

CosNotifyChannelAdmin::ConsumerAdmin::
obtain_notification_push_supplier

CosNotifyChannelAdmin::ConsumerAdmin::get_proxy_supplier

CosNotifyChannelAdmin::SupplierAdmin::
obtain_notification_push_consumer

CosNotifyChannelAdmin::EventChannel::
ConsumerAdmin default_consumer_admin

CosNotifyChannelAdmin::EventChannel::
ConsumerAdmin default_supplier_admin

CosNotifyChannelAdmin::EventChannel::default_filter_factory

CosNotifyChannelAdmin::EventChannelFactory::get_event_channel

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

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

Starting the Introductory Sample Application

Using the Introductory Sample Application

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

Starting the Advanced Sample Application

Using the Advanced Sample Application

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

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