Sun Java System Calendar Server 6.3 Administration Guide

D.15 csresource

The csresource utility creates and manages LDAP entries and calendars for resources, such as conference rooms or equipment. (The csresource utility is available only for calendars associated with a resource and returns an error if issued against a user’s calendar.) Commands are:

D.15.1 Requirements

D.15.2 Syntax

csresource [-q|-v] 
           [-a aces] 
           [-b  basedn] 
           [-d domain] 
           [-t description] 
           [-k yes|no] 
           [-o owner] 
           [-y otherowners] 
            -m email 
            -c calid 
           create common_name

csresource [-q|-v] 
           [-b basedn] 
           [-d domain]
           delete|disable|enable [common_name]

csresource [-q|-v] 
           [-b basedn]
           [-d domain]
           [-h host] 
           list [common_name]

Then following table describes the commands available for the csresource utility.

Table D–26 csresource Utility Commands



create common_name

Create a new resource for a specified calendar ID. 

delete [common_name]

Delete a resource or, if no resource common_name is specified, delete all resources.

enable [common_name]

Enable a resource or, if no resource common_name is specified, enable all resources.

disable [common_name]

Disable a resource or, if no resource common_name is specified, disable all resources.

list [common_name]

Display a single resource calendar or, if no resource name is specified, display all resource calendars.

If the -h host option is included, display the calendar attributes for the specified name (or all resource calendars) on that back-end server.

Note –

If the name contains a space in any of the above commands, it must be enclosed in quotation marks (" ").

The following table describes the csresource utility command options.

Table D–27 csresource Utility Command Options




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


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 the 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 resource.default.acl parameter in the ics.conf file.

For information about the ACE format, see 15.4 Calendar Access Control.

-b [basedn]

LDAP base DN (distinguished name) to be used for the specified resource. The default is taken from the local.ugldapbasedn parameter in the ics.conf file.

-c calid

The icsCalendar attribute. This option is required with the create command. For more information, see 15.2 Creating Calendar Unique Identifiers (calid's).

-d domain

Specifies the name of a domain. Default is taken from the service.defaultdomain parameter in the ics.conf file.

-t [description]

Specifies a viewable comment about the purpose of the calendar. The default is no description. 

-h host

Specifies the name of a back-end server where the resource calendar resides. This option applies only to the list command. 

-k yes|no

Specifies whether double booking is allowed for a calendar associated with a resource such as a conference room. For example, yes means the resource 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 resource.allow.doublebook parameter in the ics.conf file. However, the resource.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 double booking is allowed. If you need to change the calendar properties for a calendar to allow or disallow double booking, reissue csresource with the -k option.

-m email

Specifies the LDAP mail attribute (primary email address) for the resource. 

-o owner

Primary owner. 

Default is taken from service.siteadmin.userid in the ics.conf file.

-y otherowners

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


Display the version of the utility. 

D.15.3 Examples