<taskdef name="startScenario" classname="com.ghc.ghTester.ant.StartScenario" classpathref="tasklib" />
<startScenario domain="<Domain name>"
environment="<Environment name>" name="<Scenario name>"
serverUrl="http://Host name or IP address:7819/" />The following table lists the attributes that can you can use with the startScenario Ant task for starting a scenario.
| Attribute | Description | Required |
|---|---|---|
| serverUrl | URL of Rational Test Control Panel. | Yes |
| domain | Domain name | Yes |
| environment | Environment name | Yes |
| name | The name of the target scenario to start. | No |
| owner | Filters the scenarios by owner. | No |
| stopStubs | Available settings are as follows:
|
No, default is NONE |
| async | Run asynchronously (flag). | No, default is synchronous. |
| force | Attempt to first stop any already-running scenario in the environment (flag). | No, default is false. |
| username | Specify the user name to authenticate with Rational Test Control Panel if the environment is locked and the domain security is disabled. | No |
| 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. |
No, default is to send no token. |
| haltOnFailure | Set to true to fail the Ant script if the scenario fails to start (flag). | No, default is false. |
| failureProperty | The name of a property that is set in the event of a failure. | No |
For a description of how to select a scenario, see Scenario selection.
For details of any error codes, see Exit codes for IBM Rational Integration Tester Command-line client and Ant client.