# Specifying Active Agent Options

Active agents can be configured and run from the application command-line, the application or applet GUI, or the applet tag. Refer to Starting a JT Harness harness agent for a description of the different features and functions that each provides.

Depending on how you choose to start the agent, you must set the following minimum set of parameters either in the command line, the GUI Parameter pane, or the applet tag:

- Mode
- Host
- Port

## Mode

The type of agent mode that you use determines how the agent communicates with the JT Harness harness and the protocol that is used. An active agent initiates the connection to the JT Harness harness using TCP/IP communications protocol.

To specify an active agent mode, use the appropriate setting or option from the following table.

Interface | Option or Setting
--- | ---
Default | Active
Command line | -`active`
Applet tag | `<param name=mode value=active>`
GUI Parameter pane |

## Host

The host option identifies the system running the JT Harness harness. Because an active agent initiates the connection to the JT Harness harness, the location of the system running the JT Harness harness must be set before it can run.

To specify the system running the JT Harness harness, use the appropriate setting or option from the following table.

Interface | Option or Setting
--- | ---
Default | None
Command line | -`activeHost` host-name
Applet tag | `<param name=activeHost value=host-name>`
GUI Parameter pane |

## Port

The port option specifies the port used by the active agent to communicate with the JT Harness harness. The agent and JT Harness harness must use the same port. If the ports are not the same, the agent cannot communicate with the JT Harness harness. The default value for active agents is 1907.

To specify a port other than 1907, use the appropriate setting or option from the following table.

Interface | Option or Setting
--- | ---
Default | 1907
Command line | `-activePort` port-number
Applet tag | `<param name=activePort value=port-number>`
GUI Parameter pane |

Next task:

Specifying Additional Agent Options: Additional parameters to display help or configure other agent properties.

Copyright © 2002, 2011, Oracle and/or its affiliates. All rights reserved.