Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Guide

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

  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.

    Property Name  



    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 is1. (Platform Edition limits this value to 2.) 

    To modify the value of this property or to specify other physical destination properties, use the MQ-install-dir/imq/bin/imqcmd command. See the Message Queue Administration Guide for more information.

  7. Click OK.

Equivalent asadmin command


System Destination

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

See Also