VBScriptを「終わらせる」技術：WScript.Quitが教えるプロセス間連携の極意
業務自動化の現場において、VBScriptは今なお「枯れた技術」として最強のカードであり続けている。しかし、多くのエンジニアが犯す致命的なミスがある。それは、「スクリプトをただ動かして終わり」にしていることだ。
真の自動化エンジニアは、スクリプトの「終了」こそを設計の最優先事項とする。親プロセス（バッチファイルやタスクスケジューラ）に対し、沈黙で「成功」を伝え、エラーコードで「異常」を叫ぶ。この対話こそが、堅牢なシステムを構築する唯一の道だ。
今日は、`WScript.Quit`を単なる「終了コマンド」から「プロセス間通信の要」へと昇華させるための極限の知見を授ける。
—
1. なぜ「終了コード」が業務自動化の生命線なのか
タスクスケジューラやバッチファイルは、VBScriptが中で何を考えているかなど知る由もない。彼らが見ているのはただ一つ、「終了コード（Exit Code）」のみだ。
もし、エラーでファイルが生成されなかったのに、プロセスが「正常終了（0）」を返したらどうなるか？ 後続のバッチ処理は、存在しないファイルを処理しようとして連鎖的に崩壊する。この「連鎖崩壊」を防ぐのが、`WScript.Quit`の役割である。
終了コードの設計基準
- 0: 正常終了（Success）
- 1〜: 異常終了（Error）。ここで「どのタイプのエラーか」を定義せよ。
- 例：1=設定ファイル欠損、2=DB接続失敗、3=IOエラー
—
2. プロダクションコード：失敗を許さない例外処理テンプレート
単に書くのではない。`On Error Resume Next`を局所的に使い、エラーを握りつぶさずに「捕捉」して終了コードを切り替える。これがプロの流儀だ。
‘ =================================================================
‘ 堅牢な自動化スクリプトのテンプレート
‘ =================================================================
Option Explicit
‘ メイン処理を実行し、結果を終了コードとして親に伝える
WScript.Quit(Main())
Function Main()
Dim exitCode
exitCode = 0 ‘ デフォルトは正常終了
‘ エラーハンドリング開始
On Error Resume Next
‘ ここにメインの業務ロジックを記述
Call ProcessLogic()
‘ エラーが発生したか判定
If Err.Number <> 0 Then
‘ エラーログを吐き出し、コードを返す
WScript.Echo “致命的エラーが発生しました: ” & Err.Description
exitCode = 100 ‘ 独自の異常コード
End If
On Error GoTo 0
‘ 結果を呼び出し元（親）へ返す
Main = exitCode
End Function
Sub ProcessLogic()
‘ 業務ロジックの例：ファイル操作など
‘ 失敗が予測される箇所をここに集約する
End Sub
—
3. 親プロセス（バッチファイル）側の「受け皿」を設計する
VBScriptがコードを投げても、バッチ側が受け取れなければ意味がない。`%ERRORLEVEL%`を監視するこの書き方は、システム運用の基本中の基本だ。
@echo off
cscript //nologo my_script.vbs
if %ERRORLEVEL% NEQ 0 (
echo [ERROR] スクリプトの実行に失敗しました。コード: %ERRORLEVEL%
exit /b %ERRORLEVEL%
)
echo [SUCCESS] 正常終了しました。
—
4. 現場で「死なない」ための極限の知見
① `cscript` を強制せよ
VBScriptを実行する際、`wscript.exe`を使ってはならない。`wscript`はGUIポップアップを出すため、タスクスケジューラでバックグラウンド実行させると、エラーダイアログが出た瞬間にプロセスが止まり、永遠に終了コードが返らなくなる。
自動化ツールは必ず `cscript.exe //nologo` で実行せよ。
② ファイル・DB連携の「半端な終了」を防ぐ
データベースの接続やファイルの書き込み中にスクリプトが落ちると、ロックファイルが残ったり、DBのトランザクションが宙に浮く。
終了コードを返す直前には、必ず `Set obj = Nothing` を呼び出し、明示的なクリーンアップを行うこと。オブジェクトのライフサイクルを管理しないエンジニアに、堅牢なシステムを構築する資格はない。
③ 終了コードを「意味」で分割せよ
単なる「1」ではなく、エラーの内容を詳細に分類せよ。
- ファイルがないのか？（101）
- 権限がないのか？（102）
- DBの接続タイムアウトか？（201）
これを親バッチ側で分岐させれば、「ファイルがない場合はリトライする」「DBエラーなら管理者に即座にメールする」といった、高度なリカバリー自動化が可能になる。
—
まとめ：スクリプトは「対話」である
VBScriptをただの「作業代行マシン」だと思っているうちは、二流だ。
スクリプトは、親システムと対話する「責任あるエージェント」である。
`WScript.Quit`に込めるのは、ただの数値ではない。「今の状況をどう判断したか」という君自身の判断そのものだ。 この責任感を持ってコードを書いたとき、君の自動化ツールは、誰の手も借りずに自律的に動く「無敵のシステム」へと進化するだろう。
さあ、コードを書き換えろ。エラーを握りつぶすな。正しく終了させ、正しく伝達するのだ。
