共用方式為


BatchTerminator 公用程式

BatchTerminator 公用程式可讓您終止所有用來批次處理 EDI 交換的即時批次處理協調流程。 當您擁有大量正在執行的批次處理協調流程執行個體,而您需要終止所有的批次才可以針對 BizTalk 伺服器系統執行維護作業時,這個公用程式保證可發揮其功用。

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 檔案是磁片磁碟機> :\Documents and Settings\user name> \ < Application Data 資料夾中的 batchSettings-GUID <><.xml。 已遭停止批次之檔案的路徑和名稱,也會儲存在該 log 檔案內。 當此公用程式配合 /activate 參數執行時,它會就某個結構描述來驗證輸入檔案。

語法

在命令列視窗中,以下列語法來執行 BatchTerminator 公用程式:

BatchTerminator /<switch>  

您可以配合下列參數來執行 BatchTerminator 公用程式。 若未提供任何參數,則將使用 /terminate 選項。 正如以下所示,您可以輸入像是 /terminate 的完整參數名稱,或是縮短形式,以此例來說就是 /t。

交換器 函式
/? 顯示說明
/terminate -log: <log 檔案>

或 /t -log: <log 檔案>
將終止控制訊息傳送給所有作用中的 X12 或 EDIFACT 批次處理協調流程執行個體。 這個動作會顯示作業的結果,包括它所終止之所有作用中批次協調流程執行個體的清單,它所找到的作用中批次協調流程數目,以及它已傳送的終止控制訊息的數目。 它會將結果記錄到磁片磁碟機> :\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 參數使用。
/print

或 /p
顯示一份不傳送終止控制訊息之目前作用中批次處理協調流程執行個體的清單
/activate: <path> \
batchSettings-GUID <>.xml -log: <log 檔案>

或 /a: <path> \
batchSettings-GUID <>.xml -log: <log 檔案>
重新啟用先前終止的協調流程實例,這些實例列在 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 系統管理員」群組的成員身分登入。

若要執行 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 中的公用程式