ReportCaster Distribution Server Support for UTF-8 on Windows

How to:

Configure UTF-8 for the ReportCaster Distribution Server

Although historically the ReportCaster Distribution Server had its own NLS settings, as of WebFOCUS Release 8.2, ReportCaster uses the NLS settings configured for the WebFOCUS Client.

If your WebFOCUS Client is configured to use a Unicode UTF-8 code page, such as 65001, you may encounter issues in which the ReportCaster distribution of certain output times does not apply the correct code page, resulting in instances of incorrect character output.

To resolve this, you can add file.encoding and user.language properties to the schbkr.bat file in your ReportCaster installation and to the Java Options parameter for your WebFOCUS installation in the Registry.

These processes are described in the following procedure.

Procedure: How to Configure UTF-8 for the ReportCaster Distribution Server

If you encounter text encoding issues in your ReportCaster distribution, you can add the file.encoding and user.language properties to the schbkr.bat file in your installation as a step to resolving the inconsistency.

In Windows Explorer, navigate to the bin folder in your ReportCaster installation, for example, drive:/ibi/WebFOCUSnn/ReportCaster/bin, where nn is the version of WebFOCUS that you have installed.
Right-click schbkr.bat and click Edit to open the file in a text editor.
Add the following text to the file to specify the UTF-8 configuration for the ReportCaster Distribution Server:
```
-Dfile.encoding=UTF8
```
Optionally, to specify a language other than English, add the following text after -Dfile.encoding=UTF8.
```
-Duser.language=ln
```
where:

ln

Is a two-letter language ID for the selected language, such as fr for French. The language ID should be typed in lowercase. For a list of available options, see Language and Default Code Pages for Windows, UNIX, and Linux.
Once finished, save and close schbkr.bat.
Open the Windows Registry Editor.
In the navigation pane on the left, expand WOW6432Node, Information Builders, ReportCaster, WFnn (where nn represents your installation of WebFOCUS), Parameters, and Java.
Double-click Options.

The Edit Multi-String dialog box opens.
On a new line, type the following text to specify the UTF-8 configuration for the ReportCaster Distribution Server:
```
-Dfile.encoding=UTF8
```
Optionally, to specify a language other than English, type the following text on a new line after -Dfile.encoding=UTF8.
```
-Duser.language=ln
```
where:

ln

Is a two-letter language ID for the selected language, such as fr for French. The language ID should be typed in lowercase. For a list of available options, see Language and Default Code Pages for Windows, UNIX, and Linux.
Click OK to submit your changes.

These changes will be applied the next time you start WebFOCUS.