Encoding Error in Rational Team Concert Eclipse Client during Build

Resolving The Problem

To resolve this issue, follow the following steps to resolve the issue, depending on where you received the error message:

1. When using the Client to preform a build:
   
   This is because the character encoding does not match what the client is configured to run using. This can be changed by going to the following section in the Rational Team Concert Client, Window > Preferences > General/Workspace page > Text file encoding section
   
   
   
   
2. When using Command Line to preform a build:
   If this error is seen when running a build from the command prompt, try adding the following variables into the command:
   
   -encoding UTF8
   
   Example: Command line options:
   
   -d /build/RTC/wdp_bssview/target/classes -classpath ... ... -g -nowarn -target 1.6 -source 1.6 -encoding UTF8
   
   
3. When interchanging between Windows and Linux Environments
   This error may also be seen if build files are being constantly exchanged between Windows and Linux Systems. Most Windows systems have en_US.ISO-8859-1 configured as the default encoding. Therefore, special characters don’t map from en_US.ISO-8859-1 to en_US.UTF-8 as expected when compiling. The default character encoding scheme of most Linux systems is en_US.UTF-8 as defined in /etc/sysconfig/i18n. Therefore, if you are coding in Windows, and try to run the build in Linux, you may receive the same error. To solve this, perform the above steps, as well as set the LANG environment variable to en_US.ISO-8859-1:
   
   export LANG=en_US.ISO-8859-1
   echo $LANG
   en_US.ISO-8859-1