MSMQ - Delete Queue
Declaration
<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 must be installed on the (local or
remote) computer in order for these activities to function properly.
MSMQ is bundled with most Microsoft Windows operating systems, however, it is not installed by default.
For more details regarding the installation of MSMQ, see MSMQ
Installation & Overview.
Practical usage
Deletes a message queue, usually after completing the desired MSMQ transactions.
Parameters
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). NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes. |
Another computer | Text | No | (Empty) |
|
If enabled, specifies the hostname 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.
|
Example
NOTE:
- Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
- To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.
Description
This sample code deletes the queue "VMWINVX64\private$\myQueue" located on the local machine."
Copy
<AMMSMQ ACTION="delete" QUEUENAME="VMWINVX64\private$\myQueue" />