Configuring a WebFOCUS Client for NLS

How to:

Configure a WebFOCUS Client for NLS (Windows, UNIX, Linux, IBM i, z/OS (HFS))

Reference:

Using JDK 1.7 on Windows

To configure a WebFOCUS Client for National Language Support (NLS), sign in to the WebFOCUS Administration Console and select a code page.

By default, the WebFOCUS Client uses the following code pages if installed on a non-English operating system. (For Western European operating systems the default can be used. For other languages it is necessary to reconfigure):

1252 on Windows, UNIX, and Linux
37 on IBM i and z/OS

Procedure: How to Configure a WebFOCUS Client for NLS (Windows, UNIX, Linux, IBM i, z/OS (HFS))

Open the WebFOCUS Administration Console with administrative privileges.
In a browser, enter the following address:
```
http://host:port/ibi_apps/admin
```
where:

host

Is the host name or IP address of the machine running the WebFOCUS Client.

port

Is the port number on which the server is listening.

The WebFOCUS Sign In page opens. Sign in as an administrator.

If you are working within App Studio, open the WebFOCUS Administration menu and click WebFOCUS Administration Console.
In the Administration Console navigation pane, click NLS Settings. The NLS Settings page is shown in the following image.
Select the operating system on which the WebFOCUS Client is running.

The code pages for the selected operating system are displayed in the list.
From the list, select a code page that configures the client for the correct display of report output in the browser.

The language selected for the client usually corresponds to the language selected for the server from the WebFOCUS Reporting Server Console. The code page for the client must be the ANSI equivalent of the code page for the server you are reporting from.

If the code page chosen from the WebFOCUS Reporting Server Console does not appear in the list box on the WebFOCUS Administration Console, select User Defined Code Page and type the code page number in the text box.

You would do this, for example, if the server adds support for a new code page that is not yet reflected in the client software.
Click Save to store the settings. The client configuration file is updated with the selected code page.

Reference: Using JDK 1.7 on Windows

During a WebFOCUS installation in Windows, the default WebFOCUS language is set to the system's locale, .DEFAULT user ID, even though the current user ID is set to a different language. This is a JDK limitation.

WebFOCUS depends on the JDK file.encoding value to appropriately read and write data, and display NLS characters in the tools.

To determine the value for file.encoding, in the Administration Console, access click the Diagnostics tab and click JVM Property Info. The value for file.encoding is available in the System Properties list.