Hilfsprogramm zur Batchbeendigung
Mit dem Hilfsprogramm zur Batchbeendigung können Sie alle aktiven Batchverarbeitungsorchestrierungen beenden, die für die Batchverarbeitung von EDI-Austauschvorgängen verwendet werden. Dieses Hilfsprogramm kann sich als sehr nützlich erweisen, wenn viele Batchverarbeitungsorchestrierungen ausgeführt werden und Sie alle Batches beenden müssen, um Wartungsarbeiten am BizTalk Server-System durchzuführen.
Das BatchTerminator-Hilfsprogramm befindet sich im Ordner \Programme (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator. Wenn Sie das Hilfsprogramm ausführen, um die Batchverarbeitungsorchestrierungsinstanzen zu beenden, protokolliert das Hilfsprogramm die Ergebnisse in der Datei batchterminator.log im < Ordner laufwerk>:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten.
Hinweis
Das Hilfsprogramm zur Batchbeendigung wird nur auf 32-Bit-Systemen unterstützt. Das Hilfsprogramm zur Batchbeendigung nutzt Komponenten im Namespace „Microsoft.BizTalk.ExplorerOM“; dies wird nur bei Verwendung innerhalb eines 32-Bit-Prozesses unterstützt.
Neustarten der beendeten Orchestrierungsinstanzen
Nach der Beendigung einer Gruppe von Batchverarbeitungsorchestrierungen können Sie einen Massenneustart dieser Orchestrierungsinstanzen durchführen. Dazu verwenden Sie den Schalter /activate sowie den Namen und Pfad einer Datei, die die beendeten Batches angibt. Wenn Sie das Hilfsprogramm ausführen, um eine Gruppe von Orchestrierungsinstanzen zu beenden, wird diese Datei mit beendeten Batches erstellt. Die Datei "stopped-batches" lautet batchSettings-GUID<>.xml im < Ordner laufwerk>:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten. Pfad und Name der Datei mit beendeten Batches werden auch in der Protokolldatei gespeichert. Wird das Hilfsprogramm mit dem Schalter /activate ausgeführt, prüft es die Eingabedatei anhand eines Schemas.
Syntax
Führen Sie das Hilfsprogramm zur Batchbeendigung in einem Befehlszeilenfenster mit folgender Syntax aus:
BatchTerminator /<switch>
Sie können das Hilfsprogramm zur Batchbeendigung mit den folgenden Schaltern ausführen. Wenn Sie keinen Schalter angeben, wird die Option /terminate verwendet. Wie unten angegeben, können Sie den vollständigen Namen des Schalters (z. B. /terminate) oder die abgekürzte Form angeben (z. B. /t).
| Schalter | Funktion |
|---|---|
| /? | Zeigt Hilfe an |
| /terminate -log:<log file> oder /t -log:<protokolldatei> |
Sendet Kontrollnachrichten zur Beendigung an alle aktiven Instanzen von X12- oder EDIFACT-Batchverarbeitungsorchestrierungen. Die Ergebnisse des Vorgangs werden angezeigt, einschließlich einer Liste aller aktiven Instanzen von Batchverarbeitungsorchestrierungen, die beendet wurden, der Anzahl gefundener aktiver Instanzen von Batchverarbeitungsorchestrierungen und der Anzahl gesendeter Kontrollnachrichten zur Beendigung. Die Ergebnisse werden in der Datei batchterminator.log im < Ordner laufwerk>:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten protokolliert. Mit dem optionalen Parameter -log: können Sie den Namen der Protokolldatei und/oder den Pfad des Ordners angeben, in dem die Protokolldatei gespeichert werden soll. Ein Beispiel für die Verwendung des Parameters zum Angeben des Pfads und des Dateinamens ist folgendes: BatchTerminator.exe /terminate -log:"C:\logs\log.txt". Ein Beispiel für die Verwendung des Parameters, um nur den Dateinamen anzugeben, ist folgendes: BatchTerminator.exe /terminate -log:log.txt. Wenn der angegebene Pfad ungültig ist, verwendet das Hilfsprogramm den Standardpfad laufwerk><:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten. Der Parameter -log: kann mit oder ohne den Schalter /terminate verwendet werden. |
| /print oder /p |
Zeigt eine Liste der aktuell aktiven Instanzen von Batchverarbeitungsorchestrierungen an, ohne Kontrollnachrichten zur Beendigung zu senden |
| /activate:<path>\ batchSettings-GUID<>.xml -log:<protokolldatei> oder /a:<path>\ batchSettings-GUID<>.xml -log:<protokolldatei> |
Reaktiviert die zuvor beendeten Orchestrierungsinstanzen, die in der datei batchSettings-GUID<>.xml aufgeführt sind. Das Hilfsprogramm prüft die Eingabedatei anhand eines im Code eingebetteten Schemas. Stimmt die Eingabedatei nicht mit dem Schema überein, wird eine Fehlermeldung angezeigt, und das Programm wird beendet. Wenn Sie den Schalter -log: angeben, werden bei diesem Vorgang Informationen über den Neustartvorgang in die Protokolldatei geschrieben. |
Format der Batchaktivierungsdatei
Um zuvor beendete Batchorchestrierungsinstanzen mithilfe des Schalters /activate erneut zu aktivieren, müssen Sie eine Batchaktivierungsdatei (batchSettings-GUID<>.xml) bereitstellen. Diese Datei muss in folgendem Format vorliegen:
<?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>
Voraussetzungen
Zur Durchführung der Verfahren in diesem Thema müssen die folgenden Voraussetzungen erfüllt sein:
- Sie müssen als ein Benutzer angemeldet sein, der zur BizTalk Server-Administratorengruppe gehört.
So führen Sie das BatchTerminator-Hilfsprogramm aus
Wechseln Sie in Windows Explorer zum Ordner \Programme (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator.
Geben Sie BatchTerminator ein, einschließlich aller gewünschten Schalter, und klicken Sie dann auf DIE EINGABETASTE.
Wechseln Sie in Windows Explorer zum < Ordner laufwerk>:\Dokumente und Einstellungen\<Benutzername>\Anwendungsdaten, und öffnen Sie die Datei batchterminator.log, um ein Ergebnisprotokoll anzuzeigen.