Utilità BatchTerminator
L'utilità BatchTerminator consente d terminare tutte le orchestrazioni batch attivate utilizzate per l'invio in batch di interscambi EDI. Questa utilità può rivelarsi utile se è in esecuzione un numero elevato di istanze di orchestrazione batch ed è necessario terminare tutti i batch per eseguire la manutenzione del sistema BizTalk Server.
L'utilità BatchTerminator si trova nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator. Quando si esegue l'utilità per terminare le istanze di orchestrazione in batch, l'utilità registra i risultati nel file batchterminator.log nella < cartella drive>:\Documents and Settings\<user name>\Application Data.
Nota
L'utilità BatchTerminator è supportata solo su sistemi a 32 bit. BatchTerminator utilizza componenti dello spazio dei nomi Microsoft.BizTalk.ExplorerOM che è supportato solo se utilizzato da un processo a 32 bit.
Riavvio delle istanze di orchestrazione terminate
Dopo aver terminato un gruppo di orchestrazioni batch, è possibile eseguire un riavvio in blocco di tali istanze di orchestrazione. A tale scopo, utilizzare l'opzione /Activate e il nome e il percorso di un file in cui sono indicati i batch arrestati. Quando si esegue l'utilità per terminare un gruppo di istanze di orchestrazione, il file dei batch arrestati viene creato automaticamente dall'utilità. Il file batch arrestato è batchSettings-GUID<>.xml nella < cartella drive>:\Documents and Settings\<user name>\Application Data. Il percorso e il nome del file dei batch interrotti viene salvato anche nel file di log. Quando l'utilità viene eseguita con l'opzione /activate, convalida il file di input rispetto a uno schema.
Sintassi
Eseguire l'utilità BatchTerminator in una finestra della riga di comando con la sintassi seguente:
BatchTerminator /<switch>
È possibile eseguire l'utilità BatchTerminator con le seguenti opzioni. Se non si specifica un'opzione, viene utilizzata l'opzione /terminate. Come indicato di seguito, è possibile immettere il nome completo dell'opzione, ad esempio /terminate, oppure il formato abbreviato, in questo caso /t.
| Commutatore | Funzione |
|---|---|
| /? | Visualizza la Guida. |
| /terminate -log:<log file> o /t -log:<log file> |
Invia i messaggi di controllo della terminazione per tutte le istanze di orchestrazione batch X12 o EDIFACT. Visualizza i risultati dell'operazione, incluso un elenco di tutte le istanze di orchestrazione batch attivate che sono state terminate, il numero delle orchestrazioni batch attivate trovate e il numero di messaggi di controllo inviati. Registra i risultati nel file batchterminator.log nella < cartella drive>:\Documents and Settings\<nome> utente\Application Data. Il parametro -log facoltativo consente di specificare il nome del file di log e/o il percorso della cartella in cui si vuole salvare il file di log. Un esempio di uso del parametro per specificare il percorso e il nome del file è il seguente: BatchTerminator.exe /terminate -log:"C:\logs\log.txt". Un esempio di uso del parametro per specificare il nome del file è solo il seguente: BatchTerminator.exe /terminate -log:log.txt. Se il percorso specificato non è valido, l'utilità userà il percorso predefinito: <unità>:\Documenti e Impostazioni\<nome> utente\Dati applicazione. Il parametro -log: può essere usato con o senza l'opzione /terminate. |
| /print o /p |
Visualizza un elenco delle istanze di orchestrazione batch attivate senza inviare messaggi di controllo della terminazione. |
| /activate:<path>\ batchSettings-GUID<>.xml -log:<log file> o /a:<path>\ batchSettings-GUID<>.xml -log:<log file> |
Riattiva le istanze di orchestrazione precedentemente terminate elencate nel file di.xml batchSettings-GUID<>. Il file di input verrà convalidato automaticamente rispetto a uno schema incorporato nel codice. Se il file di input non corrisponde allo schema, verrà visualizzato un messaggio di errore e il programma verrà chiuso. Questa operazione scrive informazioni sull'azione di riavvio nel file di log se si include l'opzione -log: |
Formato del file di attivazione batch
Per riattivare le istanze di orchestrazione batch terminate in precedenza usando l'opzione /activate, è necessario specificare un file di attivazione batch (batchSettings-GUID<>.xml). Questo file deve essere nel formato seguente:
<?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>
Prerequisiti
Di seguito sono riportati i prerequisiti per l'esecuzione delle procedure illustrate in questo argomento:
- È necessario eseguire l'accesso come membro del gruppo Amministratori BizTalk Server.
Per eseguire l'utilità BatchTerminator
In Esplora risorse passare alla cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator.
Immettere BatchTerminator, incluse le opzioni desiderate e quindi fare clic su Invio.
In Esplora risorse passare a <drive>:\Documents and Settings\<user name>\Application Data folder e aprire il file batchterminator.log per visualizzare un log dei risultati.