Skip Headers
Oracle® Calendar Reference Manual
10g Release 1 (10.1.2)

Part Number B25486-03
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
Contact Us

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

2 Oracle Calendar Server Event Calendar Parameters

This chapter details the parameters available to configure default event calendar profiles in the $ORACLE_HOME/ocal/misc/eventcal.ini file. For details on how to implement event calendar profiles, see "Managing Event Calendar Accounts" in Chapter 9 of Oracle Calendar Administrator's Guide.

Each parameter's stated default value is used if that parameter is omitted from the 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.

Overview

The information that can be specified includes:

An event calendar is similar to a user's calendar account and can be accessed by signing in with the account password using any calendar client. The display preferences, refresh frequency and reminder preferences would apply in this case. The following table lists some of the values that can be set for event calendars. To display the complete list, use the uniuser utility with the -eventcal and -info parameters. See the uniuser documentation in Chapter 6, "Calendar Server Utilities".

Table 2-1 Event calendar profile parameters

Parameter Possible values Default value Description

ShowSunday

TRUE, FALSE

TRUE

Shows and hides Sundays

ShowSaturday

TRUE, FALSE

TRUE

Shows and hides Saturdays

TimeFormat

1 (24 hour),

2 (AM/PM)

2 (AM/PM)

Sets time display format

StartDay

00h00 to 24h00

08h00

Sets agenda start time for display

EndDay

00h00 to 24h00

18h00

Sets agenda stop time for display

TimeInc

5, 10, 15, 20, 30, 60 (minutes)

30 minutes

Defines time increment for day and week views

RefreshFrequency

0 ... 65536 (minutes)

15

Sets refresh frequency of client

DefaultReminder

0 (disabled),

1 (pop-up)

2 (pop-up and audible)

2

Controls use of Pop-up and Audible Reminders

TimeBeforeReminder

0, 2, 5, 10, 60, 120, 240 (minutes)

12, 24, 48, 96 (hours)

7, 14, 31 (days)

10

Sets reminder time for Default Reminder

SMSServiceEnable

TRUE, FALSE

TRUE

Enables wireless reminders

Language

en (English)

fr (French)

it (Italian)

es (Spanish)

fi (Finnish)

de (German)

pt (Portuguese)

ja (Japanese)

zh-CN (Chinese)

ko (Korean)

sv (Swedish)

pt-BR (Brazilian Portuguese)

nl (Dutch)

en

Determines the language used for reminder messages.

ViewNormalEvent

YES, NO, TIME

YES

Default security given to other users

ViewPersonalEvent

YES, NO, TIME

YES

Default security given to other users

ViewConfidentialEvent

YES, NO, TIME

TIME

Default security given to other users

ViewNormalTask

YES, NO

NO

Default security given to other users

ViewPersonalTask

YES, NO

NO

Default security given to other users

ViewConfidentialTask

YES, NO

NO

Default security given to other users

OU1

<Organizational Unit 1>

n/a

Value for directory address field

OU2

<Organizational Unit 2>

n/a

Same as OU1

OU3

<Organizational Unit 3>

n/a

Same as OU1

OU4

<Organizational Unit 4>

n/a

Same as OU1

O

<Organization>

n/a

Same as OU1

C

<Country>

n/a

Same as OU1

A

<Administrative Domain>

n/a

Same as OU1

P

<Private Domain>

n/a

Same as OU1

TimeZone

<Time zone>

value defined in unison.ini

Defines a time zone specifically for the event calendar

Designate0 ... Designate9

<User name>

n/a

Defines users who may act as designates for the new event calendar


Display preferences

ShowSunday = TRUE/FALSE 
ShowSaturday = TRUE/FALSE 

These parameters determine whether or not these days will be part of the week view on the client. The default is TRUE.

TimeFormat = 1/2 

This parameter determines whether or not time is displayed in military (24h) or standard (AM/PM) time. The default is 2 -- AM/PM.

StartDay = <time of day>

This parameter determines the first time slot displayed in the event calendar's agenda (day & week view only). Earlier time slots can still be viewed by using the vertical scroll bar. This does not affect the regular business hours of the event calendar's agenda. The default is 08h00.

EndDay = <time of day>

This parameter is used to define the last time slot displayed in a event calendar's agenda (day & week view only), although it has little effect given that other settings, such as StartDay, time slot increments and spacing height, also affect how little or how much of the day is displayed. Later time slots can still be viewed by using the vertical scroll bar. This does not affect the regular business hours of the event calendar's agenda. The default is 18h00.

TimeInc = <time_in_minutes> 

This parameter defines the time slot increment for the day & week views. Adjusting the value of this parameter affects how much of the day is displayed on the screen. Only the following values can be specified: 5, 10, 15, 20, 30, 60 (minutes). The default is 15 minutes.

Refresh frequency & reminder preferences

RefreshFrequency = <time_in_minutes> 

This parameter sets the refresh frequency of the client in minutes. A value of 0 would effectively disable the refresh. The default is 15 minutes.

Language = en (English) 
           fr (French) 
           it (Italian)
           es (Spanish)
           fi (Finnish)
           de (German)
           pt (Portuguese)
           ja (Japanese)
           zh-CN (Chinese)
           ko (Korean)
           sv (Swedish)
           pt-BR (Brazilian Portuguese)
           nl (Dutch)

Determines the language used for server-side reminder messages. For information about server-side reminders and user languages, see "About Calendar Alerts" in Chapter 13 of Oracle Calendar Administrator's Guide.

DefaultReminder = 0/1/2 

If set to 1, the default reminder for agenda entries and day events is set to Pop-up Reminder. If set to 2, it is Pop-up and Audible (beep). For tasks, only the default Task Due Reminder is set to Pop-up Reminder, the default task Start Reminder is NOT set. Furthermore, The daily notes default reminder is also not set. The default is 0, or no reminders.

TimeBeforeReminder = <time_in_minutes> 

This parameter is used to set the default reminder time. In other words, a value of 24 would mean that default reminders would appear 24 hours before the start of the event. Only the following values can be specified: 0, 2, 5, 10, 60, 120, 240 (minutes); 12, 24, 48, 96 (hours); 7, 14, 31 (days).

Default security to users

ViewNormalEvent = YES/NO/TIME 
ViewPersonalEvent = YES/NO/TIME
ViewConfidentialEvent = YES/NO/TIME 
ViewNormalTask = YES/NO (user profiles only)
ViewPersonalTask = YES/NO (user profiles only)
ViewConfidentialTask = YES/NO (user profiles only) 

The preceding parameters determine the default security rights granted to users when creating events or tasks of these designations in the event calendar. For example, if ViewNormalEvent were set to TIME, only the time slot of the event would be visible to users, not its title, location or description. Conversely, if ViewNormalEvent were set to YES, all details of the event would be visible to users. If ViewNormalEvent were set to NO, the event would not be visible at all to users.

The default value for all of the preceding parameters is NO.

All details of a public event are always visible to users. There is no way to modify this behavior using these parameters.

The ViewNormalEvent and ViewNormalTask settings map to the "Normal" Access Level on the client.

The ViewPersonalEvent and ViewPersonalTask settings map to the "Personal" Access Level on the client.

The ViewConfidentialEvent and ViewConfidentialTask settings map to the "Confidential" Access Level on the client.

Miscellaneous

TimeZone = <time zone> 

This parameter is used to define a different time zone for the event calendar.

Designates

A designate is a user assigned the right to modify the contents of an event calendar.

This section allows you to define designates for event calendars. Note that designates must exist in the database beforehand, and that there is a maximum of 10 designates in each section.

Designate0 = <designate_name> 
Designate1 = <designate_name> 
Designate2 = <designate_name> 
...
Designate9 = <designate_name> 

The <designate_name> argument is a string of the form "key=value/key=value/...", where "key" is one of those listed in the following table, and "value" is any string. Both "key" and "value" are case insensitive. The "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - for example,"S=Hoopla/OU1=R\/D".

If, in a UNIX environment, a shell will be processing the string (for example, the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they may need to be escaped (that is, preceded by the escape character "\") to prevent the shell from interpreting them.


Note:

If the ID key-value pair is specified in the user argument, all other key-value pairs specified along with it are ignored.

Some example specifications are: "S=Kilpi/G=Eeva", "S=B*/G=Nicole/O=Acme", "O=Acme/ID=1111/OU1=authors", "S=Austen/G=Jane/EMAIL=mr_darcy@freemail.org"

Table 2-2 Accepted keys for specifying designates

Key X.400 Field

S

Surname

G

Given name

I

Initials

ID

Identifier

X

Generation

OU1

Organizational Unit 1

OU2

Organizational Unit 2

OU3

Organizational Unit 3

OU4

Organizational Unit 4

O

Organization

C

Country

A

Administration domain

P

Private domain