Web Calendar Access Protocol (WCAP)

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 2005Q4 Developer’s Guide.