DISCONNECT statement
Use the DISCONNECT statement to terminate a connection between an application and a database server.
Syntax
(explicit id discon001)
discon001
DISCONNECT
{
CURRENT
| []
{
ALL
| DEFAULT
}
| {
'connection'
| connection_var
}
}
Element | Description | Restrictions | Syntax |
---|---|---|---|
connection | String that specifies a connection to terminate | Connection name that the CONNECT statement assigned | Quoted String |
connection_var | Host variable that holds the name of a connection | Must be a fixed-length character data type | Language specific |
Usage
DISCONNECT terminates a connection to a database server. If a database is open, it closes before the connection drops. Even if you made a connection to a specific database only, the connection to the database server is terminated by DISCONNECT. If DISCONNECT does not terminate the current connection, the connection context of the current environment is not changed.
DISCONNECT is not valid as statement text in a PREPARE statement.
In ESQL/C, if you disconnect with connection or connection_var, DISCONNECT generates an error if the specified connection is not a current or dormant connection.
1 ESQL/C only