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

- Previous: Admin Console Tasks for JMS Destination Resources
- Next: Admin Console Tasks for the JMS Provider

# Admin Console Tasks for JMS Physical Destinations

- To create a JMS physical destination

- To delete a JMS physical destination

## To 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 | 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 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

`create-jmsdest`

##### 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

- JMS Resources

- To delete a JMS physical destination

## To delete a JMS physical destination

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, select the checkbox next to the name of the destination to be deleted.

4. Click Delete.

   If you try to delete the system destination `mq.sys.dmq`, an error message appears.

##### Equivalent asadmin command

`delete-jmsdest`

##### See Also

- JMS Resources

- To create a JMS physical destination

- Previous: Admin Console Tasks for JMS Destination Resources
- Next: Admin Console Tasks for the JMS Provider

- © 2010, Oracle Corporation and/or its affiliates