Working with agent capabilities

When you installed static agents V10.1.2 or later, and added them to your project, you can view capabilities of the agents from the Infrastructure page. When you installed static agents V10.2.0 or later, you can add, view, edit, or delete properties and capabilities of agents from the User Defined panel of that agent.

Before you begin

You must have completed the following tasks:

Procedure

  1. Log in to Rational® Test Automation Server and open the team space.
  2. Open your project, and then click Manage > Infrastructure.

    The agents that you added to your project are displayed on the Infrastructure page.

  3. Expand the agent.

    The Details and Capabilities tabs are displayed.

  4. Click Capabilities to view the capabilities of the agent.
  5. Click User Defined.

    The User Defined Capabilities dialog box is displayed.

  6. Complete the steps for the task that you want to perform as listed in the following table:
    Task Action
    Adding capabilities
    Perform the following actions:
    1. Click Add new.
    2. Enter the name of the capability in the Capability Name field.
    3. Perform any of the following actions in the User Defined Category field:
      • Select an existing category from the list.
      • Enter a name of the category for the capability, if the category does not exist.
        Note: You can also click Add new to add a category.
      The category for the capability is either selected or created and the fields for the property name and value are displayed.
      Note: The property for a capability is a name-value pair.
    4. Enter a name for the property in the Property Name field and its corresponding value in the Property Value field for the capability.
      Note: You can add multiple properties for the same capability under the same category or under different categories by clicking Add new property, and then by entering the name and value for the property.
    5. Click Save.
    The capabilities that you added are displayed.
    Viewing capabilities that you added

    The User Defined Capabilities panel displays the capabilities that you added to the agent.

    Editing capabilities that you added
    Perform the following actions:
    1. Click the Edit icon image of the edit icon in the row of the capability that you want to edit.

      The user-defined capability is enabled for editing. You can edit the name of the capability, or the property name or property value.

    2. Edit any of the items that you want for the user-defined capability.
    3. Click Update.
    The updated capability of the agent is displayed.
    Deleting capabilities that you added
    1. Click the Delete icon image of the edit icon in the row of the capability that you want to delete.
    2. Click Delete.
    The capability that you selected is deleted along with all the properties that you added for the capability.
    Deleting a property defined for a capability
    1. Click the Edit icon image of the edit icon in the row of the capability that you want to edit and remove a defined property.

      The user-defined capability is enabled for editing.

    2. Select and delete the contents in the Property Name field and its corresponding Property Value field.
    3. Click Update.
    The property is removed for the capability.

Results

You have added, viewed, edited, or deleted a property or the user-defined capability of an agent.

What to do next

You can run the tests on the agent from the Execution page. See Test run configurations.