.\" XXX standard disclaimer belongs here....
.\" $Header: /private/postgres/ref/postquel/RCS/listen,v 1.4 1992/07/14 05:54:17 ptong Exp $
.SP "LISTEN" COMMANDS 3/25/92
.XA 2 "Listen"
.uh NAME
.lp
listen \(em Listen for notification on a relation
.uh SYNOPSIS
.lp
.(l
\fBlisten\fR relation_name
.)l
.uh DESCRIPTION
.lp
.b listen
is used to register the current backend as a listener on the relation
.b relation_name.
When the command 
.b notify 
.b relation_name
is called either from within a rule or at the query level, the
frontends corresponding to the listening backends are notified.
.uh "SEE ALSO"
.lp
retrieve(commands), notify(commands), definerule(commands), libpq.
.uh BUGS
