Testing the connection

Use telnet to test the connection to the agent.

Note: Connecting to the agent using telnet for this test requires that telnet support for the agent is enabled. To enable support make sure that the keyword disable_telnet_support is commented in the agent configuration file.

To test the connection from the command line, do the following:

Connect to the agent with a telnet command. If you are logged on to the host where the agent is running, you can use localhost as the host name.
```
telnet hostname 5555
```
This response indicates a successful connection:
```
200 HELLO - BuildForge Agent v7.0.1.buildnumber
```
Check authentication by issuing the following commands, using your login credentials:
```
telnet localhost 5555
username user name
password  password
cmd ping
go
```
Note: The commands are not processed until you type the go command.

The following output of a telnet session is typical. In particular look for RESULT 0 at the end of the output as an indication of success.

200 HELLO - BuildForge Agent v7.1.0.0-0-0241
username bgreen
password rtc4fun
cmd ping
go
320 AUTH AuthOk["bgreen"]
320 SET EnvSet["BF_AGENT_VERSION","7.1.0.0-0-0241"]
320 SET EnvSet["BF_AGENT_PLATFORM","os/390 19.00 03"]
320 EXEC Locale["C"]
320 PTY Pty[*PtyPipe]
320 EXEC Locale["C"]
320 EXEC ExecShellPath["/bin/sh"]
300 HEARTBEAT 1
310 PLAT os/390 19.00 03
320 PING PingOk
251 RESULT 0
260 EOR