Oracle® Calendar Reference Manual Release 2 (9.0.4) Part Number B10891-02 |
|
|
View PDF |
This appendix details the parameters available to configure default user and resource profiles in the $ORACLE_HOME/ocal/misc/user.ini
and $ORACLE_HOME/ocal/misc/resource.ini
files respectively. For details on how to implement user and resource profiles, see your calendar server's Administrator's Guide.
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.
The following table lists some of the values that can be set for users and resources. To display the complete list, use the uniuser
utility with the -info
parameter and the -user
or -resource
parameter. See the uniuser
documentation in Appendix F, "Calendar Server Utilities".
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 user'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 user. The default is 08h00.
EndDay = <time of day>
This parameter is used to define the last time slot displayed in a user'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 user. 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 your 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.
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.
MailNotification = TRUE/FALSE
This parameter specifies whether or not the user wants to receive mail notification. The effect of this attribute when set to FALSE
is to exclude the user's name from being automatically added to the list of recipients sent out by calendar clients. This does not apply to the Oracle Connector for Outlook client. Note, this setting has no effect on the users' own ability to send mail notification. The default is FALSE
.
ALERT-ENABLE=TRUE ALERT-HOLD=TRUE/FALSE ALERT-SUSPENDRANGEACTION=NONE/HOLD/DISCARD ALERT-SUSPENDRANGE=HH:MM-HH:MM
E-mail and alert reminders are not supported for resources and event calendars. The ALERT-ENABLE
parameter determines whether or not alert notifications and server side reminders are enabled for this user. The default value is "TRUE
".
Set ALERT-HOLD
to TRUE
to suspend all delivery of alert notifications and server side reminders immediately and for ever until this user attribute is reset to FALSE
. Set ALERT-SUSPENDRANGEACTION
parameter to HOLD
to suspend delivery of alert notifications and server side reminders for a given period of time. Specify the period of time using ALERT-SUSPENDRANGE
. To discard rather than holding any alerts triggered during the specified period, set ALERT-SUSPENDRANGEACTION
to DISCARD
. Use ALERT-SUSPENDRANGE
to specify the suspension period.
ALERT-NOTIFMEETING=TRUE/FALSE ALERT-NOTIFDAYEVENT=TRUE/FALSE ALERT-NOTIFDAILYNOTE=TRUE/FALSE ALERT-NOTIFJOURNAL=TRUE/FALSE ALERT-NOTIFOWNER=TRUE/FALSE ALERT-NOTIFDECLINED=TRUE/FALSE
These parameters specify whether or not the user wants to receive alerts notifications for meetings, day events, daily notes, journals that are updated (added, modified or deleted). Set ALERT-NOTIFOWNER
to FALSE
to exclude calendar entries that the user owns. Set ALERT-NOTIFDECLINED
to FALSE
to exclude calendar entries that the user has declined.
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. Consult the "Alerts" chapter of your Oracle Calendar Administrator's Guide for details on server-side reminders.
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, the reminder is pop-up and will include an 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).
REMINDER-SERVERALERT = TRUE/FALSE REMINDER-VISUAL = TRUE/FALSE REMINDER-AUDIBLE = TRUE/FALSE REMINDER-SERVERMAIL = TRUE/FALSE REMINDER-UPCOMING = TRUE/FALSE REMINDER-LEADTIME = <time_in_minutes>
These parameters determine whether reminders are enabled for this user for normal events. The leadtime for these reminders is set using REMINDER-LEADTIME
. Similar parameters exist for setting reminders for holidays, task start times, task due times, notes and day events:
REMINDERHOLIDAY-SERVERALERT = TRUE/FALSE REMINDERHOLIDAY-VISUAL = TRUE/FALSE REMINDERHOLIDAY-AUDIBLE = TRUE/FALSE REMINDERHOLIDAY-SERVERMAIL = TRUE/FALSE REMINDERHOLIDAY-UPCOMING = TRUE/FALSE REMINDERHOLIDAY-LEADTIME = <time_in_minutes> REMINDERTASKSTART-VISUAL = TRUE/FALSE REMINDERTASKSTART-AUDIBLE = TRUE/FALSE REMINDERTASKSTART-UPCOMING = TRUE/FALSE REMINDERTASKSTART-LEADTIME = <time_in_minutes> REMINDERTASKDUE-VISUAL = TRUE/FALSE REMINDERTASKDUE-AUDIBLE = TRUE/FALSE REMINDERTASKDUE-UPCOMING = TRUE/FALSE REMINDERTASKDUE-LEADTIME = <time_in_minutes> REMINDERDAILYNOTE-SERVERALERT = TRUE/FALSE REMINDERDAILYNOTE-VISUAL = TRUE/FALSE REMINDERDAILYNOTE-AUDIBLE = TRUE/FALSE REMINDERDAILYNOTE-SERVERMAIL = TRUE/FALSE REMINDERDAILYNOTE-UPCOMING = TRUE/FALSE REMINDERDAILYNOTE-LEADTIME = <time_in_minutes> REMINDERDAYEVENT-SERVERALERT = TRUE/FALSE REMINDERDAYEVENT-VISUAL = TRUE/FALSE REMINDERDAYEVENT-AUDIBLE = TRUE/FALSE REMINDERDAYEVENT-SERVERMAIL = TRUE/FALSE REMINDERDAYEVENT-UPCOMING = TRUE/FALSE REMINDERDAYEVENT-LEADTIME = <time_in_minutes>
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 other users when creating events or tasks of these designations. For example, if ViewNormalEvent
were set to TIME
, only the time slot of the event would be visible to other users, not its title, location or description. Conversely, if ViewNormalEvent
were set to YES
, all details of the event would be visible to other users. If ViewNormalEvent
were set to NO
, the event would not be visible at all to other users.
The default value for all of the preceding parameters is NO
.
All details of a public event are always visible to other users. There is no way to modify this behaviour 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.
CanBookMe = TRUE/FALSE
Setting this parameter to TRUE
allows any undefined user to schedule with the user. Of course, this can be overridden by the user within the client. The default setting is FALSE
.
Setting the CanBookMe
attribute to FALSE
for a resource will make the resource restricted. When a resource is restricted, no one can reserve the resource. This setting is reflected by the RESTRICTED
attribute which is a read-only attribute.
CreatePublicGroups = FALSE
This parameter determines whether or not users have the ability to create Public groups (i.e. groups available to all users in the database). When a user is deleted, any Public groups he owns will also be deleted. The default is FALSE
.
ManageAdmGroups = FALSE
This parameter determines whether or not users have the ability to create Admin groups. Like Public groups, Admin groups are available to all users in the database, except that Admin groups are not owned by the user who created them, but rather by the SYSOP. Admin groups created by that user will not be deleted if the user is deleted. The default is FALSE
.
ManageHolidays = FALSE
This parameter determines whether or not users have the ability to manage (i.e. create, modify or delete) holidays on the system.
The following parameters, when defined, can be useful for populating the database with a large number of users who share the same X.400 address information.
OU1 = <Org_unit_1> OU2 = <Org_unit_2> OU3 = <Org_unit_3> OU4 = <Org_unit_4> O = <Organization> C = <Country> A = <Administrative_Domain> P = <Private_Member_Domain>
This section allows you to define groups that users and resources will be placed in as they are added to the system. Note that the groups must be created beforehand, and that there is a maximum of 10 groups per section.
Group0 = <group_name> Group1 = <group_name> Group2 = <group_name> ... Group9 = <group_name>
A designate is a user assigned the right to modify the agenda of another user or resource.
This section allows you to define designates for users and resources. Note that designates must exist in the database beforehand, and that there is a maximum of 10 designates per 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 below, 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 - i.e. "S=Hoopla/OU1=R\/D"
.
If, in a UNIX environment, a shell will be processing the string (e.g. 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 (i.e. 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"
TimeZone = <time zone>
This parameter is used to define a different time zone for the user.
ALLOW-CONFLICT=YES
Use this parameter to determine if this resource can be double-booked. Set it to DEFAULT to set the attribute for all resources on the calendar server to the same value. Use the server parameter [ENG] allowresourceconflict
to specify the default value. See Chapter C, "Calendar Server Parameters" of your calendar server's Reference Manual.
NOTIFY-APPROVER=TRUE
This parameter specifies that booking this resource requires approval by a resource manager. When a resource has this attribute turned on (using uniaccessrights
), the resource will be reserved once it is approved by the manager. Use the APPROVER-EMAIL
attribute to specify the e-mail address of the manager for this resource. To enable the resource approval mechanism for this resource, the ALLOW-CONFLICT
attribute must also be set to YES
.
CATEGORY=<category>
This parameter is used to assign a category to a resource. Categories are used to facilitate searching for resources. The category name should be one of the categories defined in the category file $ORACLE_HOME/ocal/misc/category.ini
. See also the Oracle Calendar Administrator's Guide.