Stop a stub by using an Ant task

You can stop a stub by using the IBM® Rational® Test Control Panel Ant tasks.

Here is an example syntax:
  <taskdef name="stopStub" classname="com.ghc.ghTester.ant.StopStub" classpathref="tasklib" />

<stopStub domain="<Domain name>"
 environment="<Environment name>" component="
<Component name>" operation="<Operation
 name>" name="<Stub name>" version="<Stub
 version number>" serverUrl="https://<Host name
 or IP address>:5443/RTCP/"/>
The following example usage files for the Ant tasks are available in the AntClient.zip package that can be downloaded from Rational® Test Control Panel. For more information, see Rational® Integration Tester tool packages.
  • create-update-delete-environment.xml
  • lock-unlock-environment.xml
  • publish-stubs.xml
  • start-stop-scenario.xml
  • start-stop-stub.xml

The following table lists the attributes that you can use with the stopStub Ant task for stopping a stub.

Table 1. List of available attributes
Attribute Description Required
serverUrl URL of the Rational® Test Control Panel Yes
domain Domain name Yes
environment Environment name Yes
component Component the stub exists within. No
operation The operation the stub exists within on the server. No
name The name of the target stub to stop. Yes
version Version of the target stub to stop. No
async Run asynchronously (flag). No, default is synchronous.
username Specify the user name to authenticate with the server if the environment is locked and the domain security is disabled. No
securityToken

Specify the security token generated for you 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.

No, default is to send no token.
haltOnFailure Set to true to fail the Ant script if the stub fails to stop (flag). No, default is false.
failureProperty The name of a property that is set in the event of a failure. No

Error codes

For details of any error codes, see Exit codes for Command-line client and Ant client.