Sun Java System Calendar Server 6.3 Administration Guide

15.2 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:

15.2.1 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 a single domain, the domain part is optional since there is no ambiguity about which domain the user is in.

With multiple 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 multiple domain environments, see Chapter 10, Setting Up a Multiple Domain Calendar Server 6.3 Environment and Chapter 13, Administering Calendar Server 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:

15.2.2 Calendar ID Creation Rules

This section describes the rules for creating a calendar ID (calid).

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

15.2.3 Converting Non-Domain calid's to Multiple Domain Format calid's

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

If you do not add domain names to the existing calid's, the system will assume they belong to the default domain.