Welcome
Troubleshooting
While working with HCL DevOps Test Integrations and APIs (Test Integrations and APIs), you might encounter some problems that you can easily troubleshoot.
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.
Troubleshooting: IBM® Engineering Test Management
You can use workarounds to common problems that you might encounter when you work with Engineering Test Management.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test Integrations and APIs (Test Integrations and APIs). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System requirements
This document includes information about hardware and software requirements for HCL DevOps Test Integrations and APIs (Test Integrations and APIs) 2024.03 (11.0.1).
Getting Started
This guide provides an overview and describes the tasks to get you started with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
Administrator Guide
This guide describes how to install HCL DevOps Test Integrations and APIs (Test Integrations and APIs). 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
While working with HCL DevOps Test Integrations and APIs (Test Integrations and APIs), 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 DevOps Test Integrations and APIs (Test Integrations and APIs).
- Global problem notifications
  Problems can occur at a time when Test Integrations and APIs cannot display an error message. Instead, a warning icon is displayed. Double-clicking the icon reveals a list of errors.
- Working with DevOps Test Integrations and APIs logs
  To configure the HCL DevOps Test Integrations and APIs (Test Integrations and APIs) logs, including those for the RunTest command when run from the command line, update the Test Integrations and APIs logging properties file.
- Working with DevOps Test Integrations and APIs Agent logs
  To configure the HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) logs, including those for the RunTests command when run from the command line, update the Test Integrations and APIs 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 Test Integrations and APIs, Test Integrations and APIs Agent, or Test Virtualization Control Panel 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 Test Integrations and APIs. 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 DevOps Test Integrations and APIs (Test Integrations and APIs).
- 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.
  - Debugging with the JVM console
    You can use the Test Integrations and APIs JVM console to debug any errors that might occur while you are working with Test Integrations and APIs.
  - Limitations of topology discovery
    You must be aware of certain limitations in Topology discovery.
  - Limitations of packet capture
    You must be aware of certain limitations of packet capture.
  - WSDL versioning considerations
    Managing WSDL versions is a common problem that is faced by web services developers. Some guidance is provided to help address the problem.
  - Troubleshooting: COBOL copybook schemas
    You can use a workaround to problem that you can encounter after you import a COBOL copybook schema into Test Integrations and APIs.
  - Troubleshooting: WSDL schemas
    You can use some workarounds to problems that you might encounter during and after the import of a WSDL schema into HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
  - Troubleshooting: Messages
    You can use a workaround to a problem that you might encounter when you work with message fields.
  - Troubleshooting: IBM® Engineering Test Management
    You can use workarounds to common problems that you might encounter when you work with Engineering Test Management.
- Troubleshooting: DevOps Test Integrations and APIs Agent
  You can use workarounds to common problems that you might encounter when you install and run the HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent).
- Troubleshooting: DevOps Test Virtualization Control Panel
  You can use workarounds to troubleshoot common problems that you might encounter when you use HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
- Troubleshooting: DevOps Test Virtualization
  You can use workarounds to common problems that you might encounter when you use HCL DevOps Test Virtualization (Test 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 DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: WebSphere® Application Server
  You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Application Server products with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: WebSphere® Portal
  You can use workarounds to problems that you might encounter when you use IBM® WebSphere® Portal products with HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: TIBCO
  You can use workarounds to common problems that you might encounter when you are testing TIBCO products in HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: Java™ method transport
  You can use workarounds to common problems that you might encounter when you use the Java™ method transport of HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- Troubleshooting: Java™ applications that use JDBC
  You can use workarounds to problems that you might encounter when you test Java™ applications in HCL DevOps Test Integrations and APIs (Test Integrations and APIs).
- 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 DevOps Test Integrations and APIs (Test Integrations and APIs).
Reference Guide
This guide provides the topics to help the API tester use the product by using the user interface, commands or scripts. This guide is intended for API testers.
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: IBM® Engineering Test Management

You can use workarounds to common problems that you might encounter when you work with Engineering Test Management.

Table 1. Troubleshooting Engineering Test Management
Solutions and workarounds to problems with Engineering Test Management
Problem	Resolution
Test Integrations and APIs Agent 9.0 after configuring as a Rational® Quality Manager adapter to use TLSv1.2 does not connect to enable remote test execution.	Install Test Integrations and APIs 9.1.0 or later. Otherwise, for 9.0 add the following Java™ parameter: `-Dhttps.protocols=TLSv1.2` For Test Integrations and APIs, add it to `RQMAgent.ini`. For Test Integrations and APIs Agent, add it to the Library Manager JVM arguments. Note: To see what protocol is used by the Agent when connecting to Engineering Test Management, add the following Java™ parameter to `RQMAgent.ini` and `Agent.ini`. `-Djavax.net.debug=all`
After you execute tests or suites from Engineering Test Management, and click Test Results on RTCP (Click Here) from the Test Case or Test Suite Results window, a dialog opens prompting you to enter a database name. This dialog shows because you did not configure a project results database to use and so the connection to the database fails.	You must configure the project results database and publish the results database connection details from the Test Integrations and APIs project that contains the tests and suites to Test Virtualization Control Panel. For more information, see Working with DevOps Test Integrations and APIs resources in IBM Engineering Test Management.
When Test Integrations and APIs Agent is using an Asian locale, results from executing Test Integrations and APIs tests and suites in Engineering Test Management do not show in an Asian language.	Change the Asian locale to an English locale by using one of the following ways: Edit `Agent_installation_directory/RunTests.ini` and append the following lines: `-nl en` Edit `Agent_installation_directory/LibConfig` and add the following JVM argument: `-Duser.language=en_US` Export the Test Integrations and APIs tests and suites again and execute them from Engineering Test Management. The results show in English in Engineering Test Management.