This section describes how to configure the machine that you use to create items such as profile groups, targeters, and scenarios so that their names are saved in an appropriate character set. This step is optional for delivering internationalized web content to end users; it is a localization issue that applies only to items in the ATG Control Center interface. (The names of these items as they appear in the ATG Control Center are also their file names.) These items are used by application developers only, not by site visitors.

The names of items such as profile groups, targeters, and scenarios are saved in the encoding specified in the Java system’s file.encoding property. For example, if you want to create an EUC profile group name, set the file.encoding property to EUC. If you want to create a Greek group name, set the file.encoding property to ISO8859-7. To create group names in more than one language, choose an encoding that supports all the languages you require; for example, to create group names in both in Russian and French, set the file.encoding property to UTF-8.

To set the file.encoding property, set the JAVA_ARGS variable as follows:

JAVA_ARGS=-Dfile.encoding=UTF-8 (or the encoding you require).

On Solaris, you can set the machine’s default locale as an alternative to setting the file.encoding property. To set the locale to eucJP, for example, do the following:

setenv LANG ja
setenv LC_ALL ja

To set it to UTF-8, do the following:

setenv LANG ja_JP.UTF-8
setenv LC_ALL ja_JP.UTF-8

Consider the following example: you use the ATG Control Center to create a scenario on a machine that is using a Japanese version of an Oracle ATG Web Commerce product. The appropriate character sets are installed on the machine. When you create a scenario, the ATG Control Center appears to allow you to enter the scenario’s name using Japanese characters; however, when you save the scenario, its name displays as a series of question marks. To correct the problem, check that the Java file.encoding property is set to an appropriate value as shown above.