pg_on_connection

pg_on_connection_loss
Prev	4.5. Notification and Notice Processing Commands	Next

pg_on_connection_loss

pg_on_connection_loss — Set a callback for unexpected connection loss

Synopsis

pg_on_connection_loss conn ?callbackCommand?

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.

Arguments

conn: The handle of the connection to watch for connection losses.
callbackCommand: If present, provides the command string to execute when connection loss is detected. If absent, an existing command string for connection loss is canceled.

Return Value

Nothing. Throws a Tcl error if an error occurs.

Notes

This command is not available in pgintcl.

Prev	Up	Next
pg_listen	Home	pg_notice_handler