select open change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

Unsupported versions: 7.4 / 7.3
Historical version. PostgreSQL 7.3 reached end of support in November 2007. See the current manual for supported releases.

pg_on_connection_loss

Name

pg_on_connection_loss -- set or change a callback for unexpected connection loss

Synopsis

pg_on_connection_loss dbHandle callbackCommand

Inputs

dbHandle

Specifies a valid database handle.

callbackCommand

If present, provides the command string to execute when connection loss is detected.

Outputs

None

Description

pg_on_connection_loss creates, changes, or cancels a request to execute a callback command if an unexpected loss of connection to the database occurs. With a callbackCommand parameter, the request is established, or the command string of an already existing request is replaced. With no callbackCommand parameter, a prior request is canceled.

The callback command string is executed from the Tcl idle loop. That is the normal idle state of an application written with Tk. In non-Tk Tcl shells, you can execute update or vwait to cause the idle loop to be entered.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current manual.