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.
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.