Contents


About This Guide

Who Should Read This Book
What You Need to Know
How This Book is Organized
Conventions Used in This Manual
Where to Find Related Information

Chapter 1 Introduction to Event Notification Service

Event Notification Service Overview

ENS in iPlanet Calendar Server
ENS in iPlanet Messaging Server
Event References

iPlanet Calendar Server Event Reference Example
iPlanet Messaging Server Event Reference Example

ENS Connection Pooling

Multiple Pool Extension

Event Notification Service Architecture

Notify
Subscribe
Unsubscribe
How iPlanet Calendar Server Interacts with ENS

iPlanet Calendar Server Alarm Queue
iPlanet Calendar Server Daemons
Alarm Transfer Reliability
iPlanet Calendar Server Example

How iPlanet Messaging Server Interacts with ENS

Event Notification Service API Overview

ENS C API Overview
ENS Java API Overview
Building and Running Custom Applications

Location of Sample Code
Location of Include Files
Dynamically Linked/Shared Libraries
Runtime Library Path Variable

Chapter 2 Event Notification Service C API Reference

Publisher API Functions List
Subscriber API Functions List
Publish and Subscribe Dispatcher Functions List
Publisher API

publisher_t
publisher_cb_t
publisher_new_a
publisher_new_s
publish_a
publish_s
publisher_delete
publisher_get_subscriber
renl_create_publisher
renl_cancel_publisher

Subscriber API

subscriber_t
subscription_t
subscriber_cb_t
subscriber_notify_cb_t
subscriber_new_a
subscriber_new_s
subscribe_a
unsubscribe_a
subscriber_delete
subscriber_get_publisher
renl_create_subscriber
renl_cancel_subscriber

Publish and Subscribe Dispatcher API

pas_dispatcher_t
pas_dispatcher_new
pas_dispatcher_delete
pas_dispatch
pas_shutdown

Chapter 3 Event Notification Service Java (JMS) API Reference

Event Notification Service Java (JMS) API Implementation

Prerequisites to Use the Java API
Sample Java Programs
Setting Up Your Environment
To Compile the JmsSample Program
To Compile the JBiff Program
To Run the JmsSample Program
To Run the JBiff Demo Program

Java (JMS) API Overview

New Proprietary Methods
com.iplanet.ens.jms.EnsTopicConnFactory
com.iplanet.ens.jms.EnsTopic

Implementation Notes

Shortcomings of the Current Implementation
Notification Delivery
JMS Headers
Miscellaneous

Chapter 4 iPlanet Calendar Server Specific Information

iPlanet Calendar Server Notifications

Format of Calendar Notifications

iPlanet Calendar Server Sample Code

Sample Publisher and Subscriber

Publisher Code Sample
Subscriber Code Sample

Reliable Publisher and Subscriber

Reliable Publisher Sample
Reliable Subscriber Sample

Chapter 5 iPlanet Messaging Server Specific Information

iPlanet Messaging Server Events and Parameters

Parameters
Payload
Examples

iPlanet Messaging Server Sample Code

Sample Publisher
Sample Subscriber

Implementation Notes

Glossary

Index