取消消息

可以创建取消服务器消息存储库中的消息的服务器管理请求。可以创建一次性取消请求，也可以将取消请求安排为自动发生。还可以选择生成一个报告，其中详细记录已被取消的消息。

只有在激活请求时消息处于非最终状态且尚未传送给接收者的情况下，才能取消消息。

<CancelMessageRequest> 子标记	说明
<request>	有关特定请求的分组信息。指定多个 <request> 标记等效于分别发送多个服务器管理请求。

<Request> 子标记	说明
<condition>	包括要取消的消息的分组条件。请参见Condition 标记。
<persistent>	指定请求应在服务器数据库中持久保留（这样即使服务器重新启动也可取消消息）。仅与调度一同使用。
<requestId>	为包括在作为该请求的结果而生成的每个报告中的请求指定唯一标识符。对此字段使用不同值可以使多个请求同时处于活动状态。使用同一请求 ID 可以使客户端覆盖或删除活动请求。
<replyAddr>	作为该请求的结果而生成的每个报告的返回地址。如果省略此标记，则报告的缺省返回地址为源消息的返回地址。
<report>	使得每次激活请求时都发送报告。要在每次激活请求时都发送报告，请在 <request> 标记内放置空 <report> 标记。
<schedule>	指定应按调度生成报告。请参见服务器管理请求父标记。

示例

此请求取消服务器上地址为 ianywhere.connector.myConnector\deadqueue 的消息：

<?xml version="1.0" encoding="UTF-8"?>
<actions>
 <CancelMessageRequest>
  <request>
   <requestId>cancelRequest</requestId>
   <condition>
    <customRule>ias_Address='ianywhere.connector.myConnector\deadqueue'</customRule>
   </condition>
  </request>
 </CancelMessageRequest>
</actions>