Configure application servers for other language environments

You can configure individual application servers to run with different globalization settings to support different language environments. The topics below discuss how you can configure the application server to run with the language environment attributes which you require, and how you can configure the application server to use a specific National Language Version (NLV) when you have multiple WebSphere Application Server NLVs installed.

• Configure the language environment attributes
  You can configure the application server to run with the appropriate language environment attributes, such as the coded character set identifier (CCSID) and country or region identifier, for the environment you wish to create. The QEJBSVR user profile settings are the basis for the application server job attributes, and the job attributes determine the properties for the Java^(TM) virtual machine environment. For more information on job attributes that are set based on the user profile, see iSeries unique administrative console features.

  Notes:

  1. Japanese CCSID 5026 is not supported by WebSphere Application Server. 5035 is the recommended CCSID for this environment. The QEJB and QEJBSVR user profiles default to the system CCSID setting. If the QCCSID system value is set to 5026, the CCSID attribute of the QEJB user profile must be changed to prevent the WebSphere Application Server Monitor and Administration server jobs from trying to start with a CCSID of 5026. The QEJBSVR user profile, and any other user profiles used to run WebSphere Application Server instances, must also be changed.

  2. Arabic CCSID 420 is not supported by WebSphere Application Server. 425 is the recommended CCSID for this environment. The QEJB and QEJBSVR user profiles default to the system CCSID setting. If the QCCSID system value is set to 420, the CCSID attribute of the QEJB user profile must be changed to prevent the WebSphere Application Server Monitor and Administration server jobs from trying to start with a CCSID of 420. The QEJBSVR user profile, and any other user profiles used to run WebSphere Application Server instances, must also be changed.

  By default, each application server runs under the QEJBSVR user profile. To change the language enviroment settings you can either modify the QEJBSVR profile and set the attributes specifically or you can create a new profile which has QJEBSVR as its group profile and which has the appropriate language environment settings. If you choose to create a new profile, register it for use with WebSphere Application Server. For more information, see Run application servers under specific user profiles.

• WebSphere Application Server product settings
  A second consideration is the national language version (NLV) of the WebSphere Application Server product. The NLV setting only causes the library list to be changed to include the appropriate QSYSxxxx library, where xxxx is the language feature for which you wish to display messages. The NLV setting does not affect the administrative console or any non-iSeries message logged by the WebSphere Application Server runtime."

  Multiple NLVs can be installed at the same time. If the language version that you want to use is the same as the primary language of the system, no additional configuration is needed. If the language version you want to use is a secondary language, configure the application server by setting the os400.websphere.nlv property:

  1. Start the administrative console.
  2. In the topology tree, expand Servers and click Application Servers.

  3. On the Application Servers page, click the name of the server for which you wish to change language version.

  4. On the Configuration tab, and click Process Definition --> Java Virtual Machine --> Custom Properties.

  5. On the Custom Properties page, click New.
  6. Specify these values for the custom property settings:
     • Name: os400.websphere.nlv
     • Value: xxxx

     where xxxx is the language feature you want to use to display messages. For example, to specify the Japanese language, set the Value as 2962. You can also specify a description for this property.

  7. Click OK.
  8. Save the configuration.

  When an application server has the os400.websphere.nlv property set, the corresponding QSYS29xx library is added to the beginning of the library list and iSeries messages sent by the application server to the joblog are used accordingly.