Creating a User Calendar Using cscal

To create a new calendar, use the cscal utility create command. The user or resource entry must already exist in the LDAP directory. Refer to Chapter 14, Administering Users and Resourcesfor information on adding users and resources to your LDAP directory.

If your site is using the LDAP Calendar Lookup Database (CLD) plug-in, you must create all of the calendars for a particular user or resource on the same back-end server, as indicated by the icsDWPHost LDAP attribute in the user or resource entry. If you try to create a calendar on a different back-end server, the cscal utility returns an error. For information about the LDAP CLD plug-in, see Chapter 6, Configuring Calendar Database Distribution Across Multiple Machines.

For example, to create a new calendar with the calendar ID (calid) jsmith:

cscal -o jsmith -n JohnSmithCalendar create jsmith

where:

• -o jsmith specifies the primary owner of the new calendar.

• -n JohnSmithCalendar specifies the viewable name for the new calendar.

• The default access control settings are defined by calstore.calendar.default.acl in the ics.conf file.

To create a calendar with the viewable name Hobbies that is owned by John Smith and uses the default access control settings for group scheduling:

cscal -n Hobbies -o jsmith create Personal

where:

• -n Hobbies specifies the viewable name of the calendar.

• -o jsmith specifies the user ID of the primary owner.

• Personal is used as the second part of the calendar ID (calid). For example: jsmith:Personal

The following example creates a new calendar similar to the previous example, but it also associates the calendar with the category named sports, enables double booking, and specifies Ron Jones as another owner:

cscal -n Hobbies -o jsmith -g sports -k yes -y rjones create Personal

where:

• -g sports associates the calendar with a category named sports.

• -y rjones specifies another owner of the calendar.

• -k yes enables double booking. (-k no would disable double booking.)

The following example creates a calendar similar to the previous example, but it also sets specific access control settings for group scheduling:

cscal -n Hobbies -o jsmith -a "@@o^a^sfr^g" create Personal

where -a "@@o^a^sfr^g" grants other owners schedule, free/busy, and read access privileges to both the components and calendar properties of this calendar for group scheduling.