DISCONNECT Command

Description:

This command closes one or all of the TCP connections established using the CONNECT command. It is only valid within a script that has been defined as MODE HTTP.

If the "FROM conid" clause is specified, the TCP connection identified by that Connection ID will be closed. If the "ALL" keyword is used, all TCP connections established by the current thread will be closed.

By default, the DISCONNECT command will wait until any requests on the connection(s) to be closed are complete before closing them. If the WITH CANCEL clause is specified, the connection(s) will be closed immediately.

The Connection ID specified must correspond to a TCP connection established using the CONNECT command, otherwise a script error will be reported.

Format:

 DISCONNECT [FROM conid | ALL ] {,WITH CANCEL}

Parameters:

conid

An integer variable, integer value or integer expression identifying the Connection ID of the TCP connection to be closed.

Examples:

 DISCONNECT FROM 1
 DISCONNECT FROM conid
 DISCONNECT FROM 1, WITH CANCEL
 DISCONNECT ALL
 DISCONNECT ALL, WITH CANCEL

See also:

Miscellaneous Commands