Documentation / Commands / DEL CONNECTION

DEL CONNECTION

Core command DEL CO DELCO DE CO DECO

Deletes an existing database connection

Arguments

<id> (mandatory) existing connection ID

Examples

DEL CONNECTION MYDB01;

Notes

Soft-deletes an existing database connection: DEL CONNECTION <id>.

id is mandatory and must exist, active, in the Connections Definition File (CDF), otherwise the command fails with an error (a distinct one when id is already inactive, rather than the generic "must provide a valid ID" used for a truly unknown one). Asks for a [y/n/c] confirmation before proceeding; only y deletes, any other answer aborts.

This is a <em>soft</em> delete: the connection is marked inactive rather than removed, so its history is preserved and it can be reactivated (REACTIVATE CONNECTION, or from the config screen's "Inactive connections" view) rather than recreated from scratch. Use HARDDEL to permanently remove an already-inactive connection instead.

Last modified in release 5.0.8.