Working in non-GUI mode

You can use the tools and executable files that are provided along with the product software. You can use these tools to perform different test actions in a non-GUI mode.

You can find the following information:

Tools and executable files

Rational® Integration Tester and Rational® Integration Tester Agent provide tools and executable files that you can use. These are located in the installation folders where you install Rational® Integration Tester and Rational® Integration Tester Agent.

The following table describes the tools and executable files that you can use in Rational® Integration Tester:
Applications in Rational® Integration Tester installation folder Description
IntegrationTester Executable file that starts Rational® Integration Tester on your computer.
IntegrationTesterCmd Tool with which you can run various command line tasks.
LibConfig Executable file that starts Library Manager of Rational® Integration Tester on your computer.
RunTests Tool with which you can run tests by using the command line interface.
EncryptPassword Tool with which you can encrypt passwords for use in configuration files.
RQMAgent Executable file that starts a server for running tests from Rational® Quality Manager or Engineering Test Management.
The following table describes the tools and executable files that you can use in Rational® Integration Tester Agent:
Applications in Rational® Integration Tester installation folder Description
Agent Executable file that starts Rational® Integration Tester Agent on your computer.
LibConfig Executable file that starts Library Manager of Rational® Integration Tester Agent on your computer.
EncryptPassword Tool with which you can encrypt passwords for use in configuration files.
RunTests Tool with which you can run tests by using the command line interface.

Applications for internal use

The following tools that are found in the installation folders of Rational® Integration Tester and Rational® Integration Tester Agent are for internal use by the applications and you cannot use these tools.

Tools in Rational® Integration Tester for internal use:
  • Eclipse
  • MercuryTest
Tools in Rational® Integration Tester Agent for internal use:
  • Eclipse
  • Probe
  • TestEngine

Availability of the various interfaces

Command line
Both the RunTests and IntegrationTesterCmd commands are supplied with Rational® Integration Tester. For more information on the commands, see Command-line interfaces.
Ant
Support for the environment, scenario and stub Ant tasks is supplied with Rational® Test Control Panel. Support for the IntegrationTester Ant task is supplied only with Rational® Integration Tester. For more information on the Ant tasks, see Ant tasks.
REST
The REST interfaces described here are only a set of specifications, so no client is provided. However REST calls must be made to an instance of Rational® Test Control Panel. For more information on the REST services, see REST services.

Usage of the various interfaces

Note: When Ant tasks and Rational® Integration Tester commands communicate with the server over HTTPS any certificate that is presented by Rational® Test Control Panel is trusted.
Examples of processes that might run REST API commands include:
  • Automated build processes
  • Reporting tools
  • Plug-ins for other tools
  • Custom software programs

Many different programs can run REST commands. To run the command, you send an HTTP request to a REST resource and pass HTTP query parameters or a request body. The request body is typically in XML format, although a few resources use JSON.

Alternatively, build processes that already use the Apache Ant client can use the Ant API. When calling from other scripts, or executing commands manually, you can call the API directly from the command line, as in the following example:
IntegrationTesterCmd --serverUrl "https://example.com:5443/RTCP/" --domain myDomain --environment localhost --name "My stub" start-stub

You can also call an Ant task from the command line.

Using the command line requires an installation of Rational® Integration Tester, and using Ant requires the Rational® Test Control Panel Ant tasks archive file, as well as an installation of Ant. Stand-alone programs written in languages like Java and C# can call REST methods directly.

The following table provides an overview of the actions that can be also be completed by using a non-GUI interface.
Table 1. Available actions and their associated interfaces
Actions Command line Ant tasks REST services, grouped by resource type
Managing authentication for REST services See REST services.
Running tests RunTests IntegrationTester
Managing test results IntegrationTesterCmd command
Managing domains See all the REST services at /RTCP/api/swagger-ui.html
Managing environments IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html
Managing scenarios IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html
Managing stubs IntegrationTesterCmd command See all the REST services at /RTCP/api/swagger-ui.html

Domain level security

Note: By default, domain-level security is not enabled.
If domain-level security is enabled, a security token must be specified.
  • For the command-line, use the securityToken option.
  • For Ant tasks, use the securityToken attribute.
  • For the REST APIs, use the X-Jazz-Session Authorization header. For more details, see REST and Rational Test Control Panel security.
For information about how to create a security token, see Creating and assigning security tokens.