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

Preface

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

Topics covered in this preface include:

Who Should Use This Book

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

Before You Read This Book

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 manual contains the following chapters and appendix:

Table P–1 How This Book Is Organized


Chapter	Description
Chapter 1, Introduction to Event Notification Service	Describes the Event Notification Service (ENS) components, architecture, and Application Programming Interfaces (APIs).
Chapter 2, Event Notification Service C API Reference	Describes the ENS C API.
Chapter 3, Event Notification Service Java (JMS) API Reference	Describes the ENS Java API and provides sample code.
Chapter 4, Messaging Server Specific Information	Describes the Messaging Server event references and provides sample Messaging Server code.
Chapter 5, Calendar Server Specific Information	Describes the Calendar Server event notifications and provides sample Calendar Server code

Related Books

The http://docs.sun.com^SM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Messaging Server Documents

Use the following URL to see all the Messaging Server documentation:

http://docs.sun.com/coll/1312.1

The following documents are available:

Sun Java System Messaging ServerAdministration Guide
Sun Java^TM System Messaging Server Administration Reference
Sun Java^TM System Messaging Server MTA Developer’s Reference
Sun Java^TM System Messenger Express Customization Guide

The Messaging Server product suite contains other products such as Sun Java^TM 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/1313.1

The following documents are available:

Sun Java^TM System Calendar Server Administration Guide
Sun Java^TM System Calendar Server Developer’s Guide

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/1312.1

http://docs.sun.com/coll/1313.1

The following documents are available:

Sun Java^TM System Communications Services Release Notes
Sun Java^TM System Communications Services Delegated Administrator Guide
Sun Java^TM System Communications Services Deployment Planning Guide
Sun Java^TM System Communications Services Schema Migration Guide
Sun Java^TM System Communications Services Schema Reference
Sun Java^TM System Communications Services Event Notification Service Guide
Sun Java^TM System Communications Express Administration Guide
Sun Java^TM System Communications Express Customization Guide

Where to Find This Manual Online

You can find the Communications Services Event Notification Service Guide online in PDF and HTML formats. This book can be found at the following location:

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

Related Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note –

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Documentation, Support, and Training

Sun Function	URL	Description
Documentation	`http://www.sun.com/documentation/`	Download PDF and HTML documents, and order printed documents
Support and Training	`http://www.sun.com/supportraining/`	Obtain technical support, download patches, and learn about Sun courses

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

Download Centerhttp://wwws.sun.com/software/download/
Professional Serviceshttp://www.sun.com/service/sunps/sunone/index.html
Sun Enterprise Services, Solaris Patches, and Supporthttp://sunsolve.sun.com/
Developer Informationhttp://developers.sun.com/prodtech/index.html

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to http://www.sun.com/service/contacting.

Typographic Conventions

The following table describes the typographic changes that are used in this book.

Table P–2 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`aabbcc123`	Placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. Perform a patch analysis. Do not save the file. [Note that some emphasized items appear bold online.]

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–3 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`

Default Paths and File Names

The following table describes the default paths and file names used in this book.

Table P–4 Default Paths and File Names


Term	Description
`msg_svr_base`	Represents the base installation directory for Messaging Server. The default value of the msg_svr_base installation is as follows: Solaris™ systems: `/opt/SUNWmsgsr` Linux systems: `/opt/sun/messaging`
`cal_svr_base`	Represents the base installation directory for Calendar Server. The default value of the cal_svr_base installation is as follows: Solaris™ systems: `/opt/SUNWics5` Linux systems: `/opt/sun/calendar`

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Communications Services 6 2005Q4 Event Notification Service Guide, and the part number is 819-2655.