About This Manual


This manual describes the Event Notification Service (ENS) architecture and APIs for iPlanet™ Messaging Server and Sun™ ONE Calendar Server. It gives detailed instructions on the ENS APIs that you can use to customize your server installation. Note that Sun ONE is the brand formerly known as iPlanet. Both Sun ONE and iPlanet are brands of Sun Microsystems, Inc. During a transition period both brands appear in this manual.

This preface contains the following sections:

• Who Should Read This Manual

• What You Need to Know

• How This Manual is Organized

• Conventions Used in This Manual

• Where to Find Related Information

Who Should Read This Manual

---

This manual is for programmers who want to customize applications in order to implement iPlanet Messaging Server and Sun ONE 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 Manual is Organized

---

This manual contains the following chapters and appendix:

• About This Manual (this chapter)

• Chapter 1 "Introduction to Event Notification Service"

  This chapter describes the 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 "Sun ONE Calendar Server Specific Information"

  This chapter describes the Sun ONE Calendar Server event notifications and provides sample Sun ONE 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 Sun ONE 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 manual, other documentation can be found at the following locations:

• iPlanet Messaging Server Documentation

  http://docs.sun.com/prod/s1msgsrv

• Sun ONE Calendar Server Documentation

  http://docs.sun.com/prod/s1.s1cals