H
Calendar Extensions to Directory Server Schema

This appendix presents the calendar server's extensions to the LDAP directory server schema. This only applies to standalone installations of the Oracle Calendar Server with third party directory servers. Consult your directory server documentation for information on the rest of your directory server schema.

• Object class extensions
• Default mappings for attribute names

Object class extensions

There are three object class extensions to the directory server schema. Each directory server entry should contain an instance of only one of these object classes. Each class is mutually exclusive with each of the other classes.

Table H-1 Calendar server object classes

Object Class	Description
ctCalUser	The object class for calendar server users. Note that a calendar server user entry is usually added to an existing user entry in the directory server.
ctCalAdmin	The object class for calendar server reserved users.
ctCalResource	The object class for calendar server resources.

Calendar server object classes

The following tables present the ctCalUser, ctCalAdmin, and ctCalResource object classes respectively.

Each calendar server object class is composed of attributes specific to that class, and attributes inherited from superior classes. All attributes specific to a calendar server object class have the prefix "ctCal" and are of type "case ignore string". See "Attribute definitions" for descriptions of each of the attributes.

ctCalUser object class

Requires:

• objectClass

Allows:

• c
• ctCalAccess
• ctCalAccessDomain
• ctCalAdmd
• ctCalCountry
• ctCalDefaultNoteReminder
• ctCalDefaultReminder
• ctCalDefaultTaskReminder
• ctCalDisplayPrefs
• ctCalFlags
• ctCalHost
• ctCalLanguageId
• ctCalMobileTelephoneType
• ctCalNodeAlias
• ctCalNotifMechanism
• ctCalOperatingPrefs
• ctCalOrganization
• ctCalOrgUnit1
• ctCalOrgUnit2
• ctCalOrgUnit3
• ctCalOrgUnit4
• ctCalPasswordRequired
• ctCalPreferredSMSCTelephoneNumber
• ctCalPrmd
• ctCalPublishedType
• ctCalRefreshPrefs
• ctCalServerVersion
• ctCalSMSTimeRange
• ctCalSysopCanWritePassword
• ctCalTimezone
• ctCalXItemId
• employeeNumber
• generationQualifier
• givenName
• initials
• mail
• title
• uid

ctCalAdmin object class

Requires:

• objectClass
• ctCalXItemId

Allows:

• c
• cn
• ctCalAccess
• ctCalAccessDomain
• ctCalAdmd
• ctCalCountry
• ctCalFlags
• ctCalHost
• ctCalLanguageId
• ctCalNodeAlias
• ctCalOrganization
• ctCalOrgUnit1
• ctCalOrgUnit2
• ctCalOrgUnit3
• ctCalOrgUnit4
• ctCalPasswordRequired
• ctCalPrmd
• ctCalServerVersion
• ctCalSysopCanWritePassword
• ctCalXItemId
• facsimileTelephoneNumber
• generationQualifier
• givenName
• initials
• mail
• o
• ou
• postalAddress
• sn
• telephoneNumber
• userPassword

ctCalResource object class

Requires:

• objectClass
• cn

Allows:

• ctCalAccess
• ctCalAccessDomain
• ctCalDefaultNoteReminder
• ctCalDefaultReminder
• ctCalDefaultTaskReminder
• ctCalDisplayPrefs
• ctCalFlags
• ctCalHost
• ctCalLanguageId
• ctCalNodeAlias
• ctCalNotifMechanism
• ctCalOperatingPrefs
• ctCalPasswordRequired
• ctCalRefreshPrefs
• ctCalResourceCapacity
• ctCalResourceNumber
• ctCalServerVersion
• ctCalSysopCanWritePassword
• ctCalTimezone
• ctCalXItemId
• facsimileTelephoneNumber
• givenName
• mail
• postalAddress
• sn
• telephoneNumber
• userPassword

Attribute definitions

The following two tables provide a description of all attributes associated with the calendar server object classes. The first describes attributes specific to the calendar server object classes, and the second describes attributes inherited from superior classes. Note that in the case of inherited attributes, the attribute name may vary with the directory server.

Table H-2 ctCal* attribute definitions

Attribute	Description
ctCalAccess	Allow/deny access of calendar server user.
ctCalAccessDomain	Internet domain or IP from which the calendar server user is allowed to access their calendar server data. For future use.
ctCalAdmd	X.400 Administration Management Domain Name (A).
ctCalCountry	Country. Not currently in use.
ctCalDefaultNoteReminder	Type: Visual, audible, mail, all or none. Len: Number of minutes before the event for reminder.
ctCalDefaultReminder	Type: Visual, audible, mail, all or none. Len: Number of minutes before the event for reminder.
ctCalDefaultTaskReminder	Type: Visual, audible, mail, all or none. Len: Number of minutes before the event for reminder.
ctCalDisplayPrefs	Display preferences. StartDay: Time in minutes to start day display. EndDay: Time in minutes to end day display. WeekStart: Specifies the first day of the week (i.e. usually Sunday or Monday). TimeIncrement: Time increment in minutes for display. ActiveDays: Specifies days to display (e.g. week days only). TimeFormat: Specifies time format (AM/PM or 24h) for display.
ctCalFlags	For future use.
ctCalHost	Host name, or IP address in dotted notation, of the computer hosting the calendar server user's data.
ctCalLanguageId	Preferred language for incoming mail notification. For future use.
ctCalNodeAlias	Mnemonic name of the node on which the calendar server user's data is stored.
ctCalNotifMechanism	Specifies mechanism used to notify attendees (usually mail).
ctCalOperatingPrefs	Operating preferences.
ctCalOrganization	User's organization. Not currently in use; "o" attribute is used for this information.
ctCalOrgUnit1	X.400 Organizational Unit 1(OU1). User's organization. Not currently in use; "ou" attribute is used for this information.
ctCalOrgUnit2	X.400 Organizational Unit 2 (OU2).
ctCalOrgUnit3	X.400 Organizational Unit 3 (OU3).
ctCalOrgUnit4	X.400 Organizational Unit 4 (OU4).
ctCalPasswordRequired	Specifies if the user must provide a password to have access to his calendar data.
ctCalPrmd	X.400 Private Management Domain Name (P).
ctCalPublishedType	Calendar type: Not Published, Published, Event Calendar
ctCalRefreshPrefs	Refresh preferences; State: on / off Frequency: Interval in minutes between refreshes.
ctCalResourceCapacity	Capacity of resource.
ctCalResourceNumber	Identification number of resource.
ctCalServerVersion	Version number of the calendar server hosting the user's data.
ctCalSMSTimeRange	Time range during which the user does not want to receive SMS messages. Values are expressed in minutes of the day, separated by a colon, e.g. 9 PM to 9 AM is expressed as "1260:540".
ctCalSysopCanWritePassword	Specifies if the calendar server SYSOP can overwrite the user's password.
ctCalTimezone	Current time zone of the user.
ctCalXItemId	Identification number of the node on which the calendar server user's data is stored as well as the identification number of the calendar server user's item.
ctCalMobileTelephoneType	Mobile telephone type.
ctCalPreferredSMSCTelephoneNumber	Preferred SMSC telephone number.

Table H-3 Inherited attribute definitions

Attribute name	Class	Description
c	n/a	Country.
cn	person	Common name of the administrator or resource.
employeeNumber	inetOrgPerson	Employee number of the user.
facsimileTelephoneNumberor fax	organizationalPerson	FAX phone number of the administrator or resource.
generationQualifier or gq	n/a	Generation qualifier.
givenName or gn	inetOrgPerson	Given name of the user. In the case of a resource, this is the given name of the contact.
initials	inetOrgPerson	User's initials.
mail or rfc822MailBox	inetOrgPerson	Email address.
mobile	inetOrgPerson	Mobile telephone number.
o	n/a	Organization of the user.
ou	organizationalPerson	Organizational unit of the user.
postalAddress	organizationalPerson	Mailing address of the administrator or resource.
sn or surname	person	Surname of the administrator or resource.
telephoneNumber	person	Telephone number of the administrator or resource.
title	organizationalPerson	Job title of the user.
uid	inetOrgPerson	User identification number.
userPassword	person	Password with which the administrator or resource binds to the directory server.

Default mappings for attribute names

You may choose to change the default names your calendar server uses for certain attributes to ensure these map properly into your directory server schema.

You change these attribute names through configuration parameters contained in the $ORACLE_HOME/ocal/misc/unison.ini file. These parameters are listed here, along with their default values.

Warning: Do not change the value of the attr_uid parameter unless you have changed the attribute used by your Oracle Internet Directory server for SSO login. See the Oracle Calendar Administrator's Guide, Chapter 3, "Administration," for details.

Table H-4 Configuration parameters for LDAP attribute names

Configuration parameter	Default value
attr_accessdomain	"ctCalAccessDomain"
attr_access	"ctCalAccess"
attr_address	"postalAddress"
attr_admindomain	"ctCalAdmd"
attr_capacity	"ctCalResourceCapacity"
attr_commonname	"cn"
attr_country	" "
attr_defaultnotereminder	"ctCalDefaultNoteReminder"
attr_defaultreminder	"ctCalDefaultReminder"
attr_defaulttaskreminder	"ctCalDefaultTaskReminder"
attr_displayprefs	"ctCalDisplayPrefs"
attr_employeeid	"employeeNumber"
attr_fax	"facsimileTelephoneNumber"
attr_flags	"ctCalFlags"
attr_generation	"generationQualifier"
attr_givenname	"givenName"
attr_groupname	"cn"
attr_ host	"ctCalHost"
attr_initials	"initials"
attr_jobtitle	"title"
attr_langid	"ctCalLanguageId"
attr_mail	"mail"
attr_member	"member"
attr_mobile	"mobile"
attr_mobiletype	"ctCalMobileTelephoneType"
attr_nodealias	"ctCalNodeAlias"
attr_notifmechanism	"ctCalNotifMechanism"
attr_objclass	"objectClass"
attr_operatingprefs	"ctCalOperatingPrefs"
attr_organization	""
attr_orgunit1	"ou"
attr_orgunit2	"ctCalOrgUnit2"
attr_orgunit3	"ctCalOrgUnit3"
attr_orgunit4	"ctCalOrgUnit4"
attr_passwordrequired	"ctCalPasswordRequired"
attr_password	"userPassword"
attr_phone	"telephoneNumber"
attr_privmdomain	"ctCalPrmd"
attr_publishedtype	"ctCalPublishedType"
attr_refreshprefs	"ctCalRefreshPrefs"
attr_resourcename	"cn"
attr_resourcenumber	"ctCalResourceNumber"
attr_serverversion	"ctCalServerVersion"
attr_smscpref	"ctCalPreferredSMSCTelephoneNumber"
attr_surname	"sn"
attr_sysopcanwritepassword	"ctCalSysopCanWritePassword"
attr_timezone	"ctCalTimezone"
attr_uid	"uid"
attr_uniquemember	"uniquemember"
attr_version	" "
attr_xitemid	"ctCalXItemId"