Sun GlassFish Message Queue 4.4 Administration Guide

Creating a Physical Destination

By default, message brokers are configured to create new physical destinations automatically whenever a message producer or consumer attempts to access a nonexistent destination. Such auto-created destinations are convenient to use while testing client code in a software development environment. In a production setting, however, it is advisable to disable the automatic creation of destinations and instead require all destinations to be created explicitly by an administrator. The following procedure shows how to add such an admin-created destination to a broker.

ProcedureTo Add a Physical Destination to a Broker

  1. Click on the Destinations item under the broker’s name in the Administration Console window’s navigation pane and choose Add Broker Destination from the Actions menu.

    Alternatively, you can right-click on Destinations and choose Add Broker Destination from the pop-up context menu. In either case, the Add Broker Destination dialog box (Figure 2–8) will appear.

    Figure 2–8 Add Broker Destination Dialog Box

    Add Broker Destination Dialog. Buttons from left to right:
OK, Reset To Defaults, Cancel, Help.

  2. Enter a name for the physical destination in the Destination Name field.

    Note the name that you assign to the destination; you will need it later when you create an administered object corresponding to this physical destination.

    For this exercise, type in the name MyQueueDest.

  3. Select the Queue or Topic radio button to specify the type of destination to create.

    For this exercise, select Queue if it is not already selected.

  4. Click OK to add the physical destination and dismiss the dialog box.

    The new destination will appear in the result pane.