Share via


Move a Message

The ability to move messages between queues is a new feature in Message Queuing 4.0. You can move messages between different subqueues of the same main queue, or from a main queue to its subqueue. You cannot move messages from a main queue to a subqueue of a different main queue. For more information, see Administering Queues.

If the main queue is transactional, moving messages between subqueues or between the main queue and a subqueue can be performed as part of a transaction. If the main queue is nontransactional, moving messages between subqueues or between the main queue and a subqueue should not be performed as part of a transaction. In this scenario, messages might be lost if the transactions fail.

The format for the path of the target queue must be specified as follows.

Queue type Path format

Public queue

Host Name\Queue Name;Subqueue Name

For example:

ITComputer\Orders;RejectedOrders

Private queue

Host Name\private$\Queue Name;Subqueue Name

For example:

ITComputer\private$\Orders;RejectedOrders

Moving a message does not change any of its properties, except for the current move count.

Moving a message

To move a message

  1. Open Computer Management.

  2. In the console tree, click Queue messages or the subqueue that contains the message that you want to move.

    Where?

    • Computer Management/Services and Applications/Message Queuing/YourQueueFolder (such as Public Queues or Private Queues)/MainQueueName/Queue messages or SubqueueName
  3. In the details pane, right-click a message, point to All Tasks, and then click Move.

  4. For Target:, select a target queue on the local computer from the list, or type the path of a queue.

    - or -

    Perform a drag-and-drop operation on the message, moving it from the source queue to the target queue.

Additional considerations

  • To open Computer Management on Windows Vista®, click Start, right-click Computer, and then click Manage.

  • To open Computer Management on Windows Server® 2008, click Start, point to Programs, point to Administrative Tools, and then click Computer Management.

Additional references