Agent Monitor Window

Open the Agent Monitor window by using the Test Manager menu bar to choose:

The Agent Monitor window contains two sections, the Agent Pool and the Agents Currently In Use.

The Agent Monitor window

Agent Pool

The agent pool lists the active agents that are available to run tests. When active agents connect to the JavaTest harness they are added to the agent pool. When the JavaTest harness requires an active agent to run a test, it moves the agent from the Agent Pool to the Agents Currently In Use section until the test is completed.

The following table lists and describes the contents of the Agent Pool GUI:

Field Description
Listening Click the check box to enable listening for active agents. If listening is not enabled when an agent starts, the agent issues a message that it cannot connect to the JavaTest harness and then waits for its timeout period to end before attempting to re-contact the harness.
Port: Port 1907 is the default port used by active agents. If your agent uses a different port, you must either change the value used by the agent or change this value to match the agent.
Timeout: When the agent pool is empty, the timeout value sets the number of seconds that the JavaTest harness waits between tests for an available agent before reporting the test result as an error. If you run tests with one agent, there is usually a latent period between the time when the agent completes the test and when it returns to the agent pool. The timeout value must be greater than the agent's latent period. The default value of 180 seconds is usually sufficient.

Agents Currently In Use

Lists all agents currently used by the JavaTest harness to run tests. When agents are not running tests they are removed from the list (active agents re-register with the agent pool). Click on an agent in the list to display detailed information about the agent and the test it is running. The detailed information is displayed in the text fields at the bottom and can be used to troubleshoot problems using an agent to run tests.

The following table lists and describes the contents of the Agents Currently In Use GUI:

Field Description
Address The network address of the agent
Tag The test executed by the agent
Request The function executed by the agent
Execute The class executed by the agent
Args The arguments passed to the class executed by the agent
Localize Args Checked if the agent uses a map file