Use this task to create a new foreign destination on a service
integration bus. A foreign destination provides a mapping to a destination
of the same name on a different bus, and enables applications on one bus
to access directly the destination on another bus. You can set its own destination
properties which will override the destination defaults.

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:
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.
- In the navigation pane, click
- In the content pane, click the name of the bus on which the foreign
destination is to be created.
- In the content pane, under Additional Properties, click Destinations This displays any existing destinations in the content pane.
- To create a new destination, click New in
the content pane.
- On the Create New Destination page, select Foreign Destination.
- Click Next.
- 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.
- 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.
- 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
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
- Reliable nonpersistent
- Reliable persistent
- Assured persistent
- Maximum reliability
- The maximum reliability of messages accepted by this destination.
- Best effort nonpersistent
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
- Reliable nonpersistent
- Reliable persistent
- Assured persistent
- 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.
- Click Next.
- 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.
- Save your changes to the master configuration.
Ensure that you have defined a foreign bus (to identify the target
bus) and the target destination on that bus.