Provided by: slony1-doc_1.2.14-1ubuntu1_all bug

NAME

       STORE  LISTEN  - Configure Slony-I node to indicate where to listen for
       events

SYNOPSIS

       STORE LISTEN (options);

DESCRIPTION

       A ‘listen’ entry causes a node (receiver) to query  an  event  provider
       for   events   that   originate  from  a  specific  node,  as  well  as
       confirmations from every existing node. It requires a ‘path’  to  exist
       so  that  the  receiver  (as  client)  can  connect to the provider (as
       server).

       Every node in the system must listen for events from every  other  node
       in  the system. As a general rule of thumb, a subscriber (see SUBSCRIBE
       SET(7)) should listen for events  of  the  set’s  origin  on  the  same
       provider,  where  it receives the data from. In turn, the origin of the
       data set should listen for events  from  the  origin  in  the  opposite
       direction. A node can listen for events from one and the same origin on
       different providers at the same time. However, to process  SYNC  events
       from  that origin, all data providers must have the same or higher sync
       status, so this will not result in any faster replication behaviour.

       ORIGIN = ival
              Node ID of the event origin the receiver is listening for.

       PROVIDER = ival
              Node ID of the node from which the  receiver  gets  events  that
              come from the origin. If not specified, default is the origin.

       RECEIVER = ival
              The ID of the node receiving the events.

       This  uses  “schemadocstorelisten(  integer,  integer,  integer )” [not
       available as a man page].

       For more details, see “Slony-I listen paths” [not available  as  a  man
       page].

EXAMPLE

            STORE LISTEN ( ORIGIN = 1, RECEIVER = 2, PROVIDER = 3 );

LOCKING BEHAVIOUR

       No application-visible locking should take place.

VERSION INFORMATION

       This  command  was  introduced  in  Slony-I 1.0. As of version 1.1, you
       should no longer  need  to  use  this  command,  as  listen  paths  are
       generated automatically.

                               19 September 2008               STORE LISTEN(7)