Creating a JMS Physical Destination

For production purposes, always create physical destinations. During the development and testing phase, however, this step is not required. The first time an application accesses a destination resource, Message Queue automatically creates the physical destination specified by the Name property of the destination resource. The physical destination is temporary and expires after a period specified by a Message Queue configuration property.

To create a JMS physical destination, follow these steps:

  1. In the tree component, expand the Configuration node, then expand the Java Message Service node.
  2. Select the Physical Destinations node.
  3. On the Physical Destinations page, click New. The Create Physical Destination page appears.
  4. In the Physical Destination Name field, type the name of the destination (for example, PhysicalQueue).
  5. From the Type drop-down list, choose either topic or queue.
  6. In the Additional Properties area, click Add Property to add a property. The following table lists the one property currently available.

    Table 0-27  Additional Property for JMS Physical Destinations

    Property Name

    Description

    maxNumActiveConsumers

    The maximum number of consumers that can be active in load-balanced delivery from a queue destination. A value of -1 means an unlimited number. The default is 1. (Platform Edition limits this value to 2.)

  7. To modify the value of this property or to specify other physical destination properties, use the install_dir/imq/bin/imqcmd command. See the Sun Java System Message Queue 3 2005Q1 Administration Guide for more information.

  8. Click OK.

The Physical Destinations page shows the system destination, a queue named mq.sys.dmq, to which expired and undeliverable messages are redirected. It is possible to create destination resources, consumers, and browsers for this destination. It is not possible to delete it or to send messages to it.

Equivalent asadmin command: create-jmsdest

See Also:


Legal Notices