Skip Headers

Oracle Calendar Server Reference Manual
Release 5.5

Part Number B10094-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

B
Server Parameters

This appendix lists and describes all tunable parameters available to configure your calendar server. All parameters listed are located in the initialization file /users/unison/misc/unison.ini.

Each parameter's stated default value is used if that parameter is omitted from its configuration file. These defaults are not necessarily the optimal settings for your installation. The initialization files supplied with the software contain settings that provide a good starting point for further configuration. It is strongly recommended that for reference purposes you keep a copy, in either printed or electronic format, of these files before modification.

Configuration parameters

The types of behaviour that can be modified fall under the following sections:

The following table lists all parameters alphabetically by section.

Table B-1 unison.ini configuration parameters
Section Parameter Description

[ACE]

frameworkenable

Enable the ACE framework

slibcachecount

Maximum number of shared libraries per type

minbufsizetocompress

Minimum buffer size for compression

workbufsize

Buffer size for compression and encryption

[ACE_PLUGINS_SERVER]

web_CAL_sharedkey

Web authentication -- shared key

[AUTHENTICATION]

admindefault

Default authentication method for administrators

default

Default authentication method for clients

keepresourcepswincaldb

Location of resource passwords for authentication

servicedefault

Default authentication method for other servers

supported

Supported authentication methods for clients

[CLIENT]

minrefreshrate

Minimum interval for checks for new agenda entries (server-side enforcement)

[CLUSTER]

excludednodes

Excluded nodes for on-line registration

masternode

Master node

remotemasternode

Remote master node

[COMPRESSION]

admindefault

Default compression method for administrators

default

Default compression method for clients

servicedefault

Default compression method for other servers

supported

Supported compression methods

[CWS]

emailcharsetmap

Character set conversion for e-mail

enable

Automatic start of CWS daemon/service

mailfiledelete

Automatic deletion of temporary file for last mail message

mailhdroriginatorfromuser

Content of the "From:" field of the mail header

mailhdrtoname

UTF-8 for names in "To:" field of mail header

mailhost

Host name of the SMTP mail server (obsolete)

maxtimepernode

Maximum time spent processing requests per node

mimecontentcharset

Character set for content portion of mail message

noreqsleep

Sleep time between checks on request queue

sendmailpath

Pathname of the mail program (obsolete)

smsnotifyprogram

Short Message Service (SMS) notification program

smsnotifyprogramparam

Short Message Service (SMS) notification program arguments

smtpmail

Set mail transport

smtpmailhost

Host name of the SMTP mail server

smtpmailmaxcommandlinesize

Maximum size for sendmail command lines

smtpmailmaxrecipients

Maximum number of recipients

smtpmailpath

Pathname of the mail program

smtpmailprogram

Mail program

startupsleep

Time to sleep on start-up

trace

Logging: verbose switch

unixmail

Set mail transport (obsolete)

unixmailprogram

Mail program (obsolete)

[DAS]

dir_itembindonread

Force DAS sign-on and sign-off for read-only operations

dir_service

Set directory service

dir_updcalonly

Allow users to update only calendar attributes

enable

Automatic start of DAS daemon/service

stats

Statistics logging: unidasd

[DB]

db_files

Maximum number of database files open per user

db_pages

Number of pages in the database cache

[DBI]

dbi_name

Node database template

dbversion

Node database version

[DOMAIN]

type

Node connection types

[ENCRYPTION]

admindefault

Default encryption method for administrators

default

Default encryption method for clients

needsauthenticate

Encryption methods requiring prior authentication

servicedefault

Default encryption method for other servers

supported

Supported encryption methods

[ENG]

activity

Statistics logging: user connections

allowresourceconflict

Double-booking resources (server-side)

allowsysoplogon_capi

Allow SYSOP logons for CAPI applications

allowsysoplogon_unicp

Allow SYSOP logons from unicp utilities

allowsysoplogon_uniical

Allow SYSOP logons from uniical

calendarhostname

Cluster host name

capi_storage

Supported CAPI version

dac_configerrlog

Logging of configuration errors

dac_failederrlog

Logging of failure errors

dac_ignorederrlog

Logging of non-critical errors

dac_itemget

Enable item retrieval from directory server

dac_maxretry

SNC to DAS connection retries

dac_miscerrlog

Logging of miscellaneous errors

dir_internal_nodes

Coexistence of LDAP and non-LDAP nodes

eventrefreshintervals

Refresh intervals and agenda ranges

eventsearch_clientwindowsize

Size of the client event search result window

eventsearch_commentsearchlength

Search event comments

eventsearch_maxlookthroughlimit

Timeout for event search

evsearch_maxcount

Maximum number of events to return

localcharset

Character set for log files

itemuidmap

X.400 field for UID

max_addrlogons

Number of concurrent sessions from a specific Internet address

maxinstances

Maximum number of instances of a recurring meeting, daily note, or day event (server-side)

max_userlogons

Maximum number of concurrent sessions by a given user

notify

Mail notification

passwords

Case-sensitivity of passwords

readlocktimeout

Maximum read lock time before termination

readmaxlocktime

Maximum read lock time before release

resourcemailmap

Resource mail mapping

standards

Calendar standards

stats

Statistics logging: user sessions

userlookthroughlimit

Maximum number of items to search

usermailmap

User mail mapping

usermobilemap

User mobile phone number mapping

usermobiletypemap

User mobile phone type mapping

usersearchmaxreturn

Maximum number of items to return

usersmscprefmap

User alert preference mapping

utf8_autoconvert

Enable conversion of data to UTF-8 format

utf8_onfailprintmesg

Logging of failure to instantiate UTF-8 conversion functionality

writelocktimeout

Maximum write lock time before termination

writemaxlocktime

Maximum write lock time before release

[LCK]

lck_users

Maximum number of Engines

[LDAP]

admin

Location of the calendar server administrators

admingroup

Group entry for calendar server administrators

attr_country

Name of the "country" attribute

attr_organization

Name of the "organization" attribute

attr_generation

Name of the "generation qualifier" attribute

attr_givenname

Name of the "given name" attribute

attr_mail

Name of the "mail" attribute

attr_uid

Calendar unique user identifier mapping

attr_version

LDAP protocol version

attrpreservelist

Attribute preserve list

basedn

Distinguished Name of the subtree containing calendar server entries

binddn

Distinguished Name used for anonymous connections

bindpwd

Password used for anonymous connections

certdbpath

Location of file containing trusted certificates

charset

Character set used by the directory server

dsa

Name of directory server

dsausesearchtocompare

Directory server support for ldap_compare() requests

groupfilter

Search filter for groups

groupmemberattribute

Name of "member" attribute in group object class

groupobjectclass

Search filter for groups

host

Name of directory server host

mgrdn

Distinguished Name of the directory server administrator

port

Port number of the LDAP directory server

resourcerelativedn

Relative Distinguished Name for resources

secure-port

Port to use for SSL connections

security

Enable SSL connections

timelimit

Maximum time to wait on an LDAP call

writedn

Distinguished Name used for write operations

writednpassword

Password used for LDAP write connections

[LIMITS]

agendaview

Default agenda view

allowattachments

Allow agenda attachments

autocontrol

Minimum interval for checks for new agenda entries (client-side enforcement)

browserhelp

On-line help display

groupviewmax

Maximum number of users in a group view

mail

Enable mail notification

maxattachmentsize

Maximum size of attachments

maxmaildistr

Maximum number of people in a mail notification distribution list

maxpasswordage

Password aging

maxpersabentries

Maximum number of personal address book entries

maxrecur

Maximum number of instances for a repeating meeting, daily note, or day event (client-side)

maxremleadtime

Maximum lead time on a reminder

maxsearchresult

Maximum number of search results displayed

maxwinopen

Maximum number of open windows

mincharsearch

Minimum number of characters in the Surname edit box

publishab

Enable publishing of address books

page-backward

"Previous" button in search dialogue box

page-forward

"Next" button in search dialogue box

pubgroups

Right to create public groups

publishab

Enable publishing of address books

remotemaxretry

Retry limit for remote data requests to server

remotewait

Retry interval for remote data requests to server

resourceconflicts

Double-booking resources (client-side)

secure-login

Secure sign-in

settimezone

Permission to change default timezone

signinmaxattempts

Maximum number of sign-in attempts

singlelst

Single local storage

ssignin

Allow automatic sign-in

userlist_login

Show multiple user matches on sign-in

[LOCALE]

charset

Character set for content portion of mail message

[NOTIFY]

checkreminderinterval

Interval between checks for reminders

ignoreoldreminders

Reminders to ignore

limitremindercheck

Maximum time to check a node for reminders

sms

Short Message Service (SMS) alerts

[OUTLOOK_CONNECTOR]

eventselectbegin

Number of days preceding current date to consult or return for queries

eventselectend

Number of days following current date to consult or return for queries

[PRODUCT]

name

Product name

version

Product version number

[QUOTA]

maxfolderentryperuser

Maximum number of entries in a folder

[SNC]

enable

Automatic start of the SNC daemon/service

max_socket

Maximum number of connections

request_chunk_size

Number of requests that are reset at a time

snc_so_keepalive

Idle connections

snc_so_rcvbuf

Size of the socket layer receive buffer

snc_so_sndbuf

Size of the socket layer send buffer

snc_tr_block

Block size for communications

snc_tr_recv_timeout

Time-out for received transmissions

snc_tr_send_timeout

Time-out for sent transmissions

wait_sbh

Number of minutes to wait for remote node connection

[SYS]

sys_owner

User under whom processes run (UNIX only)

[TIMEZONE]

checksum

Checksum of the time zone rules file

default

Default time zone

rules

Time zone rules

[UTL]

adm_moduserpassword

Modification of user password

backup_timeout

Backup operation timeout

external_backup

Specify alternate backup utility

external_restore

Specify alternate restore utility

host

Host name of system

restore_timeout

Restore operation timeout

[WEBLINK]

browser-path-win

Browser to launch for Windows clients

command-description-offline

Off-line command description

command-description-online

On-line command description

command-name

Text to appear in Help menu and ToolTip

download-fail

Error message to display if download fails

download-mode

File transfer protocol

mode

Enabling web access

offline-source-mac

Source of web pages for Mac clients in off-line mode

offline-source-version

Version of off-line web page

offline-source-win

Source of web pages for Windows clients in off-line mode

online-url

Web page to load for clients working on-line

[WEBLINK-FRENCH]

browser-path-win

French-language browser to launch for Windows clients

command-description-offline

Off-line French-language command description

command-description-online

On-line French-language command description

command-name

French-language text to appear in Help menu and ToolTip

download-fail

Error message to display if download fails

download-mode

File transfer protocol

mode

Enabling French-language web access

offline-source-mac

Source of French-language web pages for Mac clients in off-line mode

offline-source-version

Version of French-language off-line web pages

offline-source-win

Source of French-language web pages for Windows clients in off-line mode

online-url

French-language web page to load for clients working on-line

[YOURHOSTNAME, unidas]

connect_timeout

Timeout for connecting to directory server

dir_adminmodcalonly

Permissions for modifying directory server attributes

dir_adminupdcalonly

Permissions for updating directory server attributes

numconnect

Number of connections to directory server

[YOURNODEID]

aliases

Node alias(es)

localnodes

Allow resources in remote nodes to appear as local

name

Node name

relativedn

Relative DN for individual domains

resourcerelativedn

Resource Relative DN for individual domains

timezone

Node time zone

version

Database version number

Product name

Section

[PRODUCT]

Parameter

name

Description

Specifies the name of the product. Set during installation, this value should not be edited or removed.

Accepted values

n/a

Default value

n/a

Product version number

Section

[PRODUCT]

Parameter

version

Description

Specifies the version number of your calendar server. Do not edit or remove this value.

Accepted values

n/a

Default value

n/a

Controlling server behaviour

Host name of system

Section

[UTL]

Parameter

host

Description

Specifies the host name of the system on which your calendar server is running. The server installation script sets this parameter. This parameter must always have a value set for it in the unison.ini file.

Accepted values

A valid (fully-specified) host name

Default value

None

Cluster host name

Section

[ENG]

Parameter

calendarhostname

Description

Specifies an alternate host name for the calendar server in cases when the system-defined host name should not be used.

The principal use for this parameter is to identify the calendar server host in UNIX environments using operating system clusters, where multiple hosts are running the calendar server in the same cluster for failover protection. In this case, you should set the value of this parameter to the name of the operating system cluster itself, rather than the name of any physical calendar server host.

Accepted values

A valid (fully-specified) host name

Default value

None

Calendar standards

Section

[ENG]

Parameter

standards

Description

A lists of supported Internet standards and related technologies, enclosed in curly braces {} and separated by commas. Do not change the value of this parameter without explicit instructions from application documentation or Oracle support personnel.

Accepted values

{} (no CAPI support)

{CAPI} (CAPI support with support for some ICAL2.0 attributes)

{CAPI, ICAL2.0} (CAPI support and support for all IETF ICAL 2.0 attributes)

Default value

{}

Supported CAPI version

Section

[ENG]

Parameter

capi_storage

Description

Specifies the version of Oracle's Calendar API (CAPI) that the server supports. The server reads this parameter only if the value of [ENG] standards includes ICAL2.0.

Accepted values

BASIC (pre-4.0 support for CAPI)

FH (support for CAPI 1.0)

OPTFH (support for CAPI 1.1 and higher)

Default value

OPTFH

User under whom processes run (UNIX only)

Section

[SYS]

Parameter

sys_owner

Description

For UNIX only, this parameter specifies the user under whom the calendar server processes run. In all cases, the calendar server executes services with the effective user controlling security set to unison.

Under NT all services run as System Account.

Accepted values

(UNIX)

unison

root

Default value

(UNIX)

unison

Automatic start of CWS daemon/service

Section

[CWS]

Parameter

enable

Description

Determines whether unicwsd, the Corporate-Wide Services daemon/service, automatically starts when the calendar server is brought up. You must set this to TRUE if your server configuration has multiple nodes or mail notification.

Accepted values

TRUE (start unicwsd automatically)

FALSE (do not start unicwsd automatically)

Default value

TRUE

Automatic start of the SNC daemon/service

Section

[SNC]

Parameter

enable

Description

Determines whether unisncd, the Synchronous Network Connections daemon/service, automatically starts when the calendar server is brought up. You must set this to TRUE if your server configuration contains multiple nodes or uses a directory server.

Accepted values

TRUE (start unisncd automatically)

FALSE (do not start unisncd automatically)

Default value

TRUE

Automatic start of DAS daemon/service

Section

[DAS]

Parameter

enable

Description

Determines whether unidasd, the Directory Access daemon/service, automatically starts when the calendar server is brought up. The unidasd daemon/service is required only for installations that connect to a directory server.

Accepted values

TRUE (start unidasd automatically)

FALSE (do not start unidasd automatically)

Default value

FALSE

Time to sleep on start-up

Section

[CWS]

Parameter

startupsleep

Description

Specifies the number of seconds the Corporate-Wide Services daemon/service waits (sleeps) at start-up before attempting to process any requests. This delay is intended to provide enough time for the SNC daemon/service to start up and establish the necessary connections to nodes. Increasing the value of this parameter may be necessary for servers with many nodes or connections, or where the bandwidth is low.

Accepted values

A positive integer

Default value

60

Sleep time between checks on request queue

Section

[CWS]

Parameter

noreqsleep

Description

Specifies the number of seconds the Corporate-Wide Services daemon/service waits (sleeps) when there are no requests in the local queue. After that time, the unicwsd again checks its queue for pending requests. This setting affects how long it takes to propagate data, such as remote user invitations, to other nodes. A low value may slow down the uniengd.

Accepted values

A positive integer up to a maximum value of (232 -1)

Default value

60

Maximum time spent processing requests per node

Section

[CWS]

Parameter

maxtimepernode

Description

Determines the maximum time, in seconds, that the CWS daemon/service spends processing requests for the same node. After it processes each request, the CWS daemon/service checks the total time it has spent processing requests for the node. If the total time exceeds maxtimepernode, the CWS daemon/service moves on to processing requests from another node, even if the current request queue is not empty. This ensures that the CWS daemon/service treats all nodes fairly, and ensures a more uniform replication delay for calendar data.

Accepted values

A positive integer

Default value

30

Interval between checks for reminders

Section

[NOTIFY]

Parameter

checkreminderinterval

Description

Determines the interval, in minutes, that the CWS daemon/service waits between checks for reminders.

Accepted values

A positive integer

Default value

2

Reminders to ignore

Section

[NOTIFY]

Parameter

ignoreoldreminders

Description

Determines which reminders the CWS daemon/service ignores when it checks for reminders. It ignores all reminders older than the number of minutes (from the current time) specified by this parameter.

Accepted values

A positive integer

Default value

30

Maximum time to check a node for reminders

Section

[NOTIFY]

Parameter

limitremindercheck

Description

Specifies the maximum amount of time, in seconds, that the CWS daemon/service spends at one time checking a node for reminders.

Accepted values

A positive integer

Default value

30

Number of connections to directory server

Section

[<YOURHOSTNAME>,unidas]

Parameter

numconnect

Description

Specifies the number of connections to establish to the directory server. A number of variables must be considered when setting this parameter. Guidelines are provided for installations contained within the following configuration:

Guidelines:

Administrators of installations that do not match the specified configuration should contact Oracle support for further assistance in setting this parameter.

Accepted values

Any positive integer up to a maximum value of 255

Default value

5

Timeout for connecting to directory server

Section

[<YOURHOSTNAME>,unidas]

Parameter

connect_timeout

Description

Determines the number of seconds the unisncd will wait before returning a timeout error when attempting to start the unidasd to connect to the directory server.

Accepted values

0 (no timeout)

A positive integer

Default value

10

SNC to DAS connection retries

Section

[ENG]

Parameter

dac_maxretry

Description

Specifies the maximum number of retries the SNC daemon/service makes when attempting to establish a connection to the DAS daemon/service.

Accepted values

0 (no retries)

Any positive integer up to a maximum value of (232-1)

Default value

3

Maximum number of connections

Section

[SNC]

Parameter

max_socket

Description

Specifies the maximum number of connections the SNC daemon/service brokers among nodes in the node network.

Consult Oracle Support before setting this parameter. In most cases you instantiate all of the connections configured in the nodes.ini file. In certain configurations where you have a large number of nodes on the same machine, this parameter reduces the number of connections used, and thereby the amount of memory required, to instantiate the node network. Each connection has a socket and a uniengd process associated with it so the fewer the connections, the fewer the number of processes and sockets required. See "Connecting nodes" in Chapter 6 of your calendar server's Administrator's Guide for guidelines on the number of connections to configure in the nodes.ini file.

Set this parameter high enough to ensure there is at least one connection from each node in the network to every other node in the network. Tune based on usage statistics.

The [<YOURHOSTNAME>, unidas] numconnect parameter configures the total number of connections to the DAS daemon/service that the SNC daemon/service brokers.

Accepted values

(UNIX)

A positive integer up to the maximum imposed by the following equation:

<flimit> - <#nodes> - 5 - numconnect

where:

This equation ensures the SNC daemon/service has sufficient resources to establish connections to both nodes and to the DAS daemon/service. A value well under this maximum is recommended to avoid possible problems related to values close to operating system limits.

(NT)

A positive integer up to a maximum value of 250.

Default value

(UNIX)

<flimit> - <#nodes> - 5 - numconnect

(NT)

250

Number of minutes to wait for remote node connection

Section

[SNC]

Parameter

wait_sbh

Description

Specifies the number of minutes to wait if the SNC daemon/service is not able to connect to a remote node.

Accepted values

A positive integer

Default value

5

Number of requests that are reset at a time

Section

[SNC]

Parameter

request_chunk_size

Description

Specifies the number of requests that are reset at a time by the SNC daemon/service. When the SNC daemon/service establishes a connection, it examines the request queue of each local node and resets all requests labelled CANTSERVICE to NOTSERVICED. To minimize the time that another process may be made to wait for access to the node database while the SNC daemon/service resets the request queue (which is in the node database), this parameter allows the resetting to be performed in "chunks" of requests.

Accepted values

A positive integer

Default value

25

Block size for communications

Section

[SNC]

Parameter

snc_tr_block

Description

Specifies the block size, in bytes, to use for communications between a uniengd server and a unidasd server. Do not change this value without first consulting Oracle support.

Accepted values

0 (use internal default value)

A positive integer

Default value

0

Time-out for received transmissions

Section

[SNC]

Parameter

snc_tr_recv_timeout

Description

Specifies the time-out value, in seconds, for received transmissions.

Accepted values

0 (require an immediate response)

A positive integer

Default value

5

Time-out for sent transmissions

Section

[SNC]

Parameter

snc_tr_send_timeout

Description

Specifies the time-out value, in seconds, for sent transmissions.

Accepted values

0 (require an immediate response)

A positive integer

Default value

0

Size of the socket layer receive buffer

Section

[SNC]

Parameter

snc_so_rcvbuf

Description

Specifies the size, in bytes, of the socket layer receive buffer. Do not change this value without first consulting Oracle support.

Accepted values

0 (use internal default value)

A positive integer

Default value

0

Size of the socket layer send buffer

Section

[SNC]

Parameter

snc_so_sndbuf

Description

Specifies the size, in bytes, of the socket layer send buffer. Do not change this value without first consulting Oracle support.

Accepted values

0 (use internal default value)

A positive integer

Default value

0

Idle connections

Section

[SNC]

Parameter

snc_so_keepalive

Description

Determines whether or not the system keeps idle connections active.

If this parameter is set to TRUE, a network packet is sent periodically to determine whether or not the process on the other end of an idle connection is still running. If no acknowledgement is received from that process within a specified period of time, it is assumed to have terminated and the connection is no longer maintained.

If this parameter is set to FALSE, periodic checking on idle connections is not done, and the connections are maintained indefinitely.

Accepted values

TRUE (check idle connections)

FALSE (do not check idle connections)

Default value

TRUE

Statistics logging: user connections

Section

[ENG]

Parameter

activity

Description

Specifies whether or not to log signons and signoffs. The resulting log is useful for tracking server usage and for monitoring possible security violations. If you enable logging, you should closely monitor the size of the log file (/users/unison/log/act.log), as it can grow quickly.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

FALSE

Statistics logging: user sessions

Section

[ENG]

Parameter

stats

Description

Specifies whether or not to log user session statistics (CPU consumption, user wait times, and network traffic). If you enable logging, you should closely monitor the size of the log file (/users/unison/log/stats.log), as it can grow quickly.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

FALSE

Character set for log files

Section

[ENG]

Parameter

localcharset

Description

Defines the character set to use for data in log files. For example, if you set this parameter to MSCP932, the server will print all of the logs in the /users/unison/log directory in MSCP932.

This parameter is only checked if [ENG] utf8_autoconvert is set to TRUE.

It is recommended that you set this parameter to the same character set you use for the client. Using two different character sets increases the amount of memory required (both character sets must be loaded) and can affect performance.

Accepted values

HPROMAN

HPROMAN8

ISO-8859-1

MAC-JAPANESE

MAC-ROMAN

MSCP1252

MSCP932 (MSCP932 is a slight variation on Shift_JIS)

Shift_JIS

T61

UTF8

Default value

UTF8

Logging: verbose switch

Section

[CWS]

Parameter

trace

Description

Determines how much information is written to the unicwsd daemon/service log file (/users/unison/log/cws.log).Set this parameter to TRUE to enable a more verbose style of logging whereby each transaction performed by the CWS daemon/service is logged. This causes the log file to grow rapidly and should only be used for a short time for testing or debugging purposes.

Accepted values

TRUE (enable verbose logging)

FALSE (disable verbose logging)

Default value

FALSE

Statistics logging: unidasd

Section

[DAS]

Parameter

stats

Description

Determines whether unidasd statistics are generated and logged to the dasstats.log and the dsstats.log files. If you enable logging, you should closely monitor the size of the log files, as they can grow quickly.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

FALSE

Logging of failure errors

Section

[ENG]

Parameter

dac_failederrlog

Description

Determines whether errors related to directory server access that appear in the client interface as "unexpected error" are logged to the /users/unison/log/eng.log file.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

TRUE

Logging of configuration errors

Section

[ENG]

Parameter

dac_configerrlog

Description

Determines whether three directory server access errors are logged to the /users/unison/log/eng.log file. The three errors are: "unable to connect to the SNC daemon/service," "no connections to the directory access (DAS) daemon/service are currently available," and "the number of retries to obtain a connection has been attained; no connections to the directory access (DAS) daemon/service are configured."

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

TRUE

Logging of miscellaneous errors

Section

[ENG]

Parameter

dac_miscerrlog

Description

Determines whether three types of directory server access errors related to the client are logged to the /users/unison/log/eng.log file. The three errors are: password discrepancy due to changes made in the directory server through another application; an LDAP client-side error; an LDAP server-side error.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

TRUE

Logging of non-critical errors

Section

[ENG]

Parameter

dac_ignorederrlog

Description

Determines whether non-critical directory server access errors are logged to the /users/unison/log/eng.log file.

Accepted values

TRUE (enable logging)

FALSE (disable logging)

Default value

TRUE

Logging of failure to instantiate UTF-8 conversion functionality

Section

[ENG]

Parameter

utf8_onfailprintmesg

Description

Determines whether an error message is logged to /users/unison/log/eng.log if the server is unable to instantiate UTF-8 conversion functionality for a given user session. Enough information is logged in the error message to determine why the functionality could not be created.

Accepted values

TRUE (log an error message)

FALSE (do not log an error message)

Default value

TRUE

Enable item retrieval from directory server

Section

[ENG]

Parameter

dac_itemget

Description

Determines whether item retrieval (from a search or a signon) is from the directory server or the internal cache. The internal cache gives better performance, but the item may be slightly out of date.

Accepted values

TRUE (retrieve items from the directory server)

FALSE (retrieve items from the internal cache)

Default value

TRUE

Enable conversion of data to UTF-8 format

Section

[ENG]

Parameter

utf8_autoconvert

Description

Determines whether input data from the client is converted and stored in UTF-8 format by the server.

WARNING: Setting this parameter to FALSE can have adverse effects in installations that support clients on more than one platform or of more than one language.

Accepted values

TRUE (convert input data to UTF-8)

FALSE (do not convert input data)

Default value

TRUE

Number of pages in the database cache

Section

[DB]

Parameter

db_pages

Description

Specifies the number of pages for the database cache. The greater the value, the greater the amount of memory used and the better the performance. As the number increases beyond a certain point, the performance enhancement returns diminish.

Accepted values

A positive integer

Default value

8

Maximum number of database files open per user

Section

[DB]

Parameter

db_files

Description

Specifies the number of database files that may be open at any time for one user session. Increasing this number can improve performance in cases when this limit is repeatedly encountered.

Accepted values

A positive integer up to the maximum set by the operating system for number of open files per process.

Default value

(UNIX)

30

(NT)

170

Node database template

Section

[DBI]

Parameter

dbi_name

Description

Specifies the name of an empty node database to use as a template for node creation. Set during installation, this value should not be edited or removed.

Accepted values

n/a

Default value

n/a

Node database version

Section

[DBI]

Parameter

dbversion

Description

Specifies the node database version number. Set during installation, this value should not be edited or removed.

Accepted values

n/a

Default value

n/a

Database version number

Section

[<YOURNODEID>]

Parameter

version

Description

Specifies the version of the node database. This is a reference value set automatically during node creation. It must NEVER be manually edited.

Accepted values

n/a

Default value

n/a

Specify alternate backup utility

Section

[UTL]

Parameter

external_backup

Description

Specifies an alternate backup utility for unidbbackup to invoke. The server uses the value of this parameter to construct the following command line:

<external_backup value> [-f] -s <src> -d <dst>

where

The generated command line must be valid. It may be that you require an intermediate script to take this command line, create one which is valid, and then invoke the valid one. In this case, you set the value of external_backup to the appropriate value for invoking the intermediate script.

Accepted values

A valid path and file name

Default value

None

Specify alternate restore utility

Section

[UTL]

Parameter

external_restore

Description

Specifies an alternate restore utility for unidbrestore to invoke. The server uses the value of this parameter to construct the following command line:

<external_restore value> [-f] -s <src> -d <dst>

where

The generated command line must be valid. It may be that you require an intermediate script to take this command line, create one which is valid, and then invoke the valid one. In this case, you set the value of external_restore to the appropriate value for invoking the intermediate script.

Accepted values

A valid path and file name

Default value

None

Backup operation timeout

Section

[UTL]

Parameter

backup_timeout

Description

Sets the maximum time, in seconds, that unidbbackup will keep any node database locked when using an external backup utility. If a node database is locked for longer than this value, unidbbackup will abort the entire backup operation. This parameter is only used when an alternate backup utility is specified using the [UTL] external_backup parameter. When the unidbbackup utility backs up the calendar database itself, the node backup time is not limited.

Note that the total backup time can easily exceed this value when multiple nodes are involved, since each individual node can take up to this amount of time.

Accepted values

A positive integer

Default value

3600

Restore operation timeout

Section

[UTL]

Parameter

restore_timeout

Description

Sets the timeout, in seconds, for the restore operation on the database.

Accepted values

A postive integer

Default value

3600

Node alias(es)

Section

[<YOURNODEID>]

Parameter

aliases

Description

Specifies the name or names of the nodes configured on a server. When multiple nodes are configured on a server, users must indicate to which node they want to connect. Since, in general, a name is easier to remember than a numeric node-ID, aliases can be configured.

WARNING: Administrators of Lexacom Enterprise Calendar Server installations should avoid changing this parameter once set.

Accepted values

A list of one or more aliases to a maximum of 255 characters, where each alias is an alphanumeric string containing at least one letter and no spaces, and each alias in the list is separated from the next by a comma.

Default value

None

Node name

Section

[<YOURNODEID>]

Parameter

name

Description

Specifies the name of the root directory for the node database found under /users/unison/db/nodes/<name>. The value of this parameter is automatically generated during node creation. The first node created is labelled `N0', the second `N1', and following up to `N9'. Subsequent nodes continue the cycle through the alphabet from O to Z and then from A to L.

Accepted values

A code composed of a letter (A-Z) and a number (0-9)

Default value

n/a

Node time zone

Section

[<YOURNODEID>]

Parameter

timezone

Description

Indicates the time zone of the node. The server sets this parameter when it creates the node. Its value should never be changed.

The server sets this parameter to either the time zone specified by the administrator upon creation of the node, or, if the administrator does not specify one, the value of the [TIMEZONE] default parameter.

The timezone parameter allows nodes in a node network to have different time zones.

Accepted values

n/a

Default value

None

Relative DN for individual domains

Section

[<YOURNODEID>]

Parameter

relativedn

Description

Lexacom Enterprise Calendar Server only. Determines a location for the domain associated with this node in the LDAP hierarchy relative to the calendar server base DN.

Accepted values

Any valid DN, to a maximum of 255 characters.

Default value

None

Coexistence of LDAP and non-LDAP nodes

Section

[ENG]

Parameter

dir_internal_nodes

Description

Identifies all nodes with an internal directory in an installation where the network requires the coexistence of nodes using an LDAP directory and those with their own internal directory.

Accepted values

Valid node-IDs, separated by a comma and enclosed within {}. For example: dir_internal_nodes = {10000,10001}

Default value

n/a

User mail mapping

Section

[ENG]

Parameter

usermailmap

Description

Specifies the attribute in the user record that contains users' e-mail addresses. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 key

Default value

None

Resource mail mapping

Section

[ENG]

Parameter

resourcemailmap

Description

Specifies the attribute in the resource record that contains resources' e-mail addresses. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 key

Default value

None

User mobile phone number mapping

Section

[ENG]

Parameter

usermobilemap

Description

Specifies the attribute in the user record that contains users' mobile phone numbers. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 key

Default value

None

User mobile phone type mapping

Section

[ENG]

Parameter

usermobiletypemap

Description

Specifies the attribute in the user record that contains users' mobile phone types. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 key

Default value

None

User alert preference mapping

Section

[ENG]

Parameter

usersmscprefmap

Description

Specifies the attribute in the user record that contains users' preferred notification formats. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 key

Default value

None

X.400 field for UID

Section

[ENG]

Parameter

itemuidmap

Description

Determines which X.400 field(s) holds the calendar server unique UID. Installations requiring 64 bytes for this information can use the two X.400 fields OU1 and OU2. Do not change the value of this parameter once it has been set. Doing so may result in database corruption. For installations using the calendar server's internal directory only.

Accepted values

A valid X.400 field name

OU1_OU2

Default value

None

Maximum number of items to search

Section

[ENG]

Parameter

userlookthroughlimit

Description

Specifies the maximum number of items (users or resources) the calendar server searches through before ending a search and returning the results to the client.

Accepted values

A positive integer up to a maximum value of 4294967295

Default value

4294967295

Maximum number of items to return

Section

[ENG]

Parameter

usersearchmaxreturn

Description

Specifies the maximum number of items (users or resources) in a search result. Once the search result contains this number of items, the server ends the search and returns the results to the client.

Accepted values

A positive integer up to a maximum value of 4294967295

Default value

4294967295

Timeout for event search

Section

[ENG]

Parameter

eventsearch_maxlookthroughlimit

Description

Specifies the maximum time in milliseconds to spend searching events. For native clients v. 5.0 or greater.

Accepted values

A positive integer

Default value

5000

Maximum number of events to return

Section

[ENG]

Parameter

evsearch_maxcount

Description

Specifies the maximum number of events to return from a search. For native clients v. 5.0 or greater.

Accepted values

A positive integer greater than 10.

Default value

25

Search event comments

Section

[ENG]

Parameter

eventsearch_commentsearchlength

Description

Specifies the maximum number of bytes to search through in an event's comments, starting at the beginning. For native clients v. 5.0 or greater.

Accepted values

0 (Disables searching in comments)

A positive integer

Default value

4096

Mail notification

Section

[ENG]

Parameter

notify

Description

Determines whether or not notification by SMTP-based UNIX mail is performed on event creation. This parameter applies only to pre-3.0 versions of the client.

Accepted values

TRUE (enable notification)

FALSE (disable notification)

Default value

TRUE

Set mail transport

Section

[CWS]

Parameter

smtpmail

Description

Determines whether mail notifications are sent using the SMTP mail server. This parameter should always be set to TRUE, regardless of whether mail notification is enabled. Mail notification is enabled or disabled using the [LIMITS] mail parameter.

This parameter supercedes unixmail. For backwards compatibility, if smtpmail is not set, and a value for the unixmail parameter can be found, that value is used.

Accepted values

TRUE (use the SMTP mail server)

FALSE (do not use the SMTP mail server)

Default value

FALSE

Set mail transport (obsolete)

Section

[CWS]

Parameter

unixmail

Description

This parameter is superceded by [CWS] smtpmail.

Mail program

Section

[CWS]

Parameter

smtpmailprogram

Description

Specifies the mail utility for transferring messages to the SMTP mail server. This parameter supercedes unixmailprogram. For backwards compatibility, if smtpmailprogram is not set, and a value for the unixmailprogram parameter can be found, that value is used.

Accepted values

(UNIX)

sendmail

postmail

(NT)

sendmail.exe

Default value

(UNIX)

sendmail

(NT)

sendmail.exe

Mail program (obsolete)

Section

[CWS]

Parameter

unixmailprogram

Description

This parameter is superceded by [CWS] smtpmailprogram.

Pathname of the mail program

Section

[CWS]

Parameter

smtpmailpath

Description

Specifies the directory pathname of the local mail utility. This parameter supercedes unixmailpath. For backwards compatibility, if smtpmailpath is not set, and a value for the unixmailpath parameter can be found, that value is used.

Accepted values

A valid pathname

Default value

(UNIX)

/usr/lib

(NT)

/users/unison/bin

Pathname of the mail program (obsolete)

Section

[CWS]

Parameter

sendmailpath

Description

This parameter is superceded by [CWS] smtpmailpath.

Host name of the SMTP mail server

Section

[CWS]

Parameter

smtpmailhost

Description

Specifies the name of the host on which the SMTP mail server is running. This parameter is meaningful only under NT. It supercedes [CWS] mailhost. For backwards compatibility, if smtpmailhost is not set, and a value for the mailhost parameter can be found, that value is used.

Accepted values

A valid host name

Default value

The host name of the machine on which the calendar server is running.

Host name of the SMTP mail server (obsolete)

Section

[CWS]

Parameter

mailhost

Description

This parameter is superceded by [CWS] smtpmailhost.

Maximum number of recipients

Section

[CWS]

Parameter

smtpmailmaxrecipients

Description

Specifies the maximum number of recipients for a mail message. If a mail is to be sent with more recipients than the value of this parameter, the CWS will split the list of recipients and call the sendmail program multiple times.

See also the [CWS] smtpmailmaxcommandlinesize parameter.

Accepted values

A positive integer

Default value

100

Maximum size for sendmail command lines

Section

[CWS]

Parameter

smtpmailmaxcommandlinesize

Description

Specifies the maximum size of the buffer passed to the sendmail program as a command-line argument. If the buffer size required is larger than this value, the CWS will split the list of recipients and call the sendmail program multiple times.

See also the [CWS] smtpmailmaxrecipients parameter.

Accepted values

A positive integer

Default value

1024

Automatic deletion of temporary file for last mail message

Section

[CWS]

Parameter

mailfiledelete

Description

Determines whether the temporary file containing the last sent mail message is deleted after the mail is sent. This parameter may be useful to check the calendar server behaviour if you are experiencing a problem with mail delivery.

The temporary file in which the server writes the last mail message can be found at /users/unison/tmp/MAILMSG.

Accepted values

TRUE (delete mail messages automatically)

FALSE (do not delete mail messages automatically)

Default value

TRUE

Content of the "From:" field of the mail header

Section

[CWS]

Parameter

mailhdroriginatorfromuser

Description

Determines whether the "From:" field of the mail header is the e-mail address of the sender.

Accepted values

TRUE ("from" field is same as "reply-to" field)

FALSE ("from" field is set to "unison,unison")

Default value

TRUE

UTF-8 for names in "To:" field of mail header

Section

[CWS]

Parameter

mailhdrtoname

Description

Determines whether or not to include names along with addresses in the "To:" field of the mail header. While addresses are constructed using ASCII characters (and hence present no display problem for mail readers), names may contain non-ASCII characters. In cases where the mail reader is unable to display the non-ASCII characters properly, it may be preferable to simply remove the names from the "To:" field altogether.

Accepted values

TRUE (include names)

FALSE (do not include names)

Default value

TRUE

Character set for content portion of mail message

Section

[CWS]

Parameter

mimecontentcharset

Description

Determines the character set to use to encode the content and subject portion of all MIME mail messages sent by the CWS daemon/service. For example, if you set the value of this parameter to MAC-ROMAN, the content and subject portions of all messages sent by the CWS daemon/service will be in MAC-ROMAN.

Accepted values

"CN-GB"

"HPROMAN"

"HPROMAN8"

"ISO-8859-1"

"MAC-JAPANESE"

"MAC-ROMAN"

"MSCP1252"

"MSCP932"

"Shift_JIS"

"T61"

"UTF8"

Note that the enclosing quotation marks must be present.

Default value

"ISO-8859-1"

Character set conversion for e-mail

Section

[CWS]

Parameter

emailcharsetmap

Description

A mapping table determining what client character sets to convert before sending e-mail. If the character set used by a client is not in this list, then the value of [CWS] mimecontentcharset is used for e-mail sent by that client.

If this parameter is left blank, the following mapping table will be used:

MSCP932     -->  ISO-2022-JP 
EUC-JP      -->  ISO-2022-JP 
SHIFT-JIS   -->  ISO-2022-JP 
ISO-2022-JP -->  ISO-2022-JP 
MSCP936     -->  ISO-2022-CN 
EUC-CN      -->  ISO-2022-CN 
HP15CN      -->  ISO-2022-CN 
CN-GB       -->  ISO-2022-CN 

In other words, clients with the MSCP932, EUC-JP, SHIFT-JIS and ISO-20220-JP character sets will send e-mail in ISO-2022-JP; clients with the MSCP936, EUC-CN, HP15CN and CN-GB character sets will send e-mail in ISO-2022-CN.

If the [CWS] emailcharsetmap parameter is used to specify a mapping, that value will be added to this default table, overriding the default values only where necessary. For example, if the value of this parameter were set to {"MSCP932": "SHIFT-JIS"}, all clients using the MSCP932 character set would send mail in SHIFT-JIS, overriding the default mapping listed above. All other mappings listed in the table would still be in effect.

Accepted values

A list of charset mappings separated by commas and enclosed in {}, with the following syntax: "<charset used by client>": "<charset used for e-mail>"

Default value

See above

Character set for content portion of mail message

Section

[LOCALE]

Parameter

charset

Description

Determines the character set to use to encode the content portion of the mail message.

Accepted values

HPROMAN

HPROMAN8

ISO-8859-1

MAC-JAPANESE

MAC-ROMAN

MSCP1252

MSCP932

Shift_JIS

T61

UTF8

Default value

ISO-8859-1

Short Message Service (SMS) notification program

Section

[CWS]

Parameter

smsnotifyprogram

Description

Specifies the file name and location of the sendalert utility the calendar server uses to send alerts to Oracle's wireless delivery services.

Accepted values

Any valid path and file name

Default value

none

Short Message Service (SMS) notification program arguments

Section

[CWS]

Parameter

smsnotifyprogramparam

Description

Specifies the command-line argument that will be passed to the sendalert utility configured by the [CWS] smsnotifyprogram parameter.

Use this parameter to indicate to the sendalert utility the host name and port of your Oracle 9iAS PIM Notification Dispatcher. For details on how to find out the host name and port number of your Oracle 9iAS PIM Notification Dispatcher, see the "Alerts" chapter of your calendar server Administrator's Guide.

Accepted values

"-host <hostname> -port <portnumber>"

Default value

none

Default time zone

Section

[TIMEZONE]

Parameter

default

Description

Specifies the local time zone.

Accepted values

Any time zone that appears in the /users/unison/misc/timezone.ini file (e.g. EST-5EDT)

Default value

None

Time zone rules

Section

[TIMEZONE]

Parameter

rules

Description

Specifies the name of the file containing time zone rules.

Accepted values

A valid fully-specified file name

Default value

/users/unison/misc/timezone.ini

Checksum of the time zone rules file

Section

[TIMEZONE]

Parameter

checksum

Description

Contains the checksum of the time zone rules file. This value is preset and must not be altered under any circumstance.

Accepted values

n/a

Default value

n/a

Node connection types

Section

[DOMAIN]

Parameter

type

Description

Controls the possibility of connecting nodes. When set to corporate or portal, nodes may be connected only in a single network or cluster. When set to asp, all nodes are always disconnected and may not be linked in a node network.

Accepted values

asp

corporate

portal

Default value

corporate

Master node

Section

[CLUSTER]

Parameter

masternode

Description

Specifies a master node for the cluster.

Accepted values

A valid node-ID belonging to any node in the cluster

Default value

None

Remote master node

Section

[CLUSTER]

Parameter

remotemasternode

Description

Specifies the master node in the cluster. This parameter speeds up the replication of information to the master node when users are created using uniuser.

Accepted values

A valid node-ID belonging to any node in the cluster

Default value

None

Excluded nodes for on-line registration

Section

[CLUSTER]

Parameter

excludednodes

Description

Determines what nodes are excluded from on-line user registration. The server will not create users on listed nodes. Use this parameter to avoid registering users on your cluster's master node, or on nodes that are reaching maximum capacity.

Accepted values

A list of valid node-IDs or aliases belonging to any nodes in the cluster, separated by commas and enclosed in {}. For example:

{ 14, 446, 447 }

Default value

{ }

Allow SYSOP logons from uniical

Section

[ENG]

Parameter

allowsysoplogon_uniical

Description

Specifies whether uniical users may log in to the server as SYSOP.

Accepted values

TRUE (SYSOP logons allowed)

FALSE (SYSOP logons not allowed)

Default value

TRUE

Allow SYSOP logons from unicp utilities

Section

[ENG]

Parameter

allowsysoplogon_unicp

Description

Specifies whether users of the unicp* family of utilities may log in to the server as SYSOP.

Accepted values

TRUE (SYSOP logons allowed)

FALSE (SYSOP logons not allowed)

Default value

TRUE

Allow SYSOP logons for CAPI applications

Section

[ENG]

Parameter

allowsysoplogon_capi

Description

Specifies whether applications using Oracle's Calendar API (CAPI) can log in to the server as SYSOP.

Accepted values

TRUE (SYSOP logons allowed)

FALSE (SYSOP logons not allowed)

Default value

FALSE

Controlling server interactions with directory server

Set directory service

Section

[DAS]

Parameter

dir_service

Description

Specifies the directory service that the unidasd daemon/service accesses. The value of this parameter is also found as the name of the section in the /user/unison/misc/unison.ini file where the configuration parameters for the directory service are found. For example, if dir_service = LDAP, the [LDAP] section of the unison.ini file contains the LDAP directory service configuration parameters.

Accepted values

LDAP

Default value

LDAP

Name of directory server

Section

[LDAP]

Parameter

dsa

Description

Specifies the name of the LDAP directory server. This parameter is set during installation. Changing the value of this parameter may result in directory server corruption.

Accepted values

OID (Oracle Internet Directory)

Default value

None

Name of directory server host

Section

[LDAP]

Parameter

host

Description

Specifies the name of the machine hosting the LDAP directory server. If failovers for the directory server have been configured, they may be listed here. By default, the calendar server will attempt to establish a connection to the first server listed; if unable to do so, it will try the next.

Accepted values

A valid host name, fully-qualified domain name, or IP address

A list of directory servers, in the form "<hostname>[:<port>] <hostname>[:<port>]" For example:

"host1:389 host2:389"

Default value

None

Port number of the LDAP directory server

Section

[LDAP]

Parameter

port

Description

Specifies the port number of the LDAP directory server. If the [LDAP] host parameter contains a port number, the value of the [LDAP] port parameter will be ignored.

Accepted values

A valid port number

Default value

389

Character set used by the directory server

Section

[LDAP]

Parameter

charset

Description

Indicates the character set the LDAP directory server uses. This is the character set that the calendar server must use for data destined for the LDAP directory server.

Accepted values

HPROMAN

HPROMAN8

ISO-8859-1

MAC-JAPANESE

MAC-ROMAN

MSCP1252

MSCP932

Shift_JIS

T61

UTF8

Default value

UTF-8

LDAP protocol version

Section

[LDAP]

Parameter

attr_version

Description

Specifies the LDAP protocol version used by the directory server. Set the value of this parameter to 2 only if your LDAP directory server does not support the LDAPv3protocol.

Accepted values

2 (for LDAPv2)

3 (for LDAPv3)

Default value

3

Permissions for modifying directory server attributes

Section

[<YOURHOSTNAME>,unidas]

Parameter

dir_adminmodcalonly

Description

Specifies whether the calendar server's reserved users can modify all directory server attributes or only the calendar attributes in the directory server.

Accepted values

TRUE (permit modifications to calendar attributes only)

FALSE (permit modifications to all attributes)

Default value

FALSE

Permissions for updating directory server attributes

Section

[<YOURHOSTNAME>,unidas]

Parameter

dir_adminupdcalonly

Description

Specifies whether the calendar server's reserved users can update all directory server attributes or only the calendar attributes in the directory server.

Accepted values

TRUE (permit updates to calendar attributes only)

FALSE (permit updates to all attributes)

Default value

FALSE

Attribute preserve list

Section

[LDAP]

Parameter

attrpreservelist

Description

Specifies a list of attributes (a "preserve list") which are not to be deleted when a calendar user is deleted (i.e. when the user's calendar attributes as well as their ctCalUser object class are deleted). If the calendar user entries also use the inetOrgPerson object class, you should configure this parameter as follows:

{employeeNumber, givenName, initials, mail, ou}

Any fields mapped to attributes outside of the ctCalUser object class (e.g. attr_organization = uid) should also be added to the "preserve list".

Accepted values

A list of strings, separated by commas and enclosed in {}, where each string in the list is the name of a user attribute

Default value

{}

Calendar unique user identifier mapping

Section

[LDAP]

Parameter

attr_uid

Description

Determines the directory server attribute name that the calendar server uses as a unique user identifier. Do not change the value of this parameter unless you also change the attribute your Oracle Internet Directory uses to authenticate SSO logins. If you change that attribute on your directory server, you must change the value of this parameter.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

uid

Name of the "country" attribute

Section

[LDAP]

Parameter

attr_country

Description

Determines the attribute name that the LDAP directory server uses for the "country" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

None

Name of the "generation qualifier" attribute

Section

[LDAP]

Parameter

attr_generation

Description

Determines the attribute name that the LDAP directory server uses for the "generation qualifier" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

generationQualifier

Name of the "organization" attribute

Section

[LDAP]

Parameter

attr_organization

Description

Determines the attribute name that the LDAP directory server uses for the "organization" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

None

Name of the "given name" attribute

Section

[LDAP]

Parameter

attr_givenname

Description

Determines the attribute name that the LDAP directory server uses for the "given name" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

givenName

Name of the "mail" attribute

Section

[LDAP]

Parameter

attr_mail

Description

Determines the attribute name that the LDAP directory server uses for the "mail" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

mail

Name of the "uid" attribute

Section

[LDAP]

Parameter

attr_uid

Description

Determines the attribute name that the LDAP directory server uses for the "uid" attribute.

Accepted values

Any attribute name defined in the LDAP directory server schema

Default value

uid

Name of group object class

Section

[LDAP]

Parameter

groupobjectclass

Description

Determines the name of the object class for the group of calendar server administrators.

Accepted values

groupOfUniqueNames

Default value

groupOfUniqueNames

Name of "member" attribute in group object class

Section

[LDAP]

Parameter

groupmemberattribute

Description

Determines the name of the "member" attribute that is in the object class specified by the groupobjectclass parameter.

Accepted values

uniqueMember

Default value

uniqueMember

Location of the calendar server administrators

Section

[LDAP]

Parameter

admin

Description

Specifies part of the Distinguished Name (DN) of the location under which calendar server administrators will be created. The DN of this location is constructed by appending the value of the basedn parameter to the value of the admin parameter. For example, where admin = "ou=calendar servers" and basedn = "o=acme", the DN for the location under which calendar server administrators will be created is "ou=calendar servers, o=acme".

Accepted values

A valid Distinguished Name or Relative Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Group entry for calendar server administrators

Section

[LDAP]

Parameter

admingroup

Description

Specifies part of the Distinguished Name (DN) of the group entry for calendar server administrators (the administrators are added to this group). The DN of the group entry is constructed by appending the value of the basedn parameter to the value of the admingroup parameter. For example, where admingroup = "cn=calendar server admins" and basedn = "o=acme", the DN for the group entry of calendar server administrators is "cn=calendar server admins, o=acme".

Accepted values

A valid Distinguished Name or Relative Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

cn=Calendar Server Admins

Distinguished Name of the subtree containing calendar server entries

Section

[LDAP]

Parameter

basedn

Description

Specifies the Distinguished Name of the LDAP directory server subtree containing calendar entries.

Accepted values

A valid Distinguished Name of a maximum of 255 characters (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Relative Distinguished Name for resources

Section

[LDAP]

Parameter

resourcerelativedn

Description

Specifies a location for resources in the LDAP directory relative to the calendar server base DN (specified by the value of the [LDAP] basedn parameter).

If a full Distinguished Name is specified when creating a new resource, that value will be used and the value of this parameter will be disregarded.

Accepted values

A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Resource Relative DN for individual domains

Section

[<YOURNODEID>]

Parameter

resourcerelativedn

Description

For Lexacom Enterprise Calendar Server only. Specifies the Resource Relative DN in which to locate resources for the domain associated with this node. This DN is relative to the domain's Relative DN (see the [YOURNODEID] relativedn parameter).

For all servers, if a full Distinguished Name is specified when creating a new resource, that value will be used and the value of this parameter will be disregarded.

Accepted values

A valid Distinguished Name of a maximum of 255 characters (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Distinguished Name used for anonymous connections

Section

[LDAP]

Parameter

binddn

Description

Specifies the Distinguished Name the LDAP directory server uses for anonymous connections.

Accepted values

A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Distinguished Name of the directory server administrator

Section

[LDAP]

Parameter

mgrdn

Description

Specifies the Distinguished Name of the LDAP directory server administrator.

Accepted values

A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Password used for anonymous connections

Section

[LDAP]

Parameter

bindpwd

Description

Specifies the password for the LDAP user specified by the value of the [LDAP] binddn parameter.

You must encrypt the password using the uniencrypt utility before entering it in the unison.ini file. See the uniencrypt documentation in Appendix C, "Utilities". The encrypted password must be preceded by the encrpytion method used to generate it (acipher in most cases) and enclosed in double-quotes.

Accepted values

"{acipher}<encrypted_value>"

Default value

None

Distinguished Name used for write operations

Section

[LDAP]

Parameter

writedn

Description

Specifies the Distinguished Name the calendar server uses for all write operations on the directory server.

Accepted values

A valid Distinguished Name (see your LDAP directory server documentation for further information on the correct form)

Default value

None

Password used for LDAP write connections

Section

[LDAP]

Parameter

writednpassword

Description

Specifies the password for the LDAP user specified by the value of the [LDAP] writedn parameter.

You must encrypt the password using the uniencrypt utility before entering it in the unison.ini file. See the uniencrypt documentation in Appendix C, "Utilities". The encrypted password must be preceded by the encrpytion method used to generate it (acipher in most cases) and enclosed in double-quotes.

Accepted values

"{acipher}<encrypted_value>"

Default value

None

Modification of user password

Section

[UTL]

Parameter

adm_moduserpassword

Description

Determines whether the calendar server administrator can modify the password of a calendar user.

Accepted values

TRUE (can modify the password)

FALSE (cannot modify the password)

Default value

TRUE

Directory server support for ldap_compare() requests

Section

[LDAP]

Parameter

dsausesearchtocompare

Description

Indicates whether the LDAP directory server handles ldap_compare() calls properly or must use ldap_search() calls to simulate ldap compare() calls.

Accepted values

TRUE (uses ldap_search() calls)

FALSE (handles ldap_compare() calls properly)

Default value

FALSE

Search filter for groups

Section

[LDAP]

Parameter

groupfilter

Description

Specifies the LDAP filter the calendar server uses when searching groups in the directory server.

The default value of this parameter exposes all groups to the calendar client; users will be able to see all groups in the directory server, and any members of those groups who are also calendar users. However, if there are groups in the directory server that consist entirely of non-calendar users, the calendar client will display these groups with no members.

To avoid this, you may wish to create a custom object class such as "calendarGroup", and apply this object class only to the LDAP groups that you wish to be visible through the calendar client. Then, extend the value of this parameter to include that object class. For example, the new value might be:

(&(member=*)(objectclass=groupOfNames)(objectclass=calendarGroup))

For more details, see Chapter 3 of your calendar server Administrator's Guide.

Accepted values

Any valid filter, up to a maximum length of 150 characters

Default value

(&(uniqueMember=*)(objectclass=groupOfUniqueNames))

Maximum time to wait on an LDAP call

Section

[LDAP]

Parameter

timelimit

Description

Specifies the maximum time, in seconds, that the server waits on an LDAP call before returning a timeout error to the client. Note that the timeout settings in the directory server take precedence over this parameter.

Accepted values

0 or a positive integer. A value of 0 means no timeout ever occurs and causes the server to wait until the directory server returns either a result or an error.

Default value

120

Enable SSL connections

Section

[LDAP]

Parameter

security

Description

Enables SSL connections to the LDAP directory server. If this parameter is set to TRUE, the calendar server uses the LDAPSSL functions contained in the libraries specified by the [LDAP] ldapssllibname and [LDAP] lberssllibname parameters to connect to the directory server. Otherwise it uses the LDAP functions contained in the libraries specified by the [LDAP] ldaplibname and [LDAP] lberlibname parameters to connect to the directory server.

Accepted values

TRUE (enable SSL connections)

FALSE (disable SSL connections)

Default value

FALSE

Port to use for SSL connections

Section

[LDAP]

Parameter

secure-port

Description

Determines the port to use for SSL connections. This parameter is only checked if [LDAP] security is set to TRUE.

Accepted values

Any value in the range 1 to 65535

Default value

636

Location of file containing trusted certificates

Section

[LDAP]

Parameter

certdbpath

Description

Specifies the path and/or file name of the file containing the certificates used by the SSL. This parameter is only used when the value of the [LDAP] security parameter is set to TRUE.

Accepted values

A valid path and file name

A valid file name

cert7.db (the database file used by Netscape Communicator 4.x and up)

A valid path name. In this case the calendar server adds the file name cert7.db to the path.

Note that on Windows platforms, any path information specified in the value of this parameter must use UNIX syntax, with forward-slashes '/' instead of backslashes '\', and omitting the drive letter from the beginning of the string. The file must also exist on the same drive as the calendar server installation directory.

Default value

cert7.db

Controlling client behaviour

Allow agenda attachments

Section

[LIMITS]

Parameter

allowattachments

Description

Determines whether or not the client allows attachments for meetings or tasks.

Accepted values

TRUE (allow attachments)

FALSE (do not allow attachments)

Default value

FALSE

Maximum size of attachments

Section

[LIMITS]

Parameter

maxattachmentsize

Description

Determines the maximum size, in bytes, for attachments to meetings, tasks and other agenda entries. This parameter is only checked if the [LIMITS] allowattachments parameter is set to TRUE. Suggested value is 102400 (100K).

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

232-1

Minimum interval for checks for new agenda entries (client-side enforcement)

Section

[LIMITS]

Parameter

autocontrol

Description

Determines the minimum number of minutes that a user can set as the interval between agenda refresh calls to the server (i.e. between each check for new agenda entries).

If this value is less than lck_users/60, the value of lck_users/60 takes precedence, to a maximum value of 45. For example, if autocontrol = 15 and lck_users = 1200, no refresh occurs before 20 (i.e. 1200/60) minutes has elapsed.

Note that this parameter has been superseded by the [CLIENT] minrefreshrate parameter, which enforces the behaviour on the server side instead of on the client side. It is included here for backward compatibility with older clients.

Accepted values

Any positive integer up to a maximum value of (216-1)

Default value

15

Minimum interval for checks for new agenda entries (server-side enforcement)

Section

[CLIENT]

Parameter

minrefreshrate

Description

Determines the minimum number of minutes that a user can set as the interval between agenda refresh calls to the server (i.e. between each check for new agenda entries).

Note that this value overrides the [LIMITS] autocontrol parameter, and does not take into account the value of the [LCK] lck_users parameter as autocontrol does.

Note also that setting the value of this parameter too low can have serious consequences upon the performance of the calendar system. The more system resources and database access time are devoted to automatic idle refreshes, the slower the perceived performance of on-demand requests can become. Tune this parameter according to the number of logged-on users you experience at peak hours, and according to the number of database requests per second your hardware can comfortably accommodate.

For example, if testing has established acceptable performance benchmarks at one automatic refresh request per second, then for an environment of 1000 users, this parameter should not be set to an interval lower than 1000 seconds, or approximately seventeen minutes. The value provided at installation time should serve as an acceptable limit for all but the most exceptional installations.

Accepted values

Any positive integer up to a maximum value of (216-1)

Default value

15

Maximum number of instances for a repeating meeting, daily note, or day event (client-side)

Section

[LIMITS]

Parameter

maxrecur

Description

Specifies the maximum number of instances the client allows a user to create for a single repeating meeting, daily note, or day event.

This parameter is now outdated. For Windows and Macintosh clients v. 5.0 and above, use the [ENG] maxinstances parameter instead to control this behaviour. However, it is recommended that you ensure the [LIMITS] maxrecur and [ENG] maxinstances parameters be set to the same value, to ensure full compatibility between all clients.

Accepted values

A positive integer up to a maximum value of (232-1)

Default value

60 (60 instances per meeting, note, or day event)

Maximum number of instances of a recurring meeting, daily note, or day event (server-side)

Section

[ENG]

Parameter

maxinstances

Description

Determines the maximum number of instances of a recurring meeting, daily note, or day event the calendar server can create. It is recommended that you ensure the [LIMITS] maxrecur parameter be set to the same value as [ENG] maxinstances to ensure full compatibility between all clients.

Accepted values

An integer in the range 1-65535

Default value

100

Maximum lead time on a reminder

Section

[LIMITS]

Parameter

maxremleadtime

Description

Specifies the maximum number of days in advance of an event that a user can set a reminder to ring.

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

21

Double-booking resources (client-side)

Section

[LIMITS]

Parameter

resourceconflicts

Description

Determines whether the client allows users to double-book resources. This parameter should always be set with the same value as the[ENG] allowresourceconflict parameter.

Accepted values

TRUE (allow double-bookings)

FALSE (do not allow double-bookings)

Default value

TRUE

Double-booking resources (server-side)

Section

[ENG]

Parameter

allowresourceconflict

Description

Determines whether the server allows double-booking of resources. This parameter should always be set with the same value as the[LIMITS] resourceconflicts parameter.

Accepted values

TRUE (allow double-bookings)

FALSE (do not allow double-bookings)

Default value

FALSE

Default agenda view

Section

[LIMITS]

Parameter

agendaview

Description

Determines the default view in which the client opens agenda windows. For clients 4.1 and above.

Accepted values

0 (day view)

1 (week view)

2 (month view)

Default value

0

Maximum number of open windows

Section

[LIMITS]

Parameter

maxwinopen

Description

Determines the maximum number of windows (views) that can be opened at the same time in the user interface.

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

7

Maximum number of users in a group view

Section

[LIMITS]

Parameter

groupviewmax

Description

Specifies the maximum number of users that the client can display in a group view.

Accepted values

A positive integer up to the value of (232-1)

Default value

100

Allow resources in remote nodes to appear as local

Section

[<YOURNODEID>]

Parameter

localnodes

Description

Specifies which remote resources to consider local for client scheduling purposes. If you want users on separate but connected nodes to view and treat all resources as local (a common situation when two or more nodes are in close geographic proximity), enter the relevant node-ID(s) after this parameter. Nodes must be connected to enable this feature.

Accepted values

Valid node-IDs, separated by a comma

Default value

n/a

Case-sensitivity of passwords

Section

[ENG]

Parameter

passwords

Description

Determines whether client password verification is case-sensitive. Only used for installations using the calendar server's internal directory.

Accepted values

case (case sensitive)

ignorecase (case insensitive)

Default value

case

Allow automatic sign-in

Section

[LIMITS]

Parameter

ssignin

Description

Determines whether a user can use the desktop clients' automatic sign-in feature to sign in to the calendar server without providing a password. For Windows clients 4.2 and above and Macintosh clients 4.5 and above.

See also the [LIMITS] ssigninrestrictions parameter.

Accepted values

TRUE (allow automatic sign-in)

FALSE (force user to always supply a password)

Default value

FALSE

Restrictions on automatic sign-in

Section

[LIMITS]

Parameter

ssigninrestrictions

Description

Restricts the automatic sign-in feature of desktop clients to secure operating systems. The automatic sign-in feature will be unavailable for clients running on Windows 95/98 and Mac OS 7/8.

See also the [LIMITS] ssignin parameter.

Accepted values

TRUE (restrict automatic sign-in to secure operating systems)

FALSE (allow automatic sign-in from any operating system)

Default value

TRUE

Password aging

Section

[LIMITS]

Parameter

maxpasswordage

Description

Controls password aging. The value represents the number of days that a password can exist before users are required to change it.

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

76543 (for all practical purposes, password aging is OFF)

Maximum number of sign-in attempts

Section

[LIMITS]

Parameter

signinmaxattempts

Description

Determines how many unsuccessful sign-in attempts are allowed before the client closes. Native clients v. 5.0 and greater only.

Accepted values

An integer between 1 and 232

Default value

5

Show multiple user matches on sign-in

Section

[LIMITS]

Parameter

userlist_login

Description

Determines whether or not to show a list of matching users when more than one fits the specified sign-in credentials. Native clients v. 6.0 and greater only.

Accepted values

TRUE (Display the list of matching users)

FALSE (Don't display the list)

Default value

TRUE

Secure sign-in

Section

[LIMITS]

Parameter

secure-login

Description

Determines whether or not to restrict information given about incorrect sign-in credentials. Native clients v. 6.0 and greater and Web clients v. 3.0 and greater only.

Accepted values

TRUE (Display only that the credentials supplied are incorrect)

FALSE (Display more user-friendly error messages on incorrect sign-in)

Default value

FALSE

Single local storage

Section

[LIMITS]

Parameter

singlelst

Description

Disables the client's Different Local Storage dialog. If this parameter is set to TRUE, only one user may access the calendar server from a given client machine. If another user tries to sign in, he or she will be forced to quit the application.

Accepted values

TRUE (disable different local storage)

FALSE (allow different local storage)

Default value

FALSE

Allow users to update only calendar attributes

Section

[DAS]

Parameter

dir_updcalonly

Description

Determines whether users can update only calendar attributes, or calendar and non-calendar attributes within their entries.

Accepted values

TRUE (permit updates only to calendar attributes)

FALSE (permit updates to any attributes)

Default value

FALSE

Force DAS sign-on and sign-off for read-only operations

Section

[DAS]

Parameter

dir_itembindonread

Description

Forces the Directory Access Server to sign in to the directory server for read-only operations (e.g. searching).

Read operations are carried out using the anonymous profile. If that profile has limited rights, directory server searches will be constrained by those rights.

Note that write operations always require a bind.

Accepted values

TRUE (demand credentials for searches)

FALSE (permit searches without calling credentials)

Default value

FALSE

Right to create public groups

Section

[LIMITS]

Parameter

pubgroups

Description

Determines whether users holding the necessary access rights can create public groups.

Accepted values

TRUE (permit users to create public groups)

FALSE (do not permit users to create public groups)

Default value

TRUE

Permission to change default timezone

Section

[LIMITS]

Parameter

settimezone

Description

Determines whether the user is permitted to save time zone changes for future client sessions.

Accepted values

TRUE (permit users to set a different time zone)

FALSE (do not permit users to set a different time zone)

Default value

FALSE

Enable mail notification

Section

[LIMITS]

Parameter

mail

Description

Determines whether mail notification is enabled, regardless of how the client is set up.

Accepted values

TRUE (enable mail notification)

FALSE (disable mail notification)

Default value

TRUE

Short Message Service (SMS) alerts

Section

[NOTIFY]

Parameter

sms

Description

Determines whether wireless alerts are enabled. See your calendar server Administrator's Guide for details on the available wireless alert services.

Accepted values

TRUE (enable SMS notification)

FALSE (disable SMS notification)

Default value

FALSE

Maximum number of people in a mail notification distribution list

Section

[LIMITS]

Parameter

maxmaildistr

Description

Specifies the maximum number of users in a mail notification distribution list.

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

30

Minimum number of characters in the Surname edit box

Section

[LIMITS]

Parameter

mincharsearch

Description

Determines the minimum number of search characters that the user must supply in the Surname field when performing a directory search from the client. The default value of 0 allows a user to execute a search without limits and retrieve the complete database of users.

Accepted values

0

A positive integer up to a maximum value of (232-1)

Default value

0

Maximum number of search results displayed

Section

[LIMITS]

Parameter

maxsearchresult

Description

Determines the maximum number of items (users or resources) that the search dialogue box lists in both the calendar clients and the Admin GUI. Tune this parameter relative to the size of your installation. If you use an external directory server, tune this parameter to match any search limits configured in the directory server. Consult the relevant CorporateConnect appendix for your directory server, or your directory server documentation to determine what these limits are and how to configure them.

Accepted values

Any positive integer up to the value of (232-1)

Default value

100 (list only 100 entries at a time)

"Next" button in search dialogue box

Section

[LIMITS]

Parameter

page-forward

Description

Determines whether the "next" button is enabled in the item search dialogue box for users and resources of the calendar clients and the Admin GUI.

When a search is performed, the [LIMITS] maxsearchresult parameter determines the maximum number of search results to return to the client. Assume page-forward is TRUE, maxsearchresult is set to 100, and you search for all users whose surname begins with "S". If there are 220 such users in the database, the search dialogue will present you with the first 100 users. You may then click on the "next" button to see the next 100 users, and click again to see the last 20.

This functionality is disabled when the server is connected to a directory server.

Accepted values

TRUE (enable the "next" button)

FALSE (disable the "next" button)

Default value

TRUE

"Previous" button in search dialogue box

Section

[LIMITS]

Parameter

page-backward

Description

Determines whether the "previous" button is enabled in the search dialogue box for users and resources. This button performs the reverse operation of the [LIMITS] page-forward parameter, allowing the user to return to previously-listed entries of the search result.

This functionality is disabled when the calendar server is connected to a directory server.

Accepted values

TRUE (enable the "previous" button)

FALSE (disable the "previous" button)

Default value

TRUE

Size of the client event search result window

Section

[ENG]

Parameter

eventsearch_clientwindowsize

Description

Specifies the number of rows in the client's event search result list box. For native clients v. 5.0 or greater.

Accepted values

A positive integer

Default value

20

Number of days preceding current date to consult or return for queries

Section

[OUTLOOK_CONNECTOR]

Parameter

eventselectbegin

Description

For Oracle Outlook Connector only. Sets the number of days preceding the current date that will be searched or returned for all database queries.

Accepted values

Any positive integer up to the value of the number of days between the current date and January 1, 1991.

Default value

180

Number of days following current date to consult or return for queries

Section

[OUTLOOK_CONNECTOR]

Parameter

eventselectend

Description

For Oracle Outlook Connector only. Sets the number of days following the current date that will be searched or returned for all database queries.

Accepted values

Any positive integer up to the value of the number of days between the current date and December 31, 2037.

Default value

730

Enable address books

Section

[GENPREFS]

Parameter

offlineab

Description

For native clients 5.1 and above. Enables and disables the use of address books.

Accepted values

TRUE (enable address books)

FALSE (disable address books)

Default value

TRUE

Enable publishing of address books

Section

[LIMITS]

Parameter

publishab

Description

For clients 4.1 and above. Enables the publishing of address books.

Accepted values

TRUE (enable the publishing of address books)

FALSE (disable the publishing of address books)

Default value

TRUE

Maximum number of personal address book entries

Section

[LIMITS]

Parameter

maxpersabentries

Description

For clients 4.0 and above. Determines the maximum number of personal address book entries.

Accepted values

Any positive integer up to a maximum value of (232-1)

Default value

2000

Maximum number of entries in a folder

Section

[QUOTA]

Parameter

maxfolderentryperuser

Description

Determines the maximum number of entries in an address book folder.

Accepted values

0 (no entries)

A positive integer up to a maximum value of (232-1)

Default value

2000

Refresh intervals and agenda ranges

Section

[ENG]

Parameter

eventrefreshintervals

Description

Configures the refresh intervals and agenda ranges, in seconds, that Oracle Outlook Connector uses when it queries the server for new events.

This parameter is a list of intervals, separated by commas and enclosed in {}. Each interval in the list has the following format:

: -<lower bound> +<upper bound>

where <interval>, <lower bound> and <upper bound> are all expressed in seconds. The <interval> determines the refresh interval. The <lower bound> and <upper bound> determine a range of time.

Every <interval> specifies a time when the calendar server should refresh Outlook with the associated range of agenda data. For example, the entry {900: -0 +172800} specifies that every 15 minutes (<interval> of 900 seconds) the server should refresh Outlook with an agenda range beginning at the current time (<lower bound> of 0 seconds) and continuing through 2 days following (<upper bound> of 172800 seconds).

Accepted values

<interval>, <lower bound> and <upper bound> are integers in the range 0-65535

Default value

{0: -86400 +518400, 2700: -604800 +10886400, 79200: -0 +0}

The first interval specifies that all client-initiated queries for events have a minimum agenda range of one day previous (-86400) through to six days (+518400) following the time of the query. The second interval tells the client to query the server every 45 minutes (2700) for events in the range of one week previous (-604800) to six weeks (+10886400) from the time of the query. The third interval tells the client to query the server every 22 hours (79200) for all events.

On-line help display

Section

[LIMITS]

Parameter

browserhelp

Description

For Windows clients version 4.5 or greater. Displays the on-line help in an ordinary web browser rather than the Microsoft HTML Help Viewer. If a browser is specified by the [WEBLINK] browser-path-win parameter, that browser is used.

For best results, please ensure that Java and Javascript are enabled in the browser.

Accepted values

TRUE (Forces on-line help to be displayed in a browser)

FALSE (Displays on-line help in Microsoft's HTML Help Viewer, if installed; if not, displays on-line help in a browser)

Default value

FALSE

Enabling web access

Section

[WEBLINK]

Parameter

mode

Description

Determines whether web access is enabled in the client, and how it is configured. This functionality gives Windows and Macintosh clients the ability to access and display a web page.

If this parameter is set to custom, ALL of the other [WEBLINK] parameters must have values specified in the unison.ini file. If this is not the case, the value of this parameter reverts to the default (cst).

Accepted values

off or cst (disable web access)

custom (enable web access and take values for all of the other [WEBLINK] parameters from unison.ini.)

Default value

cst

Browser to launch for Windows clients

Section

[WEBLINK]

Parameter

browser-path-win

Description

For Windows clients, this parameter determines which browser to launch for web access. For Windows clients 4.5 and greater, it also determines a browser for the on-line help when [LIMITS] browserhelp is set to TRUE, or when Microsoft HTML Help Viewer is not installed. This parameter determines the location of the web browser on the local machine of each signed-on user.

Accepted values

A valid path and filename

Default value

None

Text to appear in Help menu and ToolTip

Section

[WEBLINK]

Parameter

command-name

Description

Determines the text string that appears in the Help menu for the web access item, as well as in the pop-up ToolTip accompanying the Toolbar web access icon.

Accepted values

A string with a maximum of 150 characters in length

Default value

(when [WEBLINK] mode = cst) Product Information

On-line command description

Section

[WEBLINK]

Parameter

command-description-online

Description

For Windows clients, determines the description of the web access command that appears on the status bar when the client is on-line. For Macintosh clients 4.2 or earlier, determines the description of the web access command that appears in balloon help when the client is on-line.

Accepted values

A string with a maximum of 150 characters in length

Default value

(when [WEBLINK] mode = cst) Click here to access product information on the web.

Off-line command description

Section

[WEBLINK]

Parameter

command-description-offline

Description

For Windows clients, determines the description of the web access command that appears on the status bar when the client is off-line. For Macintosh clients 4.2 and earlier, determines the description of the web access command that appears in balloon help when the client is off-line.

Accepted values

A string with a maximum of 150 characters in length.

Default value

(when [WEBLINK] mode = cst) Click here to access product information on the web.

File transfer protocol

Section

[WEBLINK]

Parameter

download-mode

Description

Determines the file transfer protocol to use when downloading the web pages for viewing in off-line mode.

Accepted values

file (use the file sharing protocol)

Default value

(when [WEBLINK] mode = cst) file

Web page to load for clients working on-line

Section

[WEBLINK]

Parameter

online-url

Description

Determines the web page to load for clients working on-line.

Accepted values

A valid URL with a maximum of 150 characters in length

Default value

None

Source of web pages for Windows clients in off-line mode

Section

[WEBLINK]

Parameter

offline-source-win

Description

For Windows clients. Determines the source of the web page to display when working in off-line mode. This parameter is only checked when [WEBLINK] mode = custom.

Accepted values

A valid path and file name with a maximum of 150 characters in length

Default value

None

Source of web pages for Mac clients in off-line mode

Section

[WEBLINK]

Parameter

offline-source-mac

Description

For Macintosh clients. Determines the source of the web page to display when working in off-line mode.

Accepted values

A string with a maximum of 150 characters in length which obeys the following format and restrictions:

<user>:<pw>@[<zone>]:<AFP Server Name>[,<ip>[,<port>]];<volume path>:

where:

This parameter is only checked when [WEBLINK] mode = custom.

Default value

None

Version of off-line web page

Section

[WEBLINK]

Parameter

offline-source-version

Description

Determines the version of the off-line web page. This provides a mechanism for the administrator to ensure that the most recent version of the off-line web page is the one being accessed. This parameter is only checked when [WEBLINK] mode = custom.

Accepted values

A character string with a maximum length of 150 characters.

Default value

None

Error message to display if download fails

Section

[WEBLINK]

Parameter

download-fail

Description

Determines the error message to display if a download fails.

Accepted values

A character string with a maximum length of 150 characters.

Default value

(when [WEBLINK] mode = cst) Your on-line account did not supply all the information needed to support this operation. Please contact your system administrator.

Enabling French-language web access

Section

[WEBLINK-FRENCH]

Parameter

mode

Description

Determines whether French-language web access is enabled in the client, and how it is configured. This functionality gives Windows and Macintosh clients the ability to access and display a web page.

If this parameter is set to custom, ALL of the other [WEBLINK-FRENCH] parameters must have values specified in the unison.ini file. If this is not the case, the value of this parameter reverts to the default (cst).

Accepted values

off or cst (disable web access)

cst (enable web access and take the values for all of the other [WEBLINK-FRENCH] parameters directly from the code; ignore any values set in the unison.ini file for these other parameters)

custom (enable web access and take values for all of the other [WEBLINK-FRENCH] parameters from unison.ini.)

Default value

cst

French-language browser to launch for Windows clients

Section

[WEBLINK-FRENCH]

Parameter

browser-path-win

Description

For Windows clients, this parameter determines which browser to launch for French-language web access. This parameter determines the location of the web browser on the local machine of each signed-on user.

Accepted values

A valid path and filename

Default value

None

French-language text to appear in Help menu and ToolTip

Section

[WEBLINK-FRENCH]

Parameter

command-name

Description

Determines the French-language text string that appears in the Help menu for the web access item, as well as in the pop-up ToolTip accompanying the Toolbar web access icon.

Accepted values

A string with a maximum of 150 characters in length

Default value

(when [WEBLINK-FRENCH] mode = cst) Information sur le produit

On-line French-language command description

Section

[WEBLINK-FRENCH]

Parameter

command-description-online

Description

For Windows clients, determines the description of the web access command that appears on the status bar when the client is on-line. For Macintosh clients 4.2 or earlier, determines the description of the web access command that appears in balloon help when the client is on-line.

Accepted values

A string with a maximum of 150 characters in length

Default value

(when [WEBLINK-FRENCH] mode = cst) Lancer le navigateur Web pour visualiser l'information sur le produit

Off-line French-language command description

Section

[WEBLINK-FRENCH]

Parameter

command-description-offline

Description

For Windows clients, determines the description of the web access command that appears on the status bar when the client is on-line. For Macintosh clients 4.2 or earlier, determines the description of the web access command that appears in balloon help when the client is on-line.

Accepted values

A string with a maximum of 150 characters in length

Default value

(when [WEBLINK-FRENCH] mode = cst) Lancer le navigateur Web pour visualiser l'information sur le produit

French-language web page to load for clients working on-line

Section

[WEBLINK-FRENCH]

Parameter

online-url

Description

Determines the French-language web page to load for clients working on-line.

Accepted values

A valid URL with a maximum of 150 characters in length

Default value

None

File transfer protocol

Section

[WEBLINK-FRENCH]

Parameter

download-mode

Description

Determines the file transfer protocol to use when downloading web pages for viewing in off-line mode.

Accepted values

file (use the file sharing protocol)

Default value

(when [WEBLINK-FRENCH] mode = cst) file

Source of French-language web pages for Windows clients in off-line mode

Section

[WEBLINK-FRENCH]

Parameter

offline-source-win

Description

For Windows clients. Determines the source of the web page to display when working in off-line mode. This parameter is only checked when [WEBLINK-FRENCH] mode = custom.

Accepted values

A valid path and file name with a maximum of 150 characters in length

Default value

None

Source of French-language web pages for Mac clients in off-line mode

Section

[WEBLINK-FRENCH]

Parameter

offline-source-mac

Description

For Macintosh clients. Determines the source of the web page to display when working in off-line mode.

Accepted values

A string with a maximum of 150 characters in length which obeys the following format and restrictions:

<user>:<pw>@[<zone>]:<AFP Server Name>[,<ip>[,<port>]];<volume path>:

where:

This parameter is only checked when [WEBLINK-FRENCH] mode = custom.

Default value

None

Version of French-language off-line web pages

Section

[WEBLINK-FRENCH]

Parameter

offline-source-version

Description

Determines the version of the off-line web page. This provides a mechanism for the administrator to ensure that the most recent version of the off-line web page is the one being accessed. This parameter is only checked when [WEBLINK-FRENCH] mode = custom.

Accepted values

A character string with a maximum length of 150 characters.

Default value

None

Error message to display if download fails

Section

[WEBLINK-FRENCH]

Parameter

download-fail

Description

Determines the error message to display if a download fails.

Accepted values

A character string with a maximum length of 150 characters.

Default value

(when [WEBLINK-FRENCH] mode = cst) Le telechargement s'est acheve correctement. Les fichiers de mode déconnecte ont ete restaures.

Controlling client connections to server

Enable the ACE framework

Section

[ACE]

Parameter

frameworkenable

Description

Enables authentication, compression, and encryption. Note that if you disable the ACE module, the calendar server uses the built-in cs-basic authentication method. In other words, the calendar server always uses an authentication method.

Accepted values

TRUE (enable authentication, compression, encryption)

FALSE (disable authentication, compression, encryption)

Default value

TRUE

Maximum number of shared libraries per type

Section

[ACE]

Parameter

slibcachecount

Description

Determines the number of shared libraries that can be loaded at the same time for each type of method (authentication, compression, encryption).

Due to a limitation of IBM AIX in which shared libraries cannot be reloaded once removed from memory, the default value of this parameter is higher than for other platforms.

Accepted values

A positive integer up to a maximum value of 32768

Default value

20 (IBM AIX only)

3 (all other platforms)

Minimum buffer size for compression

Section

[ACE]

Parameter

minbufsizetocompress

Description

Specifies the minimum size in bytes required in order for a buffer to be compressed.

Accepted values

A positive integer up to a maximum value of 32768

Default value

700

Buffer size for compression and encryption

Section

[ACE]

Parameter

workbufsize

Description

Specifies the size, in bytes, of the buffer to allocate for compression and encryption.

Accepted values

A positive integer up to a maximum value of 32768

Default value

4096

Supported authentication methods for clients

Section

[AUTHENTICATION]

Parameter

supported

Description

Specifies a list of the authentication methods the calendar server supports for clients.

Both the cs-basic and the cs-standard methods use the calendar server name and password of a user to authenticate that user. Both encrypt the user password; cs-standard also encrypts the user name. This encryption is independent of the negotiated encryption method. The server applies the negotiated encryption on top of this encryption.

The cs-basic authentication method works with all calendar clients, regardless of client version. It pre-dates the calendar server ACE module.

cs-standard is the recommended authentication method to use where the client supports it. It offers a higher level of security (better authentication and encryption) than cs-basic.

Only the cs-basic and cs-standard methods currently work with LDAP directory servers.

Accepted values

A list of one or more of the following, separated by commasand enclosed in {}:

cs-basic

cs-standard

Default value

{cs-basic, cs-standard}

Default authentication method for clients

Section

[AUTHENTICATION]

Parameter

default

Description

Specifies the default authentication method the calendar server uses for clients. See the description of the [AUTHENTICATION] supported parameter for more information on supported methods.

Accepted values

Any method in the list specified by the [AUTHENTICATION] supported parameter.

Default value

cs-standard

Default authentication method for administrators

Section

[AUTHENTICATION]

Parameter

admindefault

Description

Specifies the default authentication method the calendar server uses for administrative sessions using the Calendar Administrator. See the description of the [AUTHENTICATION] supported parameter for more information on supported methods.

Accepted values

Any method in the list specified by the [AUTHENTICATION] supported parameter.

Default value

The value of the [AUTHENTICATION] default parameter

Default authentication method for other servers

Section

[AUTHENTICATION]

Parameter

servicedefault

Description

Specifies a default encryption method for the calendar server to use for communications with other calendar servers that request connections.

The server uses this default, along with the list of supported encryption methods, when it negotiates ACE methods with another calendar server initiating a request.

Accepted values

Any method in the list of supported encryption methods specified by the [AUTHENTICATION] supported parameter.

Default value

The value of the [AUTHENTICATION] default parameter.

Location of resource passwords for authentication

Section

[AUTHENTICATION]

Parameter

keepresourcepswincaldb

Description

Determines whether resource passwords are stored in the calendar server's internal database or in the database of the configured authentication mechanism.

Accepted values

TRUE (resource passwords stored in the calendar server database)

FALSE (resource passwords stored in the authentication mechanism database)

Default value

TRUE

Supported compression methods

Section

[COMPRESSION]

Parameter

supported

Description

Specifies a list of the compression methods the calendar server supports. Currently, only the Oracle cs-simple compression method is supported. This method uses simple run-length encoding compression, a very fast and efficient compression method for calendar data.

Accepted values

A list of one or more of the following, separated by commas and enclosed in {}:

cs-simple

none

Default value

{cs-simple, none}

Default compression method for clients

Section

[COMPRESSION]

Parameter

default

Description

Specifies the default compression method the calendar server uses for clients.

Accepted values

Any method in the list specified by the [COMPRESSION] supported parameter.

Default value

cs-simple

Default compression method for administrators

Section

[COMPRESSION]

Parameter

admindefault

Description

Specifies the default compression method the calendar server uses for administrative sessions using the Calendar Administrator. See the description of the [COMPRESSION] supported parameter for more information on supported methods.

Accepted values

Any method in the list specified by the [COMPRESSION] supported parameter.

Default value

The value of the [COMPRESSION] default parameter

Default compression method for other servers

Section

[COMPRESSION]

Parameter

servicedefault

Description

Specifies a default compression method for communications with other calendar servers that attempt to connect to this server.

The server uses this default, along with the list of supported compression methods, when it negotiates ACE methods with another calendar server initiating a request.

Accepted values

Any method in the list specified by the [COMPRESSION] supported parameter.

Default value

The value of the [COMPRESSION] default parameter.

Supported encryption methods

Section

[ENCRYPTION]

Parameter

supported

Description

Specifies a list of the encryption methods the calendar server supports.

The cs-light method scrambles data with a randomly generated key. It is very fast and offers minimal impact on performance, but is recommended for minimal-security installations.

The cs-acipher1 method is slower than the cs-light method, but offers much more secure encryption.

Accepted values

A list of one or more of the following, separated by commas and enclosed in {}:

cs-light

cs-acipher1

none

Default value

{cs-light, cs-acipher1, none}

Encryption methods requiring prior authentication

Section

[ENCRYPTION]

Parameter

needsauthenticate

Description

Specifies a list of encryption methods that require authentication prior to use. These methods are only available after the calendar client or another server authenticates itself to this calendar server. The initial ACE negotiation cannot include any of the methods listed by this parameter.

Accepted values

A list of any methods in the list specified by the [ENCRYPTION] supported parameter, separated by commas and enclosed in {}.

Default value

{}

Default encryption method for clients

Section

[ENCRYPTION]

Parameter

default

Description

Specifies the default encryption method the calendar server uses for clients.

Accepted values

Any method in the list specified by the [ENCRYPTION] supported parameter.

Default value

none

Default encryption method for administrators

Section

[ENCRYPTION]

Parameter

admindefault

Description

Specifies the default encryption method the calendar server uses for administrative sessions using the Calendar Administrator. See the description of the [ENCRYPTION] supported parameter for more information on supported methods.

Accepted values

Any method in the list specified by the [ENCRYPTION] supported parameter.

Default value

The value of the [ENCRYPTION] default parameter

Default encryption method for other servers

Section

[ENCRYPTION]

Parameter

servicedefault

Description

Specifies a default encryption method for the calendar server to use for communications with other calendar servers that request connections.

The server uses this default, along with the list of supported encryption methods, when it negotiates ACE methods with another calendar server initiating a request.

Accepted values

Any method in the list of supported encryption methods specified by the [ENCRYPTION] supported parameter.

Default value

The value of the [ENCRYPTION] default parameter.

Web authentication -- shared key

Section

[ACE_PLUGINS_SERVER]

Parameter

web_CAL_sharedkey

Description

Specifies the shared key to compare with the value of the client webcal.ini [ACE_PLUGINS_CLIENT] web_CAL_sharedkey parameter.

Accepted values

A valid path and file name

Default value

None

Maximum number of Engines

Section

[LCK]

Parameter

lck_users

Description

Specifies the maximum number of Engine processes permitted. The value of this parameter should be carefully considered. It must allow for enough Engines to service both client access and SNC connections; however setting the value higher than required wastes system resources.

Accepted values

A positive integer up to 2000 (NT) or 5000 (UNIX)

Default value

100

Maximum number of concurrent sessions by a given user

Section

[ENG]

Parameter

max_userlogons

Description

Specifies the maximum number of concurrent "named" sessions that each user may invoke. A session is "named" if it is associated with a specific user and "unnamed" if it is not associated with a specific user.

Accepted values

0 (no limit)

A positive integer

Default value

0

Number of concurrent sessions from a specific Internet address

Section

[ENG]

Parameter

max_addrlogons

Description

Specifies the maximum number of concurrent "unnamed" sessions that can be invoked by a single client, that is, from a single Internet address. A session is "named" if it is associated with a specific user and "unnamed" if it is not associated with a specific user.

Accepted values

0 (no limit)

A positive integer

Default value

0

Maximum read lock time before termination

Section

[ENG]

Parameter

readlocktimeout

Description

Determines the number of consecutive seconds that the server can lock the database for a client read request. If this maximum is exceeded, the uniengd server and the associated user session terminate, and the timeout is logged to eng.log.

Accepted values

0 (no limit)

A positive integer up to the value of (232-1)

Default value

60

Maximum write lock time before termination

Section

[ENG]

Parameter

writelocktimeout

Description

Determines the number of consecutive seconds that the server can lock the database for a client write request. If this maximum is exceeded, the uniengd server and the associated user session terminate, and the timeout is logged to eng.log.

Accepted values

0 (no limit)

A positive integer up to the value of (232-1)

Default value

60

Maximum read lock time before release

Section

[ENG]

Parameter

readmaxlocktime

Description

For newer operations, determines the number of consecutive milliseconds that an operation can hold a read lock on the calendar database. If this maximum is exceeded, the lock will be released. If the process has not been completed, it will then re-lock the calendar database.

Accepted values

0 (no limit)

A positive integer up to the value of (232-1)

Default value

250

Maximum write lock time before release

Section

[ENG]

Parameter

writemaxlocktime

Description

For newer operations, determines the number of consecutive milliseconds that an operation can hold a write lock on the calendar database. If this maximum is exceeded, the lock will be released. If the process has not been completed, it will then re-lock the calendar database.

Accepted values

0 (no limit)

A positive integer up to the value of (232-1)

Default value

150

Retry interval for remote data requests to server

Section

[LIMITS]

Parameter

remotewait

Description

Specifies the number of seconds the client waits before retrying a call to the server for data from a remote server.

Accepted values

A positive integer up to the value of (232-1)

Default value

2

Retry limit for remote data requests to server

Section

[LIMITS]

Parameter

remotemaxretry

Description

Specifies the number of retries of a request for remote node data that the client makes before returning an error.

Accepted values

A positive integer up to the value of (232-1)

Default value

5