IBM Support

Byte Sequence not legal error with ClearCase and Rational Team Concert integration

Technote (troubleshooting)


Attempts to import versions from IBM Rational ClearCase to IBM Rational Team Concert (RTC) results in byte sequence not legal error.


The following error will be seen when running the cleartool command:

javax.wvcm.WvcmException: Output from cleartool command could not be processed because it contains a byte sequence not legal for the given character set.  Ensure that any filenames being processed by cleartool contain only characters legal for the specified locale.
java.nio.charset.MalformedInputException: Input length = 1
Build failed. Exit value was 3.

There will no errors in the log file.


During the import operation the following ClearTool command is run

cleartool diffbl -activities -versions oid:<oid>@vobuuid:<oid>@vobuuid:<oid>

The output of this command contains non-ASCII characters that cannot be properly read by RTC.

Diagnosing the problem

NOTE: Because RTC cannot read the problem characters the log file will not contain them.

To find the illegal characters,

  1. Copy the diffbl command from the build log file and run it manually inside of a ClearCase view.

  2. Search the output for any non-ASCII characters.

Tip: There may be multiple illegal characters, however the first one should show up shortly after the output that was written to the build log.

These characters can show up in various ways depending on a number of variables such as the Operating System, the editor, or the system locale. The characters will generally show up as various out of place characters such as a square a question mark or a diamond shaped character.

Resolving the problem

Rename the problem activities without the special characters and rerun the synchronization.

Leverage the Jazz Community

The Jazz based products have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Quality Manager Web App Server 4.0
Software Development Rational Requirements Composer Web App Server 4.0

Document information

More support for: Rational Team Concert

Software version: 3.0.1,,,,,,, 4.0,,, 4.0.1, 4.0.2, 4.0.3

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1647038

Modified date: 19 August 2013

Translate this page: