D
International Support

This appendix contains information relating to international installations of the calendar server.

UTF-8

The server uses UTF-8, an 8 bit encoding of 16 bit UNICODE, to achieve an international character representation. Data passed to the server must be converted from the source character set to UTF-8. When the data is read from the server, it once again passes through a conversion from UTF-8 to the character set defined on the display device. This functionality is crucial in heterogeneous environments where data may be entered in one character set and retrieved in another.

Configuration

The utf8_autoconvert parameter in the $ORACLE_HOME/ocal/misc/unison.ini file controls the conversion and storage of calendar data in the UTF-8 format. By default, this feature is enabled. See Appendix C, "Calendar Server Parameters" of the Oracle Calendar Reference Manual, for information on the utf8_autoconvert parameter.

Character Set Identification

In order to successfully complete the conversion to or from UTF-8, the server must know the source or destination character set. The character set used by the directory server is defined by the parameter [LDAP] charset in the $ORACLE_HOME/ocal/misc/unison.ini file (see Appendix C, "Calendar Server Parameters" of the Oracle Calendar Reference Manual for information on this parameter). Client character sets are identified explicitly to the server by the client application itself.

Japanese Server Configuration

If the calendar server is installed on a Japanese operating system, the following parameters in the $ORACLE_HOME/ocal/misc/unison.ini file should be set as shown in the following example. In the [ENG] section, parameter NLS_LANG defines the character set to use for data in log files. In the [CWS] section, parameter mimecontentcharset determines the default character set to use to encode the content and subject portion of all MIME mail messages sent by the CWS daemon/service. Parameter mailhdrtoname determines whether or not to include names along with addresses in the "To:" field of the mail header. See Appendix C, "Calendar Server Parameters" of the Oracle Calendar Reference Manual for more detailed explanations of the function of each parameter. Example:

[ENG]
NLS_LANG= MSCP932
[CWS]
mimecontentcharset=ISO2022-JP
mailhdrtoname=FALSE

If older Japanese clients are used (versions prior to 9.0.4), the definition of the client character set can be set manually by inserting the following parameters in the [LOCALE] section of the unison.ini file: the parameter charsetwindows which indicates the character set used by the older Japanese Windows client, and the parameter charsetCGI which indicates the character set used by the older Japanese Web client. Example:

[LOCALE]
charsetwindows=MSCP932
charsetCGI=Shift_JIS

Setting User Language Preferences

The calendar server offers users e-mail and Alert reminders in the language of their choice.

Cmd line

Set a user's language through the uniuser utility with the "language" key. Consult Appendix E, "Utilities" of the Oracle Calendar Reference Manual for full information on use and syntax. The following example sets Herman Hesse's language to German:

uniuser -mod "S=Hesse/G=Herman" -m "language=de" -n 14

Alternately, you may use the default user profile file (user.ini) to set the [GEN] language parameter to specify a default language to apply to all new users to be created. Consult Chapter 8, "Calendar Users" of this guide and Appendix A, "User & Resource Parameters" of the Oracle Calendar Reference Manual for details on available languages and parameter values.

D International Support