Home
Rational® Integration Tester
Troubleshooting HCL OneTest™ API
While working with HCL OneTest™ API, you might encounter some problems that you can easily troubleshoot.
Troubleshooting: Java™ method transport
You can use workarounds to common problems that you might encounter when you use the Java™ method transport of HCL OneTest™ API.

Rational® Integration Tester
- Release Notes
  This document contains information about What's new, installation, known issues, and contact information of IBM Support.
- System Requirements
  This document includes information about hardware and software requirements for HCL OneTest™ API.
- Getting Started
  This guide provides an overview and describes the tasks to get you started with HCL OneTest™ API.
- Administrator Guide
  This guide describes how to install HCL OneTest™ API. After you install the software, you can perform administration tasks such as configuration and integration of the product. This guide is intended for administrators.
- Tester Guide
  This guide describes the tasks that you can perform for testing various domains, technologies, and applications. To enable testing, you must configure and enable the environment for testing.
- Test Manager Guide
  This guide describes the tasks that you can perform for tracking the quality of the application. This guide is intended for Test Managers.
- Troubleshooting HCL OneTest™ API
  While working with HCL OneTest™ API, you might encounter some problems that you can easily troubleshoot.
  - Troubleshooting: Installation and configuration
    You can troubleshoot some of the problems that you might encounter when you are installing, configuring, or running HCL OneTest™ API.
  - Global problem notifications
    Problems can occur at a time when HCL OneTest™ API cannot display an error message. Instead, a warning icon is displayed. Double-clicking the icon reveals a list of errors.
  - Working with HCL OneTest™ API logs
    To configure the HCL OneTest™ API logs, including those for the RunTest command when run from the command line, update the HCL OneTest API logging properties file.
  - Working with HCL OneTest™ API Agent logs
    To configure the HCL OneTest™ API Agent logs, including those for the RunTests command when run from the command line, update the HCL OneTest API Agent logging properties file.
  - Working with RQMAgent logs
    To configure the RQMAgent logs, update the RQMAgent logging properties file.
  - Locating the logging properties files
    When you install HCL OneTest™ API, HCL OneTest API Agent, or HCL Quality Server including the HTTP/TCP proxy, several logging properties files are added to each installation's home directory.
  - Logging references
    You can use the following list of logging-related information to help you find information about the logs that are supported by HCL OneTest™ API. All of the programs use the Java logging framework. For details, see the Java logging framework documentation.
  - Debugging failed Windows™ services
    If one of the programs fails to start as a Windows™ service, it can be difficult to determine the cause. Typically the service fails to start but gives no indication of why. The Windows Event log has nothing useful and the process might not have created its log file.
  - Troubleshooting: Installation and configuration
    You can troubleshoot some of the problems that you might encounter when you are installing, configuring, or running HCL OneTest™ API.
  - Troubleshooting: transports, tests, and resources
    Workarounds and solutions for transport diagnostics, creating and running tests, and saving and renaming objects are contained in this topic.
  - HCL OneTest™ API Agent
    You can use workarounds to common problems that you might encounter when you install and run the HCL OneTest™ API Agent.
  - Troubleshooting: HCL Quality Server
    You can use workarounds to troubleshoot common problems that you might encounter when you use HCL Quality Server.
  - Troubleshooting: HCL OneTest™ Virtualization
    You can use workarounds to common problems that you might encounter when you use HCL OneTest™ Virtualization.
  - Troubleshooting: Software AG webMethods
    You can use workarounds to problems that you might encounter when you use the Software AG webMethods.
  - Troubleshooting: Websphere MQ
    You can use workarounds to problems that you might encounter when you use IBM® WebSphere® MQ with HCL OneTest™ API.
  - Troubleshooting: WebSphere® Application Server
    You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Application Server products with HCL OneTest™ API.
  - Troubleshooting: WebSphere® Portal
    You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Portal products with HCL OneTest™ API.
  - Troubleshooting: TIBCO
    You can use workarounds to common problems that you might encounter when you are testing TIBCO products in HCL OneTest™ API.
  - Troubleshooting: Java™ method transport
    You can use workarounds to common problems that you might encounter when you use the Java™ method transport of HCL OneTest™ API.
  - Troubleshooting: HTTP and Web Services
    You can use workarounds to common problems that you might encounter when you use HTTP and Web Services.
  - Troubleshooting: TCP UDP sockets
    You can use workarounds to common problems that you might encounter when you use TCP and UDP transports.
  - Troubleshooting: Testing on IBM® z/OS®
    You can use workarounds to common problems that you might encounter when you use IBM® z/OS® with HCL OneTest™ API.
- HCL OneTest™ API reference
  HCL OneTest™ API is a scripting-free environment for developing tests for service-oriented architecture (SOA) messaging and business process integration projects. Tests can be built by recording existing system behaviors or from requirements, by entering the data to send and the data that is expected in return.
- Security Considerations
  You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
- Notices
  This document provides information about copyright, trademarks, terms and conditions for product documentation.

Troubleshooting: Java™ method transport

You can use workarounds to common problems that you might encounter when you use the Java™ method transport of HCL OneTest™ API.

When you start a Java™ application into which the Java™ virtualization agent is installed, VerifyError messages, such as the following example, might be displayed.
Exception in thread "main" java.lang.VerifyError: JVMVRFY012 stack shape inconsistent; class=com/ibm/crypto/provider/IBMJCE, method=<clinit>()V, pc=308 at java.lang.J9VMInternals.verifyImpl(Native Method)
Complete the following steps:
1. Open the Logical View of the Architecture School perspective.
2. Double-click the relevant logical Java™ application resource. The Java™ application window is displayed.
3. Click the Recording Studio tab.
4. Under Filter, add a filter to exclude the referenced class. If this problem persists, send a reproducible example to IBM® Support.
If you are unable to record Java™ methods by using the Java™ Agent, detailed troubleshooting instructions are available in the following technote:
Diagnosing Java™ Virtualization Agent recording issues. Diagnostics are available from IBM® Support if you need further help.