You can create a server management request to cancel messages in the server message store. You can create a one-time cancellation request or you can schedule your cancellation request to happen automatically. You can also optionally generate a report that details the messages that have been cancelled.
Messages can only be cancelled if they are on the server and in a non-final state when the request is activated.
|<request>||Groups information about a particular request. Specifying more than one <request> tag is equivalent to sending multiple separate server managment requests.|
|<condition>||Groups conditions for including a message to be cancelled. See Condition tag.|
|<persistent>||Specifies that the request should be made persistent in the server database (so that messages can be cancelled even if the server is restarted). Only used with schedules.|
|<requestId>||Specifies a unique identifier for the request that is included in each report generated as a result of this request. Using different values for this field allows more than one request to be active at the same time. Using the same request id allows the client to override or delete active requests.|
|<replyAddr>||The return address for each report generated as a result of this request. If this tag is omitted, the default return address of reports is the return address of the originating message.|
|<report>||Causes a report to be sent each time the request is activated. To cause a report to be sent each time the request is activated, put an empty <report> tag inside the <request> tag.|
|<schedule>||Specifies that the report should be generated on a schedule. See Scheduling server management requests.|
This request cancels messages on the server with the address ianywhere.connector.myConnector\deadqueue:
<?xml version="1.0" encoding="UTF-8"?> <actions> <CancelMessageRequest> <request> <requestId>cancelRequest</client> <condition> <customRule>ias_Address='ianywhere.connector.myConnector\deadqueue'</customRule> </condition> </request> </CancelMessageRequest> </actions>