Archive for March 22, 2009

Internationalization / Unicode

If you are developing applications for languages other than English, you probably realize that this can be a challenge – particularly with eastern ideographic languages such as Japanese and Chinese.  For a general overview of this, check out this System i Network article. For the techical details behind Unicode, check out this wikipedia article.

Fortunately CA Plex and WebClient take much of the pain out of Unicode development. Since WebClient is based on CA Plex panel designs, the first step is to make your model international aware by adding national language dimensions to your group model environment. This is documented in the CA Plex help, see the following section.

Working with National Languages
National languages are used to manage the translation of an application into different human languages. Examples of national languages are French, Spanish, American English, and British English. CA Plex automatically tracks all the text in your application that appears in the user interface.

Once you have your Plex model configured, you can start using national languages in WebClient. Two key points are to make sure your web server and database management package are set up to handle the character sets you are working with. Most modern database and web servers handle standard forms of double byte unicode such as UTF-8. Unicode extension B can be more of a challenge since extension B takes 4 bytes per character (note that CA Plex does not current support extension B). However, extension B is not required for most applications.

To enable international character sets in WebClient, there are two settings to be aware of.

First, set up UTF-8 as the encoding in WebClient:

In the latest version of J2eeProxy.prop file, there is a property named “servlet.encoding.httpbody=utf-8”. Delete “#” in front of the property name to use it.

If you are using Tomcat:

In Servers folder, expand Tomcat server folder and open server.xml. Add URIEncoding=”UTF-8″ in the connector element, for example
<Connector connectionTimeout=”20000″ maxThreads=”150″ port=”8080″ protocol=”HTTP/1.1″ redirectPort=”8443″ URIEncoding=”UTF-8″ />

Other Tips:

  • Make sure you are using the latest version of Plex, as Unicode support has been improved with 6.1.
  • Keep an eye out for the next Plex service pack which will likely contain other Unicode enhancements
  • Make sure you are using the latest version of WebClient 1.4.1r4
  • Unicode support has been tested with Derby and SQL Server. However, most databases support Unicode

WebClient 1.4R4 Patch Released

The latest build for WebClient, 1.4R4, has been made available to customers.

To get this patch release, please log in to, and download the updated files. The patches are located in the Developer Content category.

Please contact us to discuss if you have questions.

WebClient March 2009 Newsletter Published

We have published our March Newsletter to the WebClient developer community. We will be publishing a newsletter monthly with tips/techniques, information, and other technical news. Highlights to bring out in this publication: an updated documentation wiki, new developer tips, and several upcoming events.

You can access a our March newsletter here.

To see all newsletters, and to sign up for a newsletter, access our newsletter archives.

WebClient Benchmarking

Many web developers are interested in performance of their production web applications – as well they should be. Performance under load can be quite different than performance in a development environment or on your personal workstation. To give some guidance on this, we have created a benchmark document. In this document, the developer can see how WebClient performs under simultaneous load with a simple application, and more importantly get information on how to set up a custom benchmarking scenario for your applications. This can be done use free tools like OpenSTA, or more sophisticated tools like the Worksoft line of performance simulation.

One key item is determining the number of virtual users to simulate. This handy calculator can potentially help. Usually the number of active virtual users is much less than the number of logged in users, because users are not constantly active in many business appplications.

We hope this information helps you. Please contact us at if we can assist further.

© 2013 CM First Group - All rights reserved