CONNECT Command

Description:

This command may be used to establish a TCP connection to a nominated host. It is only valid within a script that has been defined as MODE HTTP.

This command specifies an ID for the TCP connection. This may be used in subsequent GET, HEAD, POST and LOAD RESPONSE_INFO commands to use this TCP connection. The TCP connection may be closed using the DISCONNECT command. It will also be terminated when the thread exits the script.

The connection ID specified must not correspond to a TCP connection already established previously using the CONNECT command. Otherwise a script error will be reported.

Format:

 CONNECT TO host ON conid

Parameters:

host

A character variable, quoted character string or character expression, containing the host name or IP address of the resource to connect to and, optionally, the port number on which the connection is to be made. If a port is specified, it must be separated from the host field by a colon (":"). If the port number field is empty or not specified, the port defaults to TCP 80.

conid

An integer variable, integer value or integer expression defining the connection ID. This is used in all subsequent operations on this connection.

Examples:

 CONNECT TO "proxy.dev.mynet:3128" ON 1
 CONNECT TO myhost ON 2
 CONNECT TO 'abc.com' ON conid 

See also:

Miscellaneous Commands