## Add Broker Destination

Use this dialog to create and configure a physical destination on a broker. The destination on the broker is a location in the broker's physical memory where incoming messages are marshalled before being routed to message consumers.

Message Queue messaging is implemented as a two-phase delivery of messages: first the message is delivered from a producer to a destination on the broker; second, the message is delivered from the destination on the broker to one or more consumers.

A broker can be configured to dynamically create physical destinations if you have not created them. These autocreated destinations are automatically destroyed by the broker when they are no longer needed.

To configure a physical destination, set the following attribute values:

Destination Name Specifies the name of the physical destination.

Destination Type Specifies the destination type (queue or topic). Click the Queue or Topic radio button.

Max Number of Messages Specifies the maximum number of unconsumed messages allowed in this destination.

Max Total Message Bytes Specifies the maximum total amount of memory allowed for unconsumed messages in this destination. Use the drop down list to select the unit of measurement: bytes, kbytes, or megabytes.

Max Bytes per Message Specifies the maximum size of any single message allowed in this destination. Use the drop down list to select the unit of measurement: bytes, kbytes, or megabytes.

Max Number of Producers Specifies the maximum number of producers allowed for this destination.

Max Number of Active Consumers Applies to queue destinations only. Specifies the maximum number of consumers that can be active in load-balanced delivery from this destination.

Max Number of Backup Consumers Applies to queue destinations only. Specifies the maximum number of backup consumers that can take the place of active consumers, should any active consumers fail during load-balanced delivery from this destination.

To get information about a destination's current state or to change the properties of a destination.

1. Select the destination in the console's results pane.
2. Choose Actions > Properties.

To purge messages from a destination:

1. Select the destination in the console's results pane.
2. Choose Actions > Purge Messages.

To delete a destination:

1. Select the destination in the console's results pane.
2. Choose Edit > Delete.

To pause a destination:

1. Select the destination in the console's results pane.
2. Choose Actions > Pause Producers | Pause Consumers | Pause All.

To resume a paused destination:

1. Select the destination in the console's results pane.
2. Choose Actions > Resume