Agent Monitor Window

When you use JavaTest Agents to run tests, you must use the Agent Monitor window to properly set up the JavaTest agent pool for active agents.

If you are using passive agents to run tests, you can use the Agent Monitor window to monitor their activity.

image

Agent Pool

The agent pool is used only with active agents. As active agents connect with the JavaTest harness they are added to the agent pool list until they are needed. The agent pool is the list of agents that are available to run tests. When an agent is actually running tests, it is removed from the agent pool until the tests complete and it is available again.

Listening Click the Listening check box to start the JavaTest harness listening for active agents that are trying to connect. The JavaTest harness must be listening for active agents before they attempt to connect. You must click the Listening check box before you start active agents. If the JavaTest harness is not listening when the agent starts, the agent will issue messages stating that it cannot connect.
Port: Port 1907 is the default port used by active agents. If your agent uses a different port, you must change this value to match the agent.
Timeout: The timeout value is the number of seconds the JavaTest harness waits for an agent to come into the pool if there are none already there. If you run the tests with one agent, that agent is removed from the agent pool while it runs a test. After the agent completes the test, it returns to the agent pool. 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 is the length of time that the JavaTest harness waits between tests for an agent to appear in the pool. The default value of 180 seconds is usually sufficient.

To summarize a few important notes about using active agents:

Agents Currently In Use

The remainder of the Agent Monitor window provides feedback about the status of both passive and active agents that are in use. This information is of most interest as a way of confirming that the agent is running correctly the first few times you run the tests.

Address The network address of the agent being used
Tag A string that identifies the test. If AgentCommand is used, this string is typically the path for the test.
Request A string that identifies the function to be executed by the agent. If AgentCommand is used this value is always "executeCommand".
Execute The class to be executed by the agent
Args The arguments to be passed to the class executed by the agent
Localize Args Specifies whether the arguments are "localized" by means of a map file used by the agent.
area area