BatchTerminator 实用工具

使用 BatchTerminator 实用工具,您可以终止所有正在运行的用于批量处理 EDI 交换的批处理业务流程。 如果您正在运行大量批处理业务流程实例,并且需要终止所有这些批处理,以便对 BizTalk Server 系统执行维护,此时本实用工具将非常有用。

BatchTerminator 实用工具位于 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator 文件夹中。 运行实用工具以终止批处理业务流程实例时,该实用工具会将结果记录在 drive>:\Documents and Settings\user name>\<Application Data 文件夹中的 < batchterminator.log 文件中。

注意

只有 32 位系统才支持 BatchTerminator 实用工具。 BatchTerminator 使用 Microsoft.BizTalk.ExplorerOM 命名空间中的组件,该组件仅在从 32 位进程中使用时才受到支持。

重新启动终止的业务流程实例

终止一组批处理业务流程后,可以批量重新启动这些业务流程实例。 您需要使用 /Activate 开关和指示被停止批处理的文件的名称和路径执行此操作。 运行本实用工具终止一组业务流程实例时,它将创建此停止批处理文件。 stopped-batches 文件是 drive>:\Documents and Settings<\user name>\Application Data 文件夹中的 batchSettings-GUID<>.xml<。 同时会将停止批处理文件的路径和名称保存在日志文件中。 使用 /activate 开关运行本实用工具时,它将根据架构对输入文件进行验证。

语法

使用以下语法,在命令行窗口中运行 BatchTerminator 实用工具:

BatchTerminator /<switch>  

在运行 BatchTerminator 实用工具时,可以使用以下开关。 如果未提供任何开关,则使用 /terminate 选项。 如下所示,您可以输入开关的完整名称,例如 /terminate,也可以使用缩写形式,在本例中,可使用 /t。

Switch 函数
/? 显示帮助
/terminate -log:<log file>

或 /t -log:<log file>
向所有活动的 X12 或 EDIFACT 批处理业务流程实例发送终止控制消息。 该实用工具将显示操作的结果,包括它所终止的所有活动批处理业务流程实例的列表、它所找到的活动批处理业务流程数,以及它所发送的终止控制消息数。 它将结果记录到 drive>:\Documents and Settings\user name>\<Application Data 文件夹中的 < batchterminator.log 文件中。

可选的 -log: 参数可用于指定日志文件的名称和/或要将日志文件保存到的文件夹的路径。 下面是使用 参数指定路径和文件名的示例: BatchTerminator.exe /terminate -log:"C:\logs\log.txt"。 使用 参数仅指定文件名的示例如下: BatchTerminator.exe /terminate -log:log.txt。 如果指定的路径无效,则实用工具将使用默认路径: <drive>:\Documents and Settings\<user name>\Application Data。 -log: 参数可以与 /terminate 开关一起使用,也可以不带 /terminate 开关。
/print

或 /p
只显示当前活动批处理业务流程实例的列表,不发送终止控制消息
/activate:<path>\
batchSettings-GUID<>.xml -log:<log file>

或 /a:<path>\
batchSettings-GUID<>.xml -log:<log file>
重新激活 batchSettings-GUID<>.xml 文件中列出的以前终止的业务流程实例。 本实用工具将根据代码中嵌入的架构对输入文件进行验证。 如果输入的文件与架构不匹配,将在屏幕上显示错误消息,并退出程序。

如果在命令中包含 -log: 开关,则此操作会将有关重新启动操作的信息写入日志文件。

批处理激活文件的格式

若要使用 /activate 开关重新激活以前终止的批处理业务流程实例,必须提供批处理激活文件 (batchSettings-GUID<>.xml) 。 此文件必须采用以下格式:

<?xml version="1.0"?>  
<xs:schema xmlns:b="http://schemas.microsoft.com/BizTalk/2003" elementFormDefault="qualified" id="BatchInfo" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  <xs:element name="BatchTerminator">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element minOccurs="1" maxOccurs="unbounded" name="Batch">  
          <xs:complexType>  
            <xs:attribute name="PartyName" type="xs:string" />  
            <xs:attribute name="PartyID" type="xs:int" use="required" />  
            <xs:attribute name=”BatchName” type=”xs:string” />  
            <xs:attribute name=”BatchID” type=”xs:int” use=”required” />  
            <xs:attribute name="EdiMessageType" type="xs:string" use="required" />  
          </xs:complexType>  
        </xs:element>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
</xs:schema>  

必备条件

以下为执行本主题中步骤的前提条件:

  • 必须以 BizTalk Server Administrators 组成员的身份登录。

运行 BatchTerminator 实用工具

  1. 在 Windows 资源管理器中,移动到 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator 文件夹。

  2. 输入 BatchTerminator,包括任何所需的开关 ,然后单击 Enter

  3. 在 Windows 资源管理器中,移动到 <drive>:\Documents and Settings\<user name>\Application Data 文件夹,然后打开 batchterminator.log 文件以查看结果的日志。

另请参阅

SDK 中的实用工具