|
MSMQ - Delete Queue |
<AMMSMQ ACTIVITY="delete" QUEUE="text" REMOTEMACHINE="text" /> |
Description:
Deletes the specified queue from the directory service (in the case of public queues) or from the local computer (in the case of private queues).
IMPORTANT: MSMQ activities are performed using the Microsoft Message Queuing engine, therefore, MSMQ must be installed on the computer that will run such operations. MSMQ software comes bundled with all Microsoft Windows operating systems from Windows 2000 up to, and including Windows 8, however, it is not installed by default. For more details regarding the installation of MSMQ, see MSMQ Installation & Overview. |
Deletes a message queue, usually after completing the desired MSMQ transactions.
Queue
Property |
Type |
Required |
Default |
Markup |
Description |
Local computer |
|
|
|
|
If enabled, specifies that this activity will be performed on the local computer (enabled by default). This is a visual mode parameter used only during design time, therefore, contains no markup. |
Another computer |
Text |
No |
(Empty) |
|
If enabled, specifies the host name or IP address of the remote computer that this activity will be performed on. When this parameter is enabled, the Local computer parameter is ignored. |
Queue path |
Text |
Yes |
(Empty) |
QUEUENAME="CompName\QueueName" |
The name of the message queue to delete. The message queue name consists of the compute name, an optional PRIVATE$ keyword that indicates whether it is a private queue and the name of the queue. Public queue example: ComputerName\QueueName Private queue example: ComputerName\PRIVATE$\QueueName |
NOTE: The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder. |
Description: This sample code delete's the queue "VMWINVX64\private$\myQueue" located on the local machine".
<AMMSMQ ACTION="delete" QUEUENAME="VMWINVX64\private$\myQueue" />
|