Sun Java System Communications Services 6 2004Q2 Event Notification Service Guide |
About This Manual
This manual describes the Event Notification Service (ENS) architecture and APIs for Sun Java System Messaging Server and Sun Java System Calendar Server. It gives detailed instructions on the ENS APIs that you can use to customize your server installation.
Topics covered in this chapter include:
Who Should Read This ManualThis manual is for programmers who want to customize applications in order to implement Messaging Server and Calendar Server.
What You Need to KnowThis 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:
How This Manual is OrganizedThis manual contains the following chapters and appendix:
Document ConventionsMonospaced Font
Monospaced font is used for any text that appears on the computer screen or text that you should type. It is also used for filenames, distinguished names, functions, and examples.
Bold Monospaced Font
Bold monospaced font is used to represent text within a code example that you should type. For example, you might see something like this:
./installer
In this example, ./installer is what you would type at the command line.
Italicized Font
Italicized font 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.
For example, throughout this document you will see path references of the form:
msg_svr_base/...
The Messaging Server Base (msg_svr_base) represents the directory path in which you install the server. The default value of the msg_svr_base is /opt/SUNWmsgsr.
The Calendar Server Base (cal_svr_base) represents the directory path in which you install the server. The default value of the cal_svr_base is /opt/SUNWics5.
Square or Straight Brackets
Square (or straight) brackets [] are used to enclose optional parameters.
Command Line Prompts
Command line prompts (for example, % for a C-Shell, or $ for a Korn or Bourne shell) are not displayed in the examples. Depending on which operating system you are using, you will see a variety of different command line prompts. However, you should enter the command as it appears in the document unless specifically noted otherwise.
Platform-specific Syntax
All paths specified in this manual are in UNIX format. If you are using Windows 2000-based Communications Services, you should assume the Windows 2000 equivalent file paths whenever UNIX file paths are shown in this book.
Where to Find Related InformationIn addition to this manual, Communications Services products come with supplementary information for administrators, end users, and developers.
Messaging Server Documents
Use the following URL to see all the Messaging Server documentation:
http://docs.sun.com/coll/MessagingServer_04q2
The following documents are available:
- Sun Java System Messaging Server Release Notes
- Sun Java System Messaging Server Deployment Planning Guide
- Sun Java System Messaging Server Administration Guide
- Sun Java System Messaging Server Administration Reference
- Sun Java System Messaging Server Developer’s Reference
- Sun Java System Messaging Server Messenger Express Customization Guide
The Messaging Server product suite contains other products such as Sun Java System Console, Directory Server, and Administration Server. Documentation for these and other products can be found at the following URL:
http://docs.sun.com/db/prod/sunone
In addition to the software documentation, see the Messaging Server Software Forum for technical help on specific Messaging Server product questions. The forum can be found at the following URL:
http://swforum.sun.com/jive/forum.jsp?forum=15
Calendar Server Documents
Use the following URL to see all the Calendar Server documentation:
http://docs.sun.com/coll/CalendarServer_04q2
The following documents are available:
Communications Services Documents
Use either one of the following URLs to see the documentation that applies to all Communications Services products:
http://docs.sun.com/coll/MessagingServer_04q2
or
http://docs.sun.com/coll/CalendarServer_04q2
The following documents are available:
- Sun Java System Communications Services User Management Utility Administration Guide
- Sun Java System Communications Services Enterprise Deployment Planning Guide
- Sun Java System Communications Services Schema Migration Guide
- Sun Java System Communications Services Schema Reference
- Sun Java System Communications Services Event Notification Service Guide
- Sun Java System Communications Express Administration Guide
- Sun Java System Communications Express Customization Guide
Where to Find This Manual OnlineYou can find the Communications Services Event Notification Service Guide online in PDF and HTML formats. This book can be found at the following URLs:
http://docs.sun.com/doc/817-5700
Related Third-Party Web Site ReferencesThird-party URLs are referenced in this document and provide additional, related information.