Editing Queues
Editing queues using the Enterprise Manager enables you to change specific attributes of a queue, such as its name, event time-to-live (TTL), capacity, or the realm on which the queue exists.
When you edit a queue, its attributes and any events found on the queue are copied to a temporary queue. The old queue is then deleted, the new queue is created, and the original events are copied from the temporary queue to the new queue.
Since editing a queue involves deleting the old queue, certain activities and objects associated with the old queue are also terminated and should be recreated. For more information about deleting queues, see
Deleting Channels and Queues.
As far as possible, queue events are held in memory for performance reasons. The temporary queue is also held in memory, and requires the same amount of memory as the queue being edited. The realm server must be able to allocate sufficient memory to store the temporary copy, otherwise the queue edit operation will be terminated and an error will be logged. If such a situation occurs, you can resolve it by allocating additional heap size, so that the temporary copy can exist in memory at the same time as the queue being edited.
To edit a queue in the Enterprise Manager
1. Expand the Realms node, and then expand the realm on which you want to edit the queue.
2. Select the queue and right-click it.
3. From the drop-down menu, select Edit queue queue_name.
4. Modify the queue attributes as required.
To move the queue to another available realm, in the Parent Realm field, select a realm from the list.
For information about updating the Protobuf descriptor uploaded on the queue, see
Updating the Protobuf Descriptor.
5. (Optional) Edit the storage properties associated with the queue as required.
6. Click OK.