Sun logo      Copyright      Index      Next     

Sun Java System Communications Services 6 2005Q1 Event Notification Service Guide

Contents


List of Tables

Preface
Who Should Use This Book
Before You Read This Book
How This Book Is Organized
Conventions Used in This Book
Typographic Conventions
Symbols
Default Paths and File Names
Command Line Prompts
Related Documentation
Messaging Server Documents
Calendar Server Documents
Communications Services Documents
Where to Find This Manual Online
Accessing Sun Resources Online
Contacting Sun Technical Support
Related Third-Party Web Site References
Sun Welcomes Your Comments

Chapter 1   Introduction to Event Notification Service
Event Notification Service Overview
ENS in Calendar Server
ENS in Messaging Server
Event References
ENS Connection Pooling
Event Notification Service Architecture
Notify
Subscribe
Unsubscribe
How Calendar Server Interacts with ENS
How Messaging Server Interacts with ENS
Event Notification Service API Overview
ENS C API Overview
ENS Java API Overview
Building and Running Custom Applications

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
Instructions for Sample Programs
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   Messaging Server Specific Information
Event Notification Types and Parameters
Parameters
Payload
Examples
Sample Code
Sample Publisher
Sample Subscriber
Implementation Notes

Chapter 5   Calendar Server Specific Information
Calendar Server Notifications
Alarm Notifications
Calendar Update Notifications
Advanced Topics
WCAP appid parameter and X-Tokens
ENS Sample Code for Calendar Server
Sample Publisher and Subscriber
Reliable Publisher and Subscriber

Appendix A   Debugging ENS
Environment Variables
GAP_DEBUG
GAP_LOG_MODULES
GAP_LOGFILE
XENP_TRACE
ENS_DEBUG
ENS_LOG_MODULES
ENS_LOGFILE
ENS_STATS
SERVICEBUS_DEBUG
How to Enable Debug Tracing
Sample Debugging Sessions
Example 1: For Messaging Server
Example 2: For Messaging Server

Glossary

Index


Copyright      Index      Next     


Copyright 2005 Sun Microsystems, Inc. All rights reserved.