Creating and Modifying Destinations

Destinations are typically "static" administered objects that can be stored in a JNDI or LDAP server. Administered objects can also be stored in the EMS server and looked up using the EMS implementation of JNDI.

This section describes how to use the EMS Administration Tool to create and modify destination objects in EMS. For more information, see EMS Administration Tool.

You create a queue using the create queue command and a topic using the create topic command. For example, to create a new queue named myQueue, enter:

   create queue myQueue 

To create a topic named myTopic, enter:

   create topic myTopic

The queue and topic data stored on the EMS server is located in the queues.conf and topics.conf files, respectively. You can use the show queues and show topics commands to list all of the queues and topics on your EMS server and the show queue and show topic commands to show the configuration details of specific queues and topics.

A queue or topic may include optional properties that define the specific characteristics of the destination. These properties are described in Destination Properties and they can be specified when creating the queue or topic or modified for an existing queue or topic using the addprop queue, addprop topic, setprop queue, setprop topic, removeprop queue, and removeprop topic commands.

For example, to discard messages on myQueue when the number of queued messages exceeds 1000, you can set an overflowPolicy by entering:

   addprop queue myQueue maxmsgs=1000,overflowPolicy=discardOld

To change the overflowPolicy from discardOld to rejectIncoming, enter:

   addprop queue myQueue overflowPolicy=rejectIncoming

The setprop queue and setprop topic commands remove properties that are not explicitly set by the command. For example, to change maxmsgs to 100 and to remove the overflowPolicy parameter, enter:

   setprop queue myQueue maxmsgs=100