Sun Java System Calendar Server 6.3 Administration Guide

1.11 Public APIs for Calendar Server Version 6.3

Calendar Server includes the following APIs:

1.11.1 Web Calendar Access Protocol (WCAP) in Calendar Server Version 6.3

Calendar Server supports WCAP 3.0, a high-level, command-based protocol that allows communication with clients. WCAP commands, which use the .wcap extension, allow clients to get, modify, and delete calendar components, user preferences, calendar properties, and other calendar information such as time zones. WCAP elements such as times, strings, and parameters generally follow RFC 2445, RFC 2446, and RFC 2447 specifications.

WCAP returns output calendar data in an HTTP message in the following formats:

Standard RFC 2445 iCalendar format (text/calendar)
XML format (text/xml)

Using WCAP commands, a Calendar Server administrator who logs in using the login.wcap has the following capabilities:

To override the access control of WCAP commands

The administrator can use WCAP commands to read (fetch), alter (store), or delete other user’s calendars. For an administrator to have this privilege, the following parameter in the ics.conf file must be set to "yes":
```
service.admin.calmaster.overrides.accesscontrol="yes"
```
To retrieve and modify user preferences for any user

The administrator can use get_userprefs.wcap and set_userprefs.wcap to retrieve and modify any user’s preferences. For an administrator to have this privilege, the following parameter in the ics.conf file must be set to "yes":
```
service.admin.calmaster.wcap.allowmodifyuserprefs="yes"
```

For more information, see the Sun Java System Calendar Server 6.3 WCAP Developer’s Guide.

1.11.2 Event Notification Service (ENS) API for Calendar Server Version 6.3

The Event Notification Service (ENS) is an alarm dispatcher that detects events on an alarm queue and sends notifications of these events to its subscribers. The ENS API allows programmers to modify publish-and-subscribe functions used by Calendar Server to perform functions such as subscribe to events, unsubscribe to events, and notify a subscriber of events. The ENS APIs consists of these specific APIs: Publisher API, Subscriber API, and Publish and Subscribe Dispatcher API.

For information about the ENS API, see the Sun Java Communications Suite 5 Event Notification Service Guide.

Note –

The Calendar Server software also contains support for Java Message Queue for notification, but csnotifyd does not subscribe to it. Thus, it is not part of the default alarms and notification system. For more information, refer to the Sun Java System Java Message Queue documentation.