Before you can start the agent GUI, the required classes must be installed on your test system. Refer to Installing Agent Classes on Test Systems for the location and list of classes required to use the agent GUI.
java -cp
class-path com.sun.javatest.agent.AgentFrame
[options]
-cp
option sets the class paths required to run the agent. Use the " ; " or " : " separator appropriate for your test system to separate multiple paths in the argument to the -cp
option. Refer to Classes below for detailed descriptions of the classes that your agent requires.
The agent requires the following classes:
Classes | Descriptions |
---|---|
Agent Classes |
The location of the agent classes installed on your test system. The agent classes are either located in the javatest.jar file or in the directory containing the minimum set of classes required to run the agent from the GUI. Some test suites include additional .jar files containing classes needed for an agent to run tests. These .jar files must also be included in the command string. Refer to Installing Agent Classes on a Test System for a description of how agent classes can be installed.
|
Test Classes | Test classes are located in the classes directory of the test suite. |
The most common error in setting up a test platform to use an agent is entering the wrong class paths in the command string. Configuring your test platform to use the simplest class paths increases the reliability of the test run.
There are four types of options that can be included in the command line used used to start the GUI:
The following options can be used on the command line to display help:
Function | Option |
---|---|
Display Command-Line Help |
-help or -usage
Displays command-line help. |
Display JavaTest Online Help |
-onlineHelp
Displays JavaTest online help without starting the JavaTest harness. Press Control - C to return to the command-line interface. |
The following options are the only parameters that cannot be set in the GUI. If you choose to use them, they must be set in the command line:
Function | Option |
---|---|
Set the Number of Tasks in History |
-history number-of-items
Specifies the maximum number of tasks displayed in the history tabbed pane. The history tabbed pane displays a list of the current and recently completed tasks performed by the agent. Each task is displayed with a code indicating its current state. You can only set the maximum number of tasks from the command line. |
Automatically Start the Agent |
-start
Automatically starts the agent after all command line options are validated. This option is used only if the agent is also configured in the command line. If the |
Set Tracing |
-trace
Sends detailed information about agent activities to the system output stream. You can only set the tracing option from the command line. |
The following options can be set either in the command line or in the GUI that specify how the agent runs tests:
Function | Option |
---|---|
Set Concurrency |
-concurrency number-of-tests
Sets the maximum number of simultaneous requests handled by the agent. Each request requires a separate connection to the JavaTest harness and a separate thread inside the agent. The request may also require a separate process on the test system running the agent. The default setting is one. |
Specify a Map File |
-map map-file
Specifies a map file for the agent to use when translating host specific values. You can also use the parameters tabbed pane to set the map file. |
The following parameters can be used to configure an agent at the time the agent GUI is started:
These parameters duplicate functions of the GUI and should only be used if you have already determined the configuration of the agent for you test system. Refer to Choosing an Agent Configuration.
Anytime the agent is not running, you can use the Parameters tabbed pane to change any of these parameters. Consequently, including these parameters in the command line is not recommended because they add complexity to the command line and duplicate functions already provided by the Parameters tabbed pane.
The following parameters configure the GUI for an active agent:
Function | Option |
---|---|
Use active communication |
-active
Starts an active agent. |
Identifies host |
-activeHost host-name
Connects to the system running the JavaTest harness. For the host-name variable, you can either use the name or the IP address of the system running the JavaTest harness. |
Specifies port |
-activePort port-number
Use only if the JavaTest harness listens for active agents on a port other than 1907. |
The following parameters configure the GUI for a passive agent:
Function | Option |
---|---|
Use passive communication |
-passive
Starts a passive agent. |
Specifies port |
-passivePort port-number
Use only if the JavaTest harness sends requests to passive agents on a port other than 1908. |
The following parameters configure the GUI for a serial agent:
Function | Option |
---|---|
Use serial communication |
-serial
Starts a serial agent. |
Specifies port |
-serialPort port-number
Sets the serial port used by the JavaTest harness to communicate with the agent. |