IBM Support

Rational Performance Test Server Fix Pack 1 ( for 9.2



IBM Rational Performance Test Server Fix Pack 1 ( for 9.2 is available for download. It contains fixes to version 9.2 components, including all previous fix packs.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

Find technical developer content and resources.


Prerequisites include:

Version of IBM Installation Manager required: IBM Installation Manager 1.8.8 or later.

Review the Planning the installation page in the IBM Knowledge Center.

Installation Instructions

Review the Installing page in the IBM Knowledge Center.

Review the Upgrading the software page in the IBM Knowledge Center before you install.

Download Package

The following sections provide detailed information related to this release.

Click the FC link below to obtain the release from Fix Central.

How critical is this fix?

Impact Assessment
Impact Description

This is a maintenance release. It contains fixes for client-reported and internally found defects.

Test Results


Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Problems Solved

Defects resolved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known Side Effects

Review the following list of known issues and open defects:

Review the following list of known issues.

Open defects

Review the following list of open defects for Rational Performance Test Server on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Known issues in this release include:

New to this release
TP-51593 When attempting to directly access test results in Rational Test Control Panel that were deleted, users might experience the browser stuck showing a "Loading..." page.

Previous known issues that still apply
TP-51126 Before a Mac OS user installs Integration Tester, a Java JDK must be installed first from this web site: The latest JDK version of Java 8 is: jdk-8u161-macosx-x64.dmg
TP-50254 Topology discovery for WebSphere MQ is not available for WebSphere MQ on z/OS.
66725 When you use the Maven plug-in, if resources other than tests and stubs are run (specifically suites or performance tests), then the environment attribute in the pom.xml is ignored. To work around this problem, add an environment argument (-environment arg) in the pom.xml. If you do not use this workaround, then the result is either an UnsupportedOperationException being thrown, or if the project was opened on the workstation before, the most recently used environment is used instead.
65943 In 9.1.1 the protocol that is used to communicate with Rational Test Control Panel changed to be HTTPS (by default). When recording messages in Recording Studio often these messages are sent direct from the agent/proxy to IntegrationTester. The transport that is used is agent/proxy specific and not usually encrypted.
65940 In 9.1.1, Rational Test Control Panel and Integration Tester, by default, use an SSL certificate and private key shorter than 2048 bits. As such they are not in compliance with industry standards set by the Certification Authority/Browser (CA/B) Forum. Rational Test Control Panel can be configured to use the compliant 2048 versions by changing the keystore path in the server.custom.xml file to the available 2048 bit greenhat2048.jks keystore. In Integration Tester, the compliant Inbuilt Certificate Authority can be selected in the Project Settings.
65808 The DB2 for z/OS intercept cannot use HTTPS to communicate with Rational Test Control Panel.
63553 When you download Rational Integration Tester Starter Edition for Mac OS Sierra, you must clear the quarantine attributes otherwise Rational Integration Tester Starter Edition fails to start. Clear the quarantine attributes by running: `xattr -d -r ~/Downloads/IntegrationTester`
62419 On OS X Yosemite, the IntegrationTester application might fail when you double-click it. Instead, start the IntegrationTester application from a command-line terminal by using ``. This problem does not occur on MacOS Sierra.
62296 After you upgrade to the latest version of Rational Test Control Panel from or earlier, connection to Rational Test Control Panel might fail. The following log message appears in the Rational Test Control Panel log files:
[ERROR ] CWWKT0022E: The configured host for HTTP endpoint defaultHttpEndpoint could not be resolved. The endpoint has been disabled.

To fix this problem, edit the RTCP/config/server.custom.xml file to do one of the following: replace "" with "*", remove the "host" attribute to use the default, or remove the entire "httpEndpoint" element to use the default for all its attributes.
62445 The minimum required version of TIBCO BusinessWorks installed is now 5.13. This version is required because previous versions are not Java 8 compatible.
62051 The proxy cannot be used to record Kerberos authenticated HTTP traffic when forward bind rules are used in the proxy's registration.xml configuration file. This traffic can be recorded using a normal proxy configuration.
60573 The JDBC driver that is used for database virtualization doe not currently support stored procedures within WebSphere Liberty because of limitations in the the way that they access third-party drivers.
61094 If you are use Rational Test Control Panel in a Solaris environment, you must not update. Instead, you should reinstall Rational Test Control Panel. This is because the new version is a 64-bit version.
50892 When uninstalling RITA using the "imcl uninstall <rita_pkg_id>" command on Windows there is a chance that the uninstall will fail due to the agent process failing to stop. In order to prevent this users should manually stop the Windows process using Control Panel before starting the uninstall.
58945 When testing functions using scripting languages other than ECMAScript, the results window might not show any output and might fail to display a success notification. However, the underlying script will run correctly as part of the test.
60599 The JDBC driver that is used for database virtualization is not currently compatible with WebSphere Message Broker or IBM Integration Bus because of limitations in the the way that they access third-party drivers.
59591 Parameters for CALL statements for the JDBC proxy must be enclosed within parentheses.
58555 DB2/z virtualization of PL/I applications requires that all variables are uniquely named irrespective of whether they are qualified within a containing structure.
61181 When publishing a stub to docker using the wizard in Test Factory, if spaces are typed into the output directory field on the final page, the value can be incorrectly rendered.
60633 When synchronizing a WSDL or Swagger document and creating a stub, optional fields are not included automatically in the stub unless you have set the workspace preference to include optional fields. Set this preference under Workspace > Preferences >Messages > Include optional fields.
60251 The CICS agent might not handle DPL requests if the size of container is more than 70 KB.
58472 When using the ISO20022XSDDownloader utility, some download errors may be encountered. If this happens, open the URL specified in the console log and manually download the schema, unpackage it and place it into the download folder. If the URL is not accessible for the schemas you are interested in, acquire a copy of them from your organization and manually copy it into the download folder.
58044 When pasting a link to a Swagger file into the Logical View of Architecture School, the path is correctly recognized only if it ends with "swagger.json" which is in line with the implied standards. The workaround is to specify the full path in a manually created Swagger resource when the source is named differently.
57839 The updated JRE has more stringent security settings that do not allow the use of insecure hashing algorithms such as MD5 in secure TLS communications or in the creation of X.509 certificates.
57695 The Java agent has been updated to support Java version 8 JVMs, however, Java 8 language features are still not supported.
57605 When DBCLOBs are interpreted as a single-byte CCSID containing an odd number of characters, a garbage character might be appended at the end. DBCLOB values in PL/I applications might be truncated to half of their original lengths.
57148 The following encoding limitations apply in the current release:

- CLOB, DBCLOB, XML_CLOB, and XML_DBCLOB host variable data are interpreted as CCSID 37. All the other character string host variable types are interpreted using CCSID defined in the DECLARE :HV1 VARIABLE CCSID ccsid SQL statement for that variable.

- If the host variable has no associated DECLARE :HV1 VARIABLE CCSID ccsid SQL statement, it is interpreted by using the CCSID specified by the CODEPAGE compile option. It does not matter whether the application was compiled by using the CCSID0 option (for PL/I applications) or the NOSQLCCSID option (for COBOL/PL/I applications) or both.
57042 Synchronization with IBM Integration Bus version 9 and earlier happens using WebSphere MQ. However, only the username from the configuration is used by the libraries, and so an error will be encountered when connecting to a secured queue manager.
55625 In a regression from Rational Integration Tester 8.7, parsing of some DFDL schemas fails in the current version due to inconsistent properties. Error CTDV1561E is displayed. For migration details, see Resolving problems when migrating or importing message models.
53246 Virtualization of Oracle stored procedures in TIBCO BusinessWorks using the Derby database is not possible, because TIBCO BusinessWorks uses Oracle-specific SQL statements only. To work around the issue, use an Oracle schema for the stub.
51534 Although, in general, Rational Integration Tester now supports the Software AG webMethods Integration Server (wmIS) 9.7, JDBC Virtualization from within wmIS where the database connections are defined using JDBC Connection Pools or used directly via DriverManager is not supported and does not work with this specific version of wmIS.
50893 When attempting to install the Rational Integration Tester Agent on AIX without a GUI by using the IBM Installation Manager imcl program, the user might be unable to complete the installation. Details and workaround information are available in the following technote:
49901 The interface that Rational Integration Tester uses to integrate with Software AG webMethods Integration Server changed with version 9.7 of webMethods IS. As a result, the installation instructions for the Rational Integration Tester adapter package have changed. The new instructions are available in the Rational Integration Tester Knowledge Center. Users who are familiar with the installation on previous versions of wmIS should note the change and read the instructions carefully.
49825 If a username/password value in the WebSphere MQ transport is used with WebSphere MQ version 8.0, and the password is longer than 12 characters, then the WebSphere MQ version 8.0 client jar files must be used. In other words, passwords longer than 12 characters do not work with WebSphere MQ version 8.0 when using the version 7 client jar files.
47744 When using the command line installer for Rational Test Control Panel (imcl -c), the user cannot modify the default security permissions. Two workarounds are available:
  1. Copy the correct security.config file to the new system.
  2. Create the quiet installation file a different system, then run the quiet installation on the intended server by using the generated quiet installation settings file.
41193 The Rational Test Virtualization Server and Rational Performance Test Server Launchpads are not supported on the zLinux platforms and do not run correctly there. Users who want to install components of Rational Test Virtualization Server or Rational Performance Test Server must use IBM Installation Manager to install those components directly.
39436 Packet capture (pcap) recording does not currently work on Windows 8.
45807 The Java Agent component (shipped as part of the Rational Integration Tester Platform Pack) used for Java Virtualization does not support Java 8 and cannot be loaded into a Java 8 JVM.
45716 When a user attempts to open a Rational Integration Tester project as Project Administrator, the username field in the login dialog is disabled. The reason is that Rational Integration Tester authenticates based purely on the password for the project administrator. However, if the Rational Integration Tester project is configured to use Rational Test Control Panel for authentication, then Rational Integration Tester also attempts to authenticate the user against Rational Test Control Panel, based on the user's Windows account name. If the user cannot be authenticated by Rational Test Control Panel, then he or she will not be able to open the project as an administrator.
45700 If Rational Test Control Panel is installed on a Windows machine into a folder that is not protected by UAC, then users may still be prompted for passwords when running the startup.bat file.
45214 When installing software using IBM Installation Manager, input validation is performed when moving both backward and forward through the installation wizard. This means users might see validation warnings when clicking the Back button. This behavior is expected.
44474 If a stub is created from recorded X12/EDIFACT messages, and a user then edits the message (request or response) in the stub editor and attempts to modify a non-expanded parent element (rather than the children), then Rational Integration Tester raises an exception. This problem can be avoided by editing the expanded child elements. Note that it is usual to edit child elements as these elements contain the parsed fields. Editing the parent requires the user to edit the original string rather than the parsed version.
44280 Some transports do not differentiate message types between "requests" and "responses". This means that when Rational Integration Tester records messages from these transports they will all appear as "Publish" type messages. The user must find another way (usually using header or body values or specific queue or topic names) to determine which is the "response" message. If a user creates a stub using the Recording Studio Wizard, then the stub will not work correctly "out of the box" as it will have incorrectly created a subscribe action for the response rather than a publish. The user must correct this by using the stub editor after it has been created. The user will also need to update the operations created by the wizard.
41050 A number of problems have been observed when using the OSLC user interface provided by Rational Test Control Panel within Rational Quality Manager on Internet Explorer:

Note that Internet Explorer 7 is not supported with Rational Integration Tester 8.7.0.

1. With Internet Explorer 9 on Windows 7, it might not be possible to enter stub configuration (such as agent selection, response time, or input tags) in the Rational Test Visualization Server dialog from Rational Quality Manager. Only the "Start stub/Cancel" option is shown.

2. Stub and Scenario icons might not be displayed in the OSLC user interface for Rational Test Control Panel that is displayed in Rational Quality Manager if the user is running Internet Explorer version 9. The icons do display correctly with other browsers.

These problems do not occur in all installations. In general, upgrading to Internet Explorer 10 or later resolves the problems.
40568 A Windows process that was launched via the Run Command action is not terminated when the test or suite is cancelled, even if the user specified that the Run Command action should kill the task at the end of the test, scenario, suite, or execution.

This issue exists because Windows (unlike UNIX or /Linux) does not track parent/child processes. The problem is documented in a Java bug at the following URL:

This problem cannot be resolved by Rational Integration Tester and is a permanent limitation.
29782 After installing Rational Integration Tester or Rational Integration Tester - Agent on a 32-bit RHEL platform some users have seen a warning in the Installation Manager logs stating "Internal error:UID should end with E, W, or I: SWTNOS". This warning does not affect the installation and can be ignored.
28214 Although it is possible to roll back an installation of Rational Test Control Panel using Installation Manager the workspace (containing all published stubs and other information) will not work with an earlier version of RTCP once it has been upgraded and run.

When a new version of RTCP is installed and run it upgrades the workspace to the new version. If the installation of RTCP is subsequently downgraded then it will not start because the workspace remains at the higher version.

To avoid this problem users must back-up the workspace directory before upgrading Rational Test Control Panel. If it is subsequently downgraded again then the workspace must be restored from back-up.
37586 Rational Integration Tester tests can be run via Ant. When running test suites, the URL of the results is output at the end of the test.

With Ant 1.8.4, this URL is broken across 2 lines making it unusable as a hyperlink. It works correctly in Ant version 1.8.2 and earlier.

1.8.2 of Ant and earlier results in:
[GHTester] The results for this run can be viewed at http://localhost:7172/ResultsServer/results?resultType=scenario-execution-data&executionId=77Version

1.8.4 of Ant gives two lines:
[GHTester] The results for this run can be viewed at http://localhost:7172/ResultsServer/results?resultType=scenario-exec
[GHTester] ution-data&executionId=73

This is caused by a bug in Ant 1.8.4. Customers must use earlier versions if they require this functionality.

41196 When components are upgraded using IBM's Installation Manager changes that users have made to configuration files (such as agent.config) will be lost. This is because the upgrade process does not merge changes that were made to the configuration files with the new version. Instead the upgrade process simply overwrites the user's configuration file with the new version. If users have modified configuration files after installation then these changes must be made again and it is suggested users take copies of the files before upgrade so that they can copy the changes across.


Side-by-side installation of different versions of Rational Integration Tester is not supported. If such installations are performed then users should note that the multiple versions will share the same start-up splash-screen cause confusion in the version numbering. Help/About must be used to determine the correct version number.


If a performance test is configured to start a stub on RTCP and that stub is already running then another instance will be (correctly) started for the performance test. However, when the performance test stops, both instances of the stub will be stopped, not just the one that was started for the test. Note that this does not apply to stubs which are already running which are not configured to be used in the performance test; they will continue to run after the test ends.


When an RTCP scenario is loaded into RIT (via either the Test Suite scenario editor or the Performance Test configuration dialog), scenarios for all domains / environment are listed rather than just the domain/environment the user is currently working in. If the test is then executed in an environment in which the stubs in the scenario have not been published too they will fail to start.


Users should note that JDBC database virtualization is not supported against IBM DB2 version 8.x. The oldest supported version of DB2 for JDBC virtualization is 9.5 (on distributed) and 9.1 (on System z).


If a Rational Integration Test suite scenario has a reference to a (local) stub as ‘blank’ in the References grid (i.e. not ‘Live System’ and not a specifically selected stub) and a stub is already running for the referenced operation then, when the test suite starts, the running stub will be stopped by RIT (thus reverting message to the live system). This may cause user confusion as they had not explicitly configured the scenario for ‘live system’. Note that this can be worked around by explicitly stating which stub should be used in the scenario editor.


Use of –clean argument when Tester or Library Manager will not start

Problems can sometimes occur when Rational Integration Tester does not properly resolve multiple versions of the same JAR file correctly. Multiple versions may be present within an installation because third party JAR files may each include a different version. If incorrect dependency information is stored within the Eclipce workspace cache then it will not correct itself. One common symptom of this problem is that when a user runs Tester, the splashscreen appears, then disappears but Tester never starts. The same issue can occur when running Library Manager, although in this case, as there is no splash screen, it will appear to the user as if Library Manager has just failed to start.

Although one workaround is to uninstall and re-install Tester it is possible for a user to force cached dependency information to be removed and re-evaluated and, in the majority of cases, the problem will then correct itself.
To force the Eclipse environment to delete dependency information GHTester.exe must be started from the command line with the -clean argument specified. i.e., from within the installed directory:
GHTester.exe –clean on Windows and ./GHTester –clean on Linux.
Rational Integration Tester will take longer than usual to start when -clean is specified.
For Library Manager use:
LibConfig.exe –clean on Windows and ./LibConfig –clean on Linux.
The same problem can occur in RTVS and RPTS installations with the RIT Agent. In this case diagnosis and remediation is more difficult as there are multiple executable files and the correct one must be used. In these cases IBM’s Support team should be contacted.
39739 When upgrading the Rational Integration Tester Agent on the Windows Server 2008 platform then, if the existing Agent is installed as a Windows server it is advisable to stop the service before attempting to perform the upgrade otherwise errors may occur. To do this, open Control Panel to: Control Panel\System and Security\Administrative Tools, then stop the 'IBM RIT Agent' service.
38668 When a user creates a subfolder under an operation in Rational Integration Tester, then creates a stub in that subfolder and then publishes the stub to Rational Test Control Panel, the stub will not be visible from the RTCP dashboard although the publish process will appear to have worked correctly. To avoid this problem, move the stub directly under the operation so that it is not within a subfolder.


Overwrite Expected Field for Filters

Within the Message Difference Window, Overwrite Expected Field only works for filters (within stubs) when updating leaf nodes. Message structures cannot be copied when viewing filter actions. The whole message can be replaced while viewing the filter actions, using overwrite expected message, but overwriting part of a message currently only works for the validate field action.

AIX Performance Testing Does Not Support the sysstats Probe
The sysstats probe is not provided for AIX. If a user attempts to configure an AIX-based performance test to use this probe then the following error will be shown in the console : [Error] Probe ERROR: http://localhost:4476 - Probes failed to start - Failed to start probe: System Statistics - java.lang.UnsatisfiedLinkError: ghsystemstats (Not found in java.library.path). You must remove this probe from the configuration of the test.

Stopping an Agent Results In Windows Event Log Error
On some Windows installations IBM has seen errors raised in the Windows Application Event Log when the Rational Integration Tester Agent service is stopped. This error occurs during the shut-down process of the service and does not affect the functionality of the Agent.

Component Tree Does Not Show Complete Project In Test Factory
Some users have reported instances where the Test Factory Perspective does not show the complete list of project resources in the component tree. Rational Integration Tester has required re-starting to correctly display the tree. This problem has not yet been replicated within IBM’s labs and its cause is currently unknown.

GHDotNetUtils Must Be In the .NET Global Assembly Cache
If you are using Rational Integration Tester’s .NET integration then the GHDotNetUtils.dll file (in the root installation folder) must be added to the .NET Global Assembly Cache before .NET objects can be parsed.

Users wishing to use the .Net functionality will need to install the .Net SDK from Microsoft and register the dll manually e.g : gacutil /i GHDotNetUtils.dll

Date Formatting Strings
Rational Integration Tester uses Java to format date strings for validation purposes. The IBM JRE acts differently from the Oracle/Sun JRE used by earlier versions of GHT Tester for one unusual format string.

Specifically, a date of "123" parsed using an input format of “yyy” with output format MMDDy will be formatted as “0101123” by the IBM JRE. Previous versions of GH Tester (using the Oracle JRE) would have formatted this as “010123”. This is unlikely to cause problems as it is unlikely customers will be using single-character year output format strings.

Launching the ‘Tools Application’ (Source Control option on Menu) Displays License Warning
If you are running Rational Integration Tester using an evaluation license then when you launch the “Tools Application”, by choosing the Source Control option in the menu or by creating/editing a data model, a dialog will appear warning that you are using a trial license. This dialog will not appear once you have installed a full license.

The Agent Can Only be Started From its Installed Directory (Unix)
On Unix, if an attempt is made to start the agent from a directory other than the one it is installed in then it will fail to start. For example:

/opt/GH/RIT-Agent/Agent -consolelog

Whereas if you are within the installed directory then:

./Agent -consolelog
works correctly.

It is not possible to rename a project resource by simply changing case
Although project resources can be renamed, it is not possible to simply change the case. i.e. A rename that changes “simpletest” to “SimpleTest” will not actually rename. This is because Tester uses the Eclipse framework to manage its files and Eclipse does not recognize this type of change.
38005 If a Rational Integration Tester project results database is created on MySQL on Linux, the MySQL system variable lower_case_table_names in the my.cnf file must be set to 1. On Linux systems, this is not the default setting.
36796 In Recording Studio, the information window that displays details about warnings or errors that have occurred while recording truncates some information.

For example, recording rules used by the HTTP proxies will typically be truncated. This is by design. The full text can be see in the Rational Test Control Panel activity log.

Linux root/non-root Installation Notes
The 8.7 components can be installed on Linux as a non-root user. Alternatively, components can be installed as root and then run as non-root. The Network Capture (pcap) component of Rational Integration Tester requires root access and cannot be installed as a non-root user.
Most Linux administrators will be aware of file/directory ownership issues when performing these types of installation. The following known issues should be considered.
31329 All users must be in the same group to be able to run/view reports
When a report is generated in Results Gallery Tester will create a directory called /tmp/ghtester5reports. This directory will be owned by the user that creates it (which may be root). When another user attempts to run a report then, if they’re not in the same group, they will be unable to write to the same directory and the report generation will fail. The workaround is to ensure that all users can write to this directory (for example, by making them all members of the same group)

Globalization issues


Rational Integration Tester is a Swing based Java application. Java/Swing uses visual cursor movement when working with bi-directional text in user-editable fields. This means that the cursor arrow keys and the delete/backspace function will always operate visually (i.e. left moves left) which may not be the expected logical movement.


Not all Unicode characters (especially the glyph-style characters) can be rendered using all fonts. For example, very few fonts contain a glyph for the U+0904 (DEVANAGARI LETTER SHORT A) character. Rational Integration Tester’s default behavior means that it will not attempt to find a font that does contain that character. This means that messages containing this character will not render correctly. The workaround is for the user to use the RIT font preferences to select a font that is capable of rendering these characters.


Dates in ISO format in message nodes will not be rendered according to the preferred operating system date format (when not running in English) in the Message Difference Window. Changing this behavior would require making changes that could invalidate ‘expected messages’ in existing projects causing tests to fail. For this reason it has been decided not to change the rendering of these nodes.


When attempting to install multiple products at the same time (e.g. Rational Integration Tester and Rational Integration Tester Platform Pack) warning messages may be displayed in Installation Manager indicating that not all the products in the selected set provide the same set of languages. Both RIT and RTCP have been translated into the same set of 14 languages and this warning can be ignored.


Attempting to connect to a DB2 database using non-ASCII usernames may result in the error “cannot convert Unicode string to Ebcdic string” being displayed. For example, attempting to connect using the default Russian administrator username of "администратор" will show the error, but connecting using “administrator” will not. The workaround is to use the ASCII forms.


Arabic numbers pasted into a numeric control with up and down increment arrows (e.g. the Minimum length field when setting up length validation in the message editor) will revert to Western numerals when the up/down increment arrows are clicked.


When running Library Manager on a non-English operating system the network card information displayed may contain corrupted characters. This is due to a problem processing Unicode characters in 3rd party software used by Library Manager to access the network card details.

Known issues from GH Tester that are still relevant to Rational Integration Tester
Test Cycles and Coverage ReportsIf you are using Test Cycles and want coverage reports, the applicable tests must still be executed from within a test suite (i.e. coverage reports will not be produced for tests that are executed outside of a test suite).

Column Level Validation Cannot be Displayed in the Message Differences Window
Validation on table rows and cells performed within the SQL Query action works as expected and is displayed in the console accurately. If column-level validation is used, however, any differences are displayed correctly in the console, but they are unable to be displayed in the Message Differences window as it is currently only able to display row-by-row and cell-by-cell validation issues.

Duplicated Physical Resources when Using Source Control
Rational Integration Tester now uses a different method of creating filenames for physical resources. For this reason, source control users may see duplicate items due to the way the project was updated/committed after the resource change. In this case, the newer/newly named resource should be kept.

webMethods Broker Events
When recording webMethods Broker events, some fields may be seen to contain null rather than their actual content. This occurs because elements wired to a byte-array by an IS to publish can only be un-wired by another IS, this is an internal mechanism of IS and cannot be overcome. This has been seen with the MQ adapter notifications for the “MsgBody” and “MsgBodyByteArray” fields, but may affect others. Further information can be found via Software AG support, incident number 5019024.
Logical ViewSometimes adding a service component to the logical view will not add it to the diagram.

10905: User Names Containing “#” Character
The Eclipse framework (and therefore Rational Integration Tester) does not support user names that contain the “#” symbol. This issue may result in the deletion of project files as Rational Integration Tester cannot interpret the full path to the user’s “Documents and Settings” directory for application preferences.
The workaround for this issue is to create a folder to use as a Rational Integration Tester workspace (for example,C:RIT) and edit TestEngine.ini (found in C:\Program Files\IBM\RationalIntegrationTester, by default) to point to it. The line below “-data” should be changed from “@user.home/.rit8/perf-workspace” to “C:/RIT/..rit8/perf-workspace”.

UNC Paths as Current Directory in Run Command Action
Cmd.exe, used by the Rational Integration Tester Run Command test action, may return an error when trying to process a UNC path. More information regarding the resolution is available at


Issue with SSL tab referencing one of a number of identity stores

In a project with multiple identity stores the GUI does not always correctly reflect the one selected.

If you select any identity store from the Identity Store drop down menu and click OK to close the transport window, Rational Integration Tester will select the correct identity store when processing the data. This can be seen when opening up the physical files in the Physical folder of the GH Project on your C drive. The HTTP file references the id of the selected Identity Store correctly.
Error scenario

If you select any identity store from the Identity Store drop down menu, but then reselect the Identity Store drop down menu it will not retain the selected id store and will default back to the first id store in the drop down menu. Clicking OK on the window will then rewrite the physical files on your drive to reference the first id store in the list. So this should be avoided until fixed.

Simultaneous Modifications
If a message is opened in a message editor (for example, a Subscribe action) and the message differences window at the same time, changes made in one window will be overwritten or reverted when closing the other window. More specifically, the content of the window that is closed last will overwrite the content of the window that was closed first.
This also applies if the message differences window is used to correct messages used in a stub if the stub editor window is open. Note that this problem can be avoided by selecting the user preference, “Run from Disk” as opposed to “Run from Memory”.

User Permissions on non-Windows Platforms
It is possible to perform actions in Rational Integration Tester that require the opening of IP ports less than number 1024. For example, if you create and run a stub configured to listen on port 80. On non-Windows platforms this operation requires the user to be an administrator. Before you can run Rational Integration Tester as an administrator, however, you must run the Library Manager as an administrator (this is due to the way the .rit8 directory is created under the user’s home directory). Similarly, if you want to run Rational Integration Tester as a non-admin user, you must first run Library Manager as that non-admin user.

Results Rendering
The third party rendering engine has performance issues when dealing with larger reports, this may be alleviated by increasing the amount of memory allocated to the application.

Invalid Schema Messages
Some message fields may be displayed as invalid (red “x”), even though they are valid fields/messages.

If a newer version of Rational Integration Tester is installed after adding team providers to SCM, the providers will have to be reinstalled unless their installation is outside of the Rational Integration install folder (detailed in Rational Integration Tester Installation Guide).
TIBCO BusinessWorks
  • Private ProcessesThe BW private process transport uses HTTP as its primary communication method, but Rational Integration Tester’s “Publish” test action does not support HTTP. Therefore, the Send Request/Receive Reply action pair should be used for testing private processes.
  • Error schemas are not supported (for example, if a process outputs an error schema rather than an end schema, the error schema/output is not supported in Rational Integration Tester).
  • Rational Integration Tester does not support the following content in private process schemas:
  • A “Choice” content option at the root of the schema
  • Pointing to an AE message from anywhere (i.e. inner or at the root) causes a known deserialization issue
  • The “Java Object Reference” type is not supported at any level
  • The inline WSDL message content option is not supported
  • If you get a connection error when calling a private process, please check the network settings. If you open the Designer Engine Custom Properties in the Physical View of the Architecture School perspective, you will find the host and port number. The host/port in the Physical View menu must match the host/port in the GHEnable.proj design time library in the BW project. The BW host/port can be set when the project is deployed.

Data Transfer Objects (DTOs)
DTO support is currently limited to the following:
  • Classes with a default constructor and publicly visible member variables
  • Member variables must be primitives, wrapper objects, Strings or other objects within the JAR file
JMS providers who use the Context Class Loader to obtain message definitions

Change History

What's new

Review the Release notes in the IBM Knowledge Center for a list of new features and enhancements in the 9.2.0 release.

Click the link in the Download Options column:

[{"DNLabel":"RPTS downloads and fixes","DNDate":"18-6-28","DNLang":"English","DNSize":"100000000","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"","DNURL_FTP":" ","DDURL":null}]

Technical Support

Tab navigation

IBM Rational Software Support Communities

  • Visit the IBM Support Portal to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.
  • Visit developerWorks to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using Rational tools including access to the IBM RFE Community.
  • Visit the Jazz Community if you use a Rational product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track developement progress.

Helpful Hints For Obtaining Technical Assistance:

Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.

Follow IBM Rational Client Support on Twitter | Facebook | YouTube | devWorks Blog

[{"Product":{"code":"SSBLUB","label":"Rational Performance Test Server"},"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"","Edition":""}]

Problems (APARS) fixed
PI97193; PI67480; PI71653; PI91342; PI94310; PI97267; PI97364; PI95453; PI96841; PI96327; PI82417; PI97015; PI68213; PI97860; PI93631; PI95277; PI94022; PI94307

Document Information

Modified date:
21 November 2019