Updating an environment by using an Ant task

You can update values of the attributes of an environment by using the IBM® Rational® Test Control Panel Ant task.

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

<updateEnvironment domain="<Domain name>" environment="<Environment name>" 
serverUrl="https://Hostname or IP address:5443/RTCP/" tagsPropertyFile="<Properties file name>" 
username="<user name>" securityToken="<Security token>" />
You can update the values of the following attributes of an environment:
  1. The URL of Rational® Test Control Panel.
  2. The domain name.
  3. The name of the environment.
  4. The tags to be updated in the environment.

The following table lists the attributes that you can use with the updateEnvironment Ant task for updating an environment.

Table 1. List of available attributes
Attribute Description Required
domain Domain name Yes
environment The name of the environment to be updated. Yes
securityToken The value of the security token to use for authentication with Rational® Test Control Panel when domain security is enabled. For more information, see Domain level security. No
serverUrl URL of the Rational® Test Control Panel Yes
tagsPropertyFile The path to a property file that specifies the environment tags to be set for the environment, which replace all the tags that are currently present for the environment. Yes
username The user name under which to perform the operation. No
Note: All environment events are recorded in the Rational® Test Control Panel Audit log. (For information about this log, refer to Administration of Rational Test Control Panel.)

Error codes

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