E
International Support

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

• UTF-8
• Character set identification
• Japanese server configuration
• Setting user language preferences

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 /users/unison/misc/unison.ini file controls the conversion and storage of calendar data in the UTF-8 format. By default, this feature is enabled. See the calendar server Reference Manual, Appendix B, "Server Parameters," 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 /users/unison/misc/unison.ini file (see the calendar server Reference Manual, Appendix B, "Server Parameters," for information on this parameter). Client character sets are either identified explicitly to the server by the application itself, or determined based on the operating system of the client. If necessary, it is possible to manually set the definition of the client character set by inserting the appropriate parameter in the [LOCALE] section of the unison.ini file.

Parameter	Value
charsetwindows	= <defined character set>
charsetwindows32	= <some character set>
charsetwindows16	= <some character set>
charsetmac	= <some character set>
charsetmac68k	= <some character set>
charsetmacppc	= <some character set>
charsetCGI	= <some character set>
charsetmotif	= <some character set>
charsetmotifaix	= <some character set>
charsetmotifhpux	= <some character set>
charsetmotifirix	= <some character set>
charsetmotiflinux	= <some character set>
charsetmotifopenserver	= <some character set>
charsetmotifosf	= <some character set>
charsetmotifsolaris	= <some character set>
charsetmotifsunos	= <some character set>
charsetmotifunixware	= <some character set>

Japanese server configuration

If installing the server on a Japanese operating system, the following parameters in the /users/unison/misc/unison.ini file should be set to the indicated values. See the calendar server Reference Manual, Appendix B, "Server Parameters," for more detailed explanations of the function of each parameter.

[ENG]
localcharset= MSCP932
[CWS]
mimecontentcharset=Shift_JIS
mailhdrtoname=FALSE
[LOCALE]
charsetwindows=MSCP932
charsetCGI=Shift_JIS

See also the documentation concerning the [CWS] emailcharsetmap parameter.

Setting user language preferences

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

Cmd line

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

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

Alternately, you may use the user.ini [GEN] Language parameter to specify a default language to apply to all new users. Consult Reference Appendix A, "User and Resource Parameters," for details on available languages and parameter values.