test

Sun Java System Calendar Server 6.3 Administration Guide

D.5 cscal

The cscal utility manages calendars and their properties. Commands are:

D.5.1 Requirements

D.5.2 Syntax


cscal [-q|-v] 
      [-a aces] 
      [-c charset] 
      [-d description] 
      [-g categories]
      [-k yes|no] 
      [-l langcode]
      [-m email]
      [-n name] 
      [-o owner’s uid]
      [-y otherowners]
      create|modify calid

cscal [-q|-v] 
      [-o owner’s uid]
      [-O] 
      delete|reset calid

cscal [-q|-v] 
      [-o owner’s uid]
      [-O] 
      disable|list [calid]

cscal [-q|-v] 
      [-k yes|no]
      [-o owner’s uid]
      [-O] 
      enable [calid]
Note –

Despite the fact that cscal does not check case when you enter the -o (owner’s uid), the search is case insensitive.

The following table describes the commands available for the cscal utility.

Table D–6 cscal Utility Commands

Command  

Description 

create calid

Creates the calendar specified by calid. 

Note: If your site is using the LDAP CLD plug-in, all calendars for a specific user must reside on the same back-end server, as indicated by the user’s icsDWPHost LDAP attribute. If you try to create a calendar for the user on a different back-end server, Calendar Server returns an error.

delete calid

Deletes the calendar specified by calid.

If the -o owner option is specified, deletes all calendars whose primary owner is the specified uid.

enable [ calid ]

Enables the calendar specified by calid. If calid is not specified, enables all calendars.

If the -o owner option is specified, enables all calendars whose primary owner is the specified uid.

disable [ calid ]

Disables the calendar specified by calid. If calid is not specified, disables all calendars.

If the -o owner option is specified, disables all calendars whose primary owner is the specified uid.

list [ calid ]

Lists properties of the calendar specified by calid. If calid is not specified, lists properties of all calendars.

If the -o owner's uid option is specified, lists all calendars whose primary owner is the specified owner uid.

Note –

When any of the permissions have been modified through the Calendar Express user interface, this command lists those ACE letters capitalized. There is no significance to this. The ACEs are case insensitive.

modify calid

Modifies the properties of the calendar specified by calid.

reset calid

Resets the properties of the calendar specified by calid to the default configuration settings.

version

Displays the version of the utility. 

The following table describes the cscal utility command options.

Table D–7 cscal Utility Command Options

Option  

Description  

-v

Run in verbose mode: Display all available information about the command being performed. Default is off. 

-q

Run in quiet mode: 

  • Display no information if the operation is successful (errors, if they occur, are displayed).

  • Suppress confirmation prompting for dangerous commands.

    Default is off.

-a [aces]

Access Control Entries (ACE's) for a specified calendar. ACE's determine who can access a calendar for group scheduling and the types of permissions they have, such as create, delete, read, and write privileges. An ACE string or Access Control List (ACL), must be enclosed in quotation marks (" ").

The default is the calstore.calendar.default.acl parameter in the ics.conf file.

For details about the ACE format, see 1.8 Access Control for Calendar Server Version 6.3.

-c charset

Character set. The default is no character set. 

-d description

Description (a viewable comment about the purpose of the calendar). The default is no description. 

-g category

Category. Multiple categories must be enclosed in quotation marks ("") and separated by spaces. The default is no category.

-k yes|no

Specifies whether double booking is allowed for a user calendar. For example, yes means the calendar can have more than one event scheduled for the same time slot.

If the -k option is omitted, the default is taken from the user.allow.doublebook parameter in the ics.conf file. However, the user.allow.doublebook parameter is used only when a calendar is created.

After a calendar is created, Calendar Server checks the calendar properties database, ics50calprops.db, to determine if doublebooking is allowed. If you need to change the calendar properties for a calendar to allow or disallow doublebooking, reissue cscal with the -k option.

-l langcode

Language code. The default is no language code. 

-m email

Email address. The default is no email. 

-n name

Viewable Name. The default is no name. 

-o owner

(Lowercase o) 

Primary owner. The default setting is the unique ID (uid) of the primary owner.

-O

(Uppercase O) 

Specifies all calendars of the primary owner. Default is the named calendar only. 

-y otherowners

Other calendar owners. Multiple owners must be enclosed in quotation marks ("") and separated by spaces. The default is no other owners.

D.5.3 Possible Problems Creating a Calendar on a Back-End Machine

If you try to create a calendar on a designated back-end machine, and you get the following error message: Invalid DWP Host Server. it means one of two things. Either your server is not configured properly, or the calendar owner has already been assigned to a different back-end server.

D.5.3.1 Back-End Machine Not Configured Properly

Look at the ics.conf file for the back-end server in question. Verify that the following settings exist: 

service.dwp.enable = "yes"
caldb.cld.type = "directory"
local.hostname = "back-end hostname"

D.5.3.2 Calendar Owner Assigned to a Different Back-End Machine

Look at the user's LDAP entry and see if there is an icsDWPHost attribute present. The value of icsDWPHost must match the back—end server name on which you are attempting to create the calendar. You can not create a calendar for this user on a different back-end server.

D.5.4 Examples