Utilitaire BatchTerminator
L'utilitaire BatchTerminator permet d'arrêter toutes les orchestrations de traitement par lot actives utilisées pour le traitement par lot des échanges EDI. Cet outil peut s'avérer utile si un grand nombre d'instances d'orchestration de traitement par lot est en cours d'exécution et vous devez arrêter tous les traitements par lot afin de procéder à la maintenance du système BizTalk Server.
L’utilitaire BatchTerminator se trouve dans le dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator. Lorsque vous exécutez l’utilitaire pour arrêter les instances d’orchestration de traitement par lot, l’utilitaire enregistre les résultats dans le fichier batchterminator.log dans le < dossier drive> :\Documents and Settings\<user name>\Application Data.
Notes
L'utilitaire BatchTerminator est seulement pris en charge sur les systèmes 32 bits. Il utilise les composants dans l'espace de noms Microsoft.BizTalk.ExplorerOM (uniquement pris en charge s'il est utilisé à partir d'un processus 32 bits).
Redémarrage des instances d'orchestration arrêtées
Après l'arrêt d'un groupe d'orchestrations de traitement par lot, vous pouvez effectuer un redémarrage en bloc de ces instances. Pour ce faire, utilisez le commutateur /activate et indiquez les noms et chemin d'accès du fichier répertoriant les lots arrêtés. Ce fichier est créé lorsque vous exécutez l'utilitaire pour arrêter un groupe d'instances d'orchestration. Le fichier stopped-batches est batchSettings-GUID<>.xml dans le < dossier drive> :\Documents and Settings\<user name>\Application Data. Les chemin d'accès et nom du fichier répertoriant les lots arrêtés sont également enregistrés dans le fichier journal. Lorsque l'utilitaire est exécuté avec le commutateur /activate, il valide le fichier d'entrée par rapport à un schéma.
Syntaxe
Exécutez l'utilitaire BatchTerminator dans une fenêtre de ligne de commande à l'aide de la syntaxe suivante :
BatchTerminator /<switch>
Vous pouvez exécuter l'utilitaire BatchTerminator avec les commutateurs suivants. Si aucun commutateur n'est indiqué, l'option /terminate est utilisée. Comme mentionné ci-après, vous pouvez entrer le nom complet du commutateur (par exemple, /terminate) ou sa forme abrégée (dans ce cas, /t).
| Commutateur | Fonction |
|---|---|
| /? | Affiche l'aide |
| /terminate -log :<log file> ou /t -log :<log file> |
Envoie des messages de contrôle d'arrêt pour toutes les instances d'orchestration de traitement par lot X12 ou EDIFACT actives. Affiche les résultats de l'opération (liste des instances d'orchestration de traitement par lot actives arrêtées, nombre d'orchestrations de traitement par lot actives détectées et nombre de messages de contrôle d'arrêt envoyés). Il journalise les résultats dans le fichier batchterminator.log dans le < dossier drive> :\Documents and Settings\<user name>\Application Data. Le paramètre -log: (facultatif) permet de spécifier le nom du fichier journal et/ou le chemin d'accès au dossier dans lequel enregistrer le fichier journal. Voici un exemple d’utilisation du paramètre pour spécifier le chemin d’accès et le nom de fichier : BatchTerminator.exe /terminate -log:"C:\logs\log.txt". Voici un exemple d’utilisation du paramètre pour spécifier uniquement le nom de fichier : BatchTerminator.exe /terminate -log:log.txt. Si le chemin spécifié n’est pas valide, l’utilitaire utilise le chemin par défaut : <lecteur> :\Documents and Settings\<user name>\Application Data. Le paramètre -log: peut être utilisé avec ou sans le commutateur /terminate. |
| /print ou /p |
Affiche la liste des instances d'orchestration de traitement par lot actives sans envoyer de messages de contrôle d'arrêt |
| /activate :<path>\ batchSettings-GUID<>.xml -log :<log file> ou /a :<path>\ batchSettings-GUID<>.xml -log :<log file> |
Réactive les instances d’orchestration précédemment terminées qui sont répertoriées dans le fichier de.xml batchSettings-GUID<>. L'utilitaire valide le fichier d'entrée par rapport à un schéma incorporé dans le code. Si le fichier d'entrée ne correspond pas au schéma, un message d'erreur est affiché à l'écran et le programme est fermé. Si vous incluez le commutateur -log:, cette opération consigne des informations relatives à l'action de redémarrage dans le fichier journal. |
Format du fichier d'activation d'un lot
Pour réactiver des instances d’orchestration par lots précédemment terminées à l’aide du commutateur /activate, vous devez fournir un fichier d’activation par lots (batchSettings-GUID<>.xml). au format suivant :
<?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>
Prérequis
La configuration suivante est requise pour exécuter les procédures décrites dans cette rubrique :
- Vous devez ouvrir une session en tant que membre du groupe Administrateurs BizTalk Server.
Pour exécuter l'utilitaire BatchTerminator
Dans Windows Explorer, accédez au dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator.
Entrez BatchTerminator, y compris les commutateurs souhaités, puis cliquez sur Entrée.
Dans Windows Explorer, accédez au < dossier drive> :\Documents and Settings\<user name>\Application Data, puis ouvrez le fichier batchterminator.log pour afficher un journal des résultats.