About This Guide


This manual describes the iPlanet™ Event Notification Service (ENS) architecture and APIs for iPlanet™ Messaging Server and iPlanet™ Calendar Server. It gives detailed instructions on the ENS APIs that you can use to customize your server installation.

This preface contains the following sections:

• 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

Who Should Read This Book

---

This manual is for programmers who want to customize applications in order to implement iPlanet Messaging Server and iPlanet Calendar Server.

What You Need to Know

---

This book assumes that you are a programmer with a knowledge of C/C++ and Java Messaging Service, and that you have a general understanding of the following:

• The Internet and the World Wide Web

• Messaging and calendaring concepts

How This Book is Organized

---

This book contains the following chapters and appendix:

• About This Guide (this chapter)

• Chapter 1 "Introduction to Event Notification Service"

  This chapter describes the iPlanet Event Notification Service (ENS) components, architecture, and Application Programming Interfaces (APIs).

• Chapter 2 "Event Notification Service C API Reference"

  This chapter describes the ENS C API.

• Chapter 3 "Event Notification Service Java (JMS) API Reference"

  This chapter describes the ENS Java API and provides sample code.

• Chapter 4 "iPlanet Calendar Server Specific Information"

  This chapter describes the iPlanet Calendar Server event notifications and provides sample iPlanet Calendar Server code.

• Chapter 5 "iPlanet Messaging Server Specific Information"

  This chapter describes the iPlanet Messaging Server event references and provides sample iPlanet Messaging Server code.

• "Glossary"

Conventions Used in This Manual

---

Monospaced font - This typeface is used for any text that appears on the computer screen. It is also used for filenames, distinguished names, functions, and examples.

Italicized font - This is used to represent text that you enter using information that is unique to your installation (for example, variables). It is used for server paths and names and account IDs.

All paths specified in this manual are in UNIX format. If you are using a Windows NT-based iPlanet Messaging Server or iPlanet Calendar Server, you should assume the Windows NT equivalent file paths whenever UNIX file paths are shown in this book.

Where to Find Related Information

---

In addition to this guide, these other documents are available:

• iPlanet Messaging Server Documentation

  http://docs.iplanet.com/docs/manuals/messaging.html

• iPlanet Calendar Server Documentation

  http://docs.iplanet.com/docs/manuals/calendar.html