BatchTerminator ユーティリティ
BatchTerminator ユーティリティを使用すると、EDI インターチェンジのバッチ処理に使用されているアクティブなバッチ処理オーケストレーションをすべて終了できます。 このユーティリティは、多数のバッチ処理オーケストレーション インスタンスを実行していて、BizTalk Server システムの保守を行うためにすべてのバッチを終了する必要があるときに便利です。
BatchTerminator ユーティリティは、\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\MicrosoftEDI\BatchTerminator フォルダーにあります。 ユーティリティを実行してバッチ処理オーケストレーション インスタンスを終了すると、ユーティリティは結果を batchterminator.log ファイルの drive>:\Documents and Settings\user name>\<Application Data フォルダーに<記録します。
Note
BatchTerminator ユーティリティは、32 ビット システムでのみサポートされます。 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 ファイル> または /t -log:<log ファイル> |
すべてのアクティブな 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 と 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 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 ファイルを開いて結果のログを表示します。