Sun Java System Calendar Server 6 2005Q4 Administration Guide

Creating Calendar Unique Identifiers (calid's)

Each calendar in the Calendar Server database is identified by a unique calendar identifier (ID) or calid. When creating calendars, you are required to specify the calid.

This section contains the following topics:

Calid Syntax

Each calendar in the database is identified by a unique calendar ID (calid). The following calid syntax has three parts:


The three parts are:


A user ID that is unique for the domain in this Calendar Server instance.


The name of the user’s domain.

With no hosted domains, the domain part is optional since there is no ambiguity about which domain the user is in.

With hosted domains, if the domain part is not specified, then Calendar Server uses the value specified in the ics.conf parameter service.defaultdomain for the domain. If the user is not in the default domain, the domain part must be specified.

For more information about hosted domains (also called virtual domains), see Chapter 11, Setting Up Hosted Domains and Chapter 13, Administering Hosted Domains.


An optional calendar name that is unique to the specific user. Although an owner has only one default calendar, it is possible to have other calendars for various purposes. Each of these non-default calendars is distinguished by its calendar name. For example, if user John Doe has a uid jdoe, his default calendar might be An auxiliary calendar he uses to keep track of baseball games for the Little League team he coaches might be identified with the following calid:

Calendar ID Creation Rules

When creating a calid, keep in mind the following rules:

Converting Non-Hosted calid's to Hosted Domain Format calid's

If you have calid's that were created before you had hosted domains, and you now want to convert the non-hosted domain calid's to hosted domain calid's, there is a utility, csvdmig, that can be used to add the domain part to your existing calids. See csvdmig for instructions on how to use the utility.