Configure bus destinations
Use the following tasks to configure permanent bus destinations on service integration buses.
The steps involved in configuring a bus destination depend on the intended usage of the destination.
For example, the following figure shows a basic scenario based on an application using a JMS queue for point-to-point messaging. A producing application sends messages to a JMS queue from which a consuming application retrieves the messages. The JMS queue is assigned to a queue destination and its associated queue point, where messages are stored.
Figure 1. Application use of destinations - basic case
To enable the JMS applications to use a queue destination, you configure the following administrative destination objects:
- A queue destination on a service integration bus. This configures the properties of the queue, such as the name, and associates the queue with one bus member (an application server or server cluster). This also automatically configures, on the bus member, a queue point where messages for the queue are held and processed.
- A JMS queue, which configures the name that applications can use to look up the queue in JNDI. The JMS queue encapsulates the name of the queue destination, as defined in the queue destination above, together with other properties to be used by applications.
After we have created a queue destination, we can optionally configure the queue point to override some properties configured on the queue destination. We can also undertake other configuration tasks on the destination and its queue point, and can act on the runtime view.
Each messaging engine has a default exception destination, named _SYSTEM.Exception.Destinaton.messaging_engine_name. This exception destination can be used to handle messages that cannot be delivered for all bus destinations that are localized to the messaging engine. Each bus destination can be configured with a non-default exception destination.
Subtopics
- Listing bus destinations
Use this task to display administrative lists of bus destinations for a service integration bus.
- Create a bus destination
Use the following tasks to create a new bus destination on a service integration bus.
- Configure bus destination properties
We can view or change the configuration properties of a bus destination, that is, a queue, topic space, alias destination, or foreign destination.
- Configure mediations
Use this task to configure one or more mediations for a selected bus destination in a service integration bus.
- Configure a destination forward routing path
Use this task to configure a forward routing path for a selected bus queue. The forward routing path identifies a sequence of bus destinations that a message should pass through after it has been delivered to the bus destination to which the producer is attached.
- Configure a destination reverse routing path
Use this task to configure a reverse routing path between two bus destinations. The reverse routing path identifies the list of destinations to which a reply message should be sent when the consumer of a request message sends a reply message back to the producer of the reply message.
- Configure context properties for a bus destination
Use this task to configure context properties for a bus destination.
- Administer destination roles
Service integration bus security uses role-based authorization. When messaging security is enabled, users and groups must have authority to undertake messaging operations, at a bus destination. By administering destination roles, we can control which users and groups can undertake operations at a bus destination, and the types of operations that they can perform.
- Delete a bus destination
Use these tasks to delete a bus destination from a service integration bus.
- Reset a destination
Use this task to reset a bus destination.
Subtopics
- Listing bus destinations
Use this task to display administrative lists of bus destinations for a service integration bus.
- Create a bus destination
Use the following tasks to create a new bus destination on a service integration bus.
- Configure bus destination properties
We can view or change the configuration properties of a bus destination, that is, a queue, topic space, alias destination, or foreign destination.
- Configure mediations
Use this task to configure one or more mediations for a selected bus destination in a service integration bus.
- Configure a destination forward routing path
Use this task to configure a forward routing path for a selected bus queue. The forward routing path identifies a sequence of bus destinations that a message should pass through after it has been delivered to the bus destination to which the producer is attached.
- Configure a destination reverse routing path
Use this task to configure a reverse routing path between two bus destinations. The reverse routing path identifies the list of destinations to which a reply message should be sent when the consumer of a request message sends a reply message back to the producer of the reply message.
- Configure context properties for a bus destination
Use this task to configure context properties for a bus destination.
- Administer destination roles
Service integration bus security uses role-based authorization. When messaging security is enabled, users and groups must have authority to undertake messaging operations, at a bus destination. By administering destination roles, we can control which users and groups can undertake operations at a bus destination, and the types of operations that they can perform.
- Delete a bus destination
Use these tasks to delete a bus destination from a service integration bus.
- Reset a destination
Use this task to reset a bus destination.
Related concepts
Bus destinations
Related tasks
Configure message points Administer destination roles Administer topic space root roles Administer topic roles
Related information:
Destinations [Collection]