Creating a foreign destination on a bus

You create a foreign destination on a service integration bus (the local bus) to represent a destination that is defined in another bus (a foreign bus). You use a foreign destination when you need to override messaging defaults, security settings, or both for an individual destination on a foreign bus.

About this task

In the following diagram, a foreign destination in Bus A points to a target destination on Bus B. A JMS application connects to Bus A and sends a message to the queue targetQueue in Bus B. The application uses the JMS connection factory and JMS queue without being aware of the associated foreign destination.

This figure is described in the surrounding text.

The foreign destination encapsulates the name of the target destination that exists in the foreign bus (Identifier property) and the name of that foreign bus (Bus property). An application that wants to use the foreign destination to exchange messages with the target destination must specify the Identifier and Bus properties.

For example, an administrator wants JMS applications to connect to one bus, BusA, and send messages to a JMS queue backed by a queue, targetQueue, on another bus, BusB. The administrator connects the buses, creates a foreign destination on BusA and sets the following properties on the foreign destination and JMS queue:
Table 1. Properties for creating a foreign destination on a bus
JMS queue Foreign destination (on BusA) Queue (on BusB)
Queue name targetQueue
Bus name BusB
Identifier targetQueue
Bus BusB
Identifier targetQueue

To define a new foreign destination, use the administrative console to complete the following steps.

Procedure

  1. In the navigation pane, click Service integration > Buses.
  2. In the content pane, click the name of the bus on which the foreign destination is to be created.
  3. In the content pane, under Destination resources, click Destinations This displays any existing destinations in the content pane.
  4. To create a new destination, click New in the content pane.
    1. On the Create New Destination page, select Foreign Destination.
    2. Click Next.
    3. In the Identifier field, type the name of the target destination that exists in the foreign bus. The Identifier must match the name of the target destination that exists in the foreign bus.
    4. In the Bus field, type the name of the foreign bus that hosts the target destination. This must be the name of a foreign bus administrative object that is already defined on the bus on which the foreign destination is to be created.
  5. Optional: Specify the following properties for the destination. These will override the destination defaults.
    Description
    An optional description of the destination, for administrative purposes.
    Default reliability
    The reliability assigned to a message produced to this destination when an explicit reliability has not been set by the producer.
    Best effort nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

    For non-transactional JMS message-driven beans and MessageListeners that use a JMS destination configured on the default messaging provider, best-effort nonpersistent messages are not recoverable. In this case, if a message is unlocked because the message-driven bean or MessageListener threw an exception, then the message is not redelivered or sent to the exception destination because it was deleted from the message store when it was passed to the listener. If you require higher message reliability for non-transactional JMS message-driven beans and MessageListeners, configure a different option for the Maximum reliability property of the bus destination.

    Express nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable.
    Reliable nonpersistent
    Messages are discarded when a messaging engine stops or fails.
    Reliable persistent
    Messages may be discarded when a messaging engine fails.
    Assured persistent
    Messages are not discarded.
    Maximum reliability
    The maximum reliability of messages accepted by this destination.
    Best effort nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

    For non-transactional JMS message-driven beans and MessageListeners that use a JMS destination configured on the default messaging provider, best-effort nonpersistent messages are not recoverable. In this case, if a message is unlocked because the message-driven bean or MessageListener threw an exception, then the message is not redelivered or sent to the exception destination because it was deleted from the message store when it was passed to the listener. If you require higher message reliability for non-transactional JMS message-driven beans and MessageListeners, configure a different option for the Maximum reliability property of the bus destination.

    Express nonpersistent
    Messages are discarded when a messaging engine stops or fails. Messages may also be discarded if a connection used to send them becomes unavailable.
    Reliable nonpersistent
    Messages are discarded when a messaging engine stops or fails.
    Reliable persistent
    Messages may be discarded when a messaging engine fails.
    Assured persistent
    Messages are not discarded.
    Default priority
    The default priority for messages sent to the target destination, in the range 0 (lowest) through 9 (highest), or -1. The value -1 indicates that messages should use the default priority defined on the target destination. The default priority is used only if a message does not specify its own priority.
  6. Click Next.
  7. On the Confirm Destination Creation page, review the summary of actions.
    • To create the foreign destination , click Finish.
    • If you want to change any of the destination properties, click Previous, then change the properties on the preceding pages.
  8. Save your changes to the master configuration.

What to do next

Ensure that you have defined a foreign bus (to identify the target bus) and the target destination on that bus.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 7:21:45 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-dist&topic=tjo0007_
File name: tjo0007_.html