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 实用工具
在 Windows 资源管理器中,移动到 \Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator 文件夹。
输入 BatchTerminator,包括任何所需的开关 ,然后单击 Enter。
在 Windows 资源管理器中,移动到 <drive>:\Documents and Settings\<user name>\Application Data 文件夹,然后打开 batchterminator.log 文件以查看结果的日志。