Stop a stub by using the command line
You can stop all instances of a stub by using the Integration
Tester command line. This option is useful in situations where Ant
is not available.
The syntax to use is as follows:
IntegrationTesterCmd Options stop-stub
Here is an example syntax of synchronous mode, where there is
only one stub in the environment, and it only has one version:
IntegrationTesterCmd --serverUrl "https://Host name or IP address:5443/RTCP"
--domain <Domain name> --environment <Environment name>
--name <Stub name> stop-stub
Here is an example syntax of asynchronous mode, where component
and operation are used to precisely identify a stub, a specific version
is specified, and the user has locked the environment:
IntegrationTesterCmd --serverUrl "https://Host name or IP address:5443/RTCP/"
--domain <Domain name> --environment <Environment name>
--component <Component name> --operation <Operation name>
--name <Stub name> --version <Stub version number>
--username <User name> --async stop-stub
The following table lists the options that you can use with the IntegrationTesterCmd command for stopping a stub.
Option | Description |
---|---|
--serverUrl/-u | URL of the Rational® Test Control Panel. |
--domain/-d | Domain name |
--environment/-e | Environment name |
--component/-c | Component the stub exists within (optional). |
--operation/-o | The operation the stub exists within on the server (optional). |
--name/-n | The name of the target stub to stop. |
--version/-v | Version of the target stub to stop (optional).
Note: If you are using Rational
Integration Tester 9.1.1.1 or
later, and the Rational
Test Control Panel command
line or Apache Ant tasks are used to stop a stub, and if no stub version information is provided, it
is the latest version of a stub with running instances that is stopped. If you are using 9.1.1 or
earlier, and the Rational
Test Control Panel command
line or Apache Ant tasks are used to stop a stub that has multiple versions, and if no stub version
information is provided, an error is reported.
|
--async/-a | Run asynchronously; defaults to synchronous (flag). |
--username/-l | Specify the user name to authenticate with the server if the environment is locked and the domain security is disabled. |
--securityToken | Specify the security token generated for the user to authenticate with Rational Test Control Panel when the domain security is enabled. In the locked environment mode, the operation can be performed by the user who locked the environment. For more information, see Domain level security and Managing environments. |
Error codes
For details of any error codes, see Exit codes for Command-line client and Ant client.