Preface

The Sun Java^TM System Calendar Server 6.3 WCAP Developer's Guide gives detailed instructions on the use of the Web Calendar Access Protocol (WCAP). You can use the WCAP commands to access calendar services and data.

Topics covered in this preface include:

• Who Should Use This Book

• Before You Read This Book

• How This Book is Organized

• Related Books

• Related Third-Party Web Site References

• Documentation, Support, and TrainingDocumentation, Software, Support, and Training

• Typographic ConventionsTypographic Conventions

• Shell Prompts in Command ExamplesShell Prompts in Command Examples

Who Should Use This Book

This guide is for software engineers who want to write customized scripts for accessing Calendar Server data.

Before You Read This Book

This book assumes that you have a general understanding of the following:

• The Internet and the World Wide Web

• Calendaring concepts

• LDAP

• RFC 2445, RFC 2446, RFC 2447

  These RFC's describe in detail the format and definition for times, strings, parameters, and so forth used in WCAP commands.

  The RFC’s can be found at the IETF web site:

  • http://www.ietf.org/rfc/rfc2445.txt

  • http://www.ietf.org/rfc/rfc2446.txt

  • http://www.ietf.org/rfc/rfc2447.txt

How This Book is Organized

A list of the chapters follows:

• Chapter 1, Web Calendar Access Protocol Overview

  This chapter gives an introduction to the WCAP protocol. WCAP is a command-based system for transmitting calendar data.

• Chapter 2, Calendar Server WCAP Common Topics

  This chapter covers topics of common interest that span multiple commands.

• Chapter 3, Calendar Server WCAP Command Reference

  This chapter details the individual commands.

---

Note –

This document has been reorganized for this release. All chapters not dealing with WCAP were removed. The removed material, covering CSAPI and the AuthSDK, had not been updated for several releases. If you have need to refer to the material in the deleted parts, see an older version of the guide, such as theSun Java System Calendar Server 6 2005Q4 Developer's Guide.

---

Related Books

The following Calendar Server documents are available online in PDF and HTML formats:

• Sun Java Communications Suite 5 Release Notes

• Sun Java Communications Suite 5 Documentation Center

• Sun Java Communications Suite 5 Deployment Planning Guide

• Sun Java System Calendar Server 6.3 Administration Guide

• Sun Java Communications Suite 5 Event Notification Service Guide

• Sun Java System Communications Services 6 2005Q4 Schema Reference

• Sun Java Communications Suite 5 Schema Migration Guide

• Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide

• Sun Java System Communications Express 6.3 Administration Guide

• Sun Java System Communications Express 6.3 Customization Guide

• Sun Java Enterprise System Technical Note: Sun Java System Calendar Frequently Asked Questions

• Sun Java Enterprise System Glossary

In addition, the graphical user interface, Communications Express, has online help.

Related Third-Party Web Site References

Third-party URL's 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 is not responsible or liable for any actual or alleged damage or loss caused by or in connection with the 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

The Sun web site provides information about the following additional resources:

• Documentation

• Support

• Training

Typographic Conventions

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

Table P–1 Typographic Conventions

Typeface	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. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online.

Shell Prompts in Command Examples

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

Table P–2 Shell Prompts

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