Update a Message Queue

You can change the queue name, message type, and/or queue description using the following command:

swadm update_queue queue_id | queue_name new_name message_type queue_description

where:

•

queue_id is the unique identifier for the queue. You can find a queue’s identifier using the show_queues command.

•

queue_name is the descriptive alphanumeric name for the queue.

•

new_name is the new name to be used for this queue. If you want to leave the existing name unchanged, use a hyphen ‘-’.

•

message_type is used to identify the message type. This value must be either Local (for local messages), or a hyphen ‘-’ (to leave the value unchanged).

•

queue_description specifies the physical database table that holds the queue. If you want to leave the existing name unchanged, use a hyphen ‘-’.

See the description of this parameter under the add_queue command for a full description of the syntax and requirements for this parameter.

Examples

1.

This example (for Windows/SQL Server) points the queue BGMBOX3 to use a different physical queue, sw_db_bgqueue5 owned by swpro (in the current database used by iProcess Engine). The queue’s current name and message type are left unchanged.

swadm update_queue BGMBOX3 - - 0003:swpro.sw_db_bgqueue5

2.

This example renames the queue BGMBOX3 to BGMBOX5. The queue will continue to use its existing message type and physical queue.

swadm update_queue BGMBOX3 BGMBOX5 - -