The JavaTest agent is a lightweight program compatible with JDK 1.1 that uses a bidirectional serial connection supporting both TCP/IP and RS-232 protocols to communicate between the test system and the JavaTest harness.
You can use the agent provided by the JavaTest harness if your test system meets the following minimum requirements:
The type of agent that you use depends on the communication protocol used between your test system and the JavaTest harness and on the type of initial connection made between the agent and the JavaTest harness:
Mode | Description |
---|---|
Active |
Use active mode (active agent) when you want the agent to initiate the connection to the JavaTest harness via TCP/IP.
Agents using active communication allow you to:
Active agents are used for network connections and are recommended. If the security restrictions of your test system prevent incoming connections then you must use an active agent. The JavaTest harness should be running and agent pool listening should be enabled before starting an active agent. Use Agent Monitor window in the JavaTest harness GUI to enable listening. If listening is not enabled when the agent starts, it returns an error message and waits until its timeout period ends before re-contacting the JavaTest harness. |
Passive |
Use passive mode (passive agent) when you want the agent to wait for the JavaTest harness to initiate the connection via TCP/IP.
Because the JavaTest harness only initiates a connection to a passive agent when it runs tests, passive communication:
Passive agents are used for network connections and must be started before the harness attempts to run tests. If the JavaTest harness issues a request before the passive agent is started, the harness waits for an available agent until its timeout period ends. If the timeout period ends before an agent is available, the JavaTest harness reports an error for the test. |
Serial |
Use serial mode (serial agent) when you want the agent to use an RS-232 serial connection. Serial agents wait for the JavaTest harness to initiate the connection. Infrared, parallel, USB, and firewire connections can also be added through the JavaTest API by modeling the existing serial system.
Because the JavaTest harness only initiates a connection to serial agent when it runs tests, serial communication:
|
Other | If your system does not meet the minimum requirements or if you have unique performance requirements, you can use the JavaTest API to create a custom agent. Refer to your test suite documentation for a description of how to configure and run it. |
Next:
Starting the Agent - start an agent on your test system.