WebSphere Message Brokers
File: au19690_
Writer: Jane Brockbank

Reference topic

This build: July 31, 2007 21:39:51

Neighbor changes

A change in the set of neighbors (the topology) for a given broker publishes an event using the following system topic:
$SYS/Broker/broker_name/Neighbor
where broker_name is the name of the broker issuing this message.

The body of each publication is an XML message that describes the change made.

These events are nonpersistent, non-retained publications.

Certain operations delete all neighbor (topology) information at a broker. In this case, the deleted neighbors are not published in the event publication. Instead, the body of the event publication contains a single XML tag that indicates that all neighbors have been deleted.

Examples

The following example event messages show a neighbor being created, changed, and deleted, together with an example of all neighbors being deleted.

Neighbor created

Event publication topic = "$SYS/Broker/Broker1/Neighbor"

<Broker uuid="1234" label="Broker1" version="1">
  <ControlGroup>
    <DynamicSubscriptionEngine>
      <Create>
        <Neighbor name="5678" collectiveId="">
          <MQBrokerConnection queueManagerName="nbr_QM_Name"/>
        </Neighbor>
      </Create>    </DynamicSubscriptionEngine>
  </ControlGroup>
</Broker>

Neighbor changed

Event publication topic = "$SYS/Broker/Broker1/Neighbor"

<Broker uuid="1234" label="Broker1" version="1">
  <ControlGroup>
    <DynamicSubscriptionEngine>
      <Change>
        <Neighbor name="5678"
          collectiveId="12345678-1234-1234-1234-123456789abc"/>
      </Change>
    </DynamicSubscriptionEngine>
  </ControlGroup>
</Broker>

Neighbor deleted

Event publication topic = "$SYS/Broker/Broker1/Neighbor"

<Broker uuid="1234" label="Broker1" version="1">
  <ControlGroup>
    <DynamicSubscriptionEngine>
      <Delete>
        <Neighbor name="5678"/>
      </Delete>
    </DynamicSubscriptionEngine>
  </ControlGroup>
</Broker>

All neighbors deleted

Event publication topic = "$SYS/Broker/Broker1/Neighbor"

<Broker uuid="1234" label="Broker1" version="1">
  <ControlGroup>
    <DynamicSubscriptionEngine>
      <Delete>
        <AllNeighbors/>
      </Delete>
    </DynamicSubscriptionEngine>
  </ControlGroup>
</Broker>
Related concepts
Broker domains
Related tasks
Creating a broker
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:39:51

au19690_ This topic's URL is: