Two types of additional options can be used:
The help option only displays command-line help for the agent regardless of the application class used in the command line. To start an agent application or applet after displaying command-line help, perform Starting the Agent.
The following options are only used on the command line to display help:
Option | Function |
---|---|
-help or -usage
|
Displays command-line help.
Example:
|
The following options can be set in the application command-line, the application or applet GUI, or the applet tag.
Specifies that the agent use a map file to translate host specific values. Refer to Creating a Map File for additional information about map files.
To specify a map file, use the appropriate setting or option from the following table:
Interface | Option or Setting |
---|---|
default | none (empty) |
command line |
-map map-file
|
applet tag |
<param name=map value=map-file-url>
|
GUI Parameter Pane |
![]() |
To run tests concurrently, set 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.
To run concurrent tests, use the appropriate setting or option from the following table:
Interface | Option or Setting |
---|---|
default | one |
command line |
-concurrency number-of-tests
|
applet tag |
<param name=concurrency value=number-of-tests>
|
GUI Parameter Pane |
![]() |
Specifies the maximum number of tasks displayed in the history tabbed pane. Refer to History Tabbed Pane for a description of the history tabbed pane and how it is used to monitor an agent.
To set the tasks displayed in the history tabbed pane, use the appropriate setting or option from the following table:
Interface | Option or Setting |
---|---|
default | one |
command line |
-history number-of-items
|
applet tag |
<param name=history value=number-of-items>
|
GUI | Not Supported |
This option is only used with the application GUI class or as a parameter in the applet tag. When used, the autostart option automatically starts the agent after all command line options are validated and the GUI is displayed. The agent must be completely configured in the command line or applet tag. When the -start
option is not used, click the Start button in the agent GUI to start testing.
To autostart the agent when the GUI is displayed, use the appropriate setting or option from the following table:
Interface | Option or Setting |
---|---|
default | false |
command line |
-start
|
applet tag |
<param name=autostart value=true>
|
GUI |
![]() |
Sends detailed information about agent activity to the system output stream.
To start tracing when the agent is run, use the appropriate setting or option from the following table:
Interface | Option or Setting |
---|---|
default | false |
command line |
-trace
|
applet tag |
<param name=trace value=true>
|
GUI | Not Supported |
Next:
Monitoring JavaTest Agents - monitor an agent while it runs tests.