Sun Java System Calendar Server 6 2005Q4 Developer's Guide

Command Overview

The following is a list of commands supported in WCAP. For a detailed description of each command, see Chapter 7, WCAP Command Reference

Table 5–1 WCAP Command Overview


WCAP Command	Description
Command: check_id	Administrator only: Check if user’s session ID is valid.
Command: createcalendar	Create a new calendar.
Command: deletecalendar	Delete an existing calendar.
Command: deletecomponents_by_range	Delete both events and todos in a calendar(s) over a specific time period.
Command: deleteevents_by_id	Delete events given a specific `calid` and `uid` or recurrence-ID pair.
Command: deleteevents_by_range	Delete events in a calendar(s) over a specific time period.
Command: deletetodos_by_id	Delete todos given a specific `calid` and `uid` or recurrence-ID pair.
Command: deletetodos_by_range	Deletes todos in a calendar(s) over a specific time period.
Command: export	Exports a calendar to a file.
Command: fetchcomponents_by_alarmrange	Queries for components that have alarms to trigger over a specific time period.
Command: fetchcomponents_by_attendee_error	Queries for components that had errors while sending group scheduling messages.
Command: fetchcomponents_by_lastmod	Queries for components that have changed, during the specified time range.
Command: fetch_deletedcomponents	Queries the `deletelog` database for deleted components.
Command: fetchcomponents_by_range	Queries for components over a specific time period, with filtering attributes.
Command: fetchevents_by_id	Queries for one or more events by a unique identifier (UID, Recurrence ID, modifier).
Command: fetchtodos_by_id	Queries for one or more todos by a unique identifier (UID, Recurrence ID, modifier).
Command: get_all_timezones	Returns all the time zones the server supports.
Command: get_calprops	Returns calendar properties.
Command: get_freebusy	Returns calendar free-busy time.
Command: get_guids	Returns a set of random UID's.
Command: gettime	Returns the server times for the requested `calid`s.
Command: get_userprefs	Returns user preferences and some server settings.
Command: import	Imports a calendar from a file to a user’s calendar.
Command: list	Lists all calendars owned by a user.
Command: list_subscribed	Lists all calendars subscribed to by a user.
Command: login	Authenticates a user and redirects to first HTML view.
Command: logout	Terminates the current user’s session and return to login screen.
Command: ping	Administrator only: Pings the calendar server.
Command: search_calprops	Searches for a calendar with the specified parameter values.
Command: set_calprops	Sets calendar properties.
Command: set_userprefs	Sets user preferences.
Command: storeevents	Stores events that are specified in application or URL encoded manner. For storing an even by passing properties in a URL.
Command: storetodos	Stores todos that are specified in the application or URL encoded manner.
Command: subscribe_calendars	Adds calendars to a users subscription list.
Command: unsubscribe_calendars	Removes calendars from a user’s subscription list.
Command: verifyevents_by_ids	Fetches events and returns the `uid` or `rid` of events not in the database.
Command: verifytodos_by_ids	Fetches todos and returns the `uid` or `rid` of todos not in the database.
Command: version	Returns the WCAP version that the server supports.

Session Identifiers

For many WCAP commands, you must specify the session identifier (id) that is returned by the login command. The session identifier ensures that data is accessible only to authenticated users with the required level of privilege or ownership.

When logging into the system, a user provides authentication of identity. The default authentication mechanism uses plain-text passwords and user names. Calendar Server generates the session identifier only when authentication is successful. The identifier then serves as proof of authentication in subsequent calendaring operations.

You can customize the authentication mechanism to use a local or external authentication scheme, see API: csIAccessControl.

For more information about how to configure authentication, see chapter 10 in the Calendar Server Administration Guide: Sun Java System Calendar Server 6 2005Q4 Administration Guide.

Hosted (Virtual) Domain Mode

If you are using hosted (virtual) domains, all WCAP commands you issue must have fully qualified user ID's (uid) and calendar ID's (calid), for example jdoe@example.com.

In order to be in hosted domain mode, several parameters in the ics.conf file must be configured as specified in chapter 12 in the Calendar Server Administration Guide: Sun Java System Calendar Server 6 2005Q4 Administration Guide.

See your Calendar Server administrator if you do not know whether you are using hosted domains.

The following two example WCAP commands demonstrate the difference between calid values for non-hosted domain mode and hosted domain mode.

Non-hosted domain mode:

http://webcalendarserver/get_userprefs.wcap
                    ?id=b5q2o8ve2rk02nv9t6
                    &calid=jdoe
                    &fmt-out=text/calendar

In hosted domain mode:

http://webcalendarserver/get_userprefs.wcap
                    ?id=b5q2o8ve2rk02nv9t6
                    &calid=jdoe@example.com
                    &fmt-out=text/calendar