バッチモードで Stata の do ファイルが失敗したときにアラートを受け取る
毎晩 Stata のバッチモードで do ファイルを実行していて、それがエラーで止まっても、Task Scheduler(タスク スケジューラ)は The operation completed successfully (0x0)(この操作を正しく終了しました)と表示します。誰かがレポートを開くまで、誰も気づきません。Stata のバッチモードはエラーをスケジューラから隠してしまいますが、do ファイル自身が Stata の r() コードでそれを報告できます。
スケジューラが成功したと思い込む理由
Windows では、Stata は StataMP-64.exe /e do job.do でウィンドウなしに do ファイルを実行します(/b でも動きますが、最後に OK をクリックするまで待つため、スケジュール実行には向きません)。Linux と macOS では、同等のコマンドは stata -b do job.do です。いずれの場合も Stata は出力を job.log に書き出し、do ファイルがエラーで止まると、そのエラーはログに r(601); のような行として残ります。
しかし、プロセス自体は正常に終了します。Stata のユーザーは何年も前から、Windows、Linux、macOS のいずれでも、バッチモードはエラーの後に終了コード 0 を返すと報告しています(Windows 版 Stata 17 MP で /e を使ったときも同じでした)。また StataCorp のバッチモードの FAQ には、終了コードについての記述がありません。スケジューラは終了コードでしかジョブを判断できないので、Task Scheduler は 0x0 を表示し、cron は成功とみなします。よくある回避策は、後からログで r( を検索することですが、ログが想定外のフォルダーに書き出されると機能しなくなります。
Stata のジョブが静かになる原因はほかに 2 つあります。タスクがまったく起動しない場合(PC の電源が切れていた、スリープしていた、タスクのアカウントがログオンできない)と、Stata が終了せずにダイアログで待っている場合です。後者はバッチモードでも見られたというユーザーがいます。どちらも、気づけるようなログの行を残しません。
do ファイルの中からエラーを報告する
対策は、終了コードに頼るのではなく、do ファイル自身にエラーを捕まえて報告させることです。以下のコードは、あなたの処理を capture noisily { … } で囲みます。中で何かが失敗すると、リターンコード(たとえば rc=601、ファイルが見つからない)と、tb_log に do ファイルのログを設定していればその最後の 20 行を付けて /fail を送ります。その後、同じエラーで停止します。Windows では、バッチモードの Stata はそれでも 0 で終了します(このコードを Stata 17 MP で /e を使って実行したところ、ping は届き、r(601) の後に Windows が受け取った終了コードは 0 でした)。そのため、知らせてくれるのは Task Scheduler ではなくアラートです。do ファイルが正常に終わると、メモリ上のオブザベーション数を送ります。
* --- TaskBeacon: top of the do-file ---
local tb "https://taskbeacon.io/ping/your-job-id"
* curl.exe is built into Windows 10 and 11; macOS and Linux have curl
local tb_curl = cond(c(os) == "Windows", "curl.exe", "curl")
local tb_log "" // optional: this do-file's log (batch mode: stata -b do job.do, or StataMP-64.exe /e do job.do on Windows, writes job.log in the current folder); its last 20 lines go with a failure
shell `tb_curl' -fsS -m 10 "`tb'/start"
capture noisily {
* --- your code here (the example data: replace with your own) ---
sysuse auto, clear
}
quietly {
local tb_rc = _rc
if `tb_rc' {
* the last 20 lines of the log (if tb_log is set) go with the failure
local tb_data ""
if `"`tb_log'"' != "" {
tempfile tb_tail
tempname tb_in tb_out
capture {
file open `tb_in' using `"`tb_log'"', read text
local tb_n 0
file read `tb_in' tb_line
while r(eof) == 0 {
local tb_n = `tb_n' + 1
local tb_k = mod(`tb_n', 20)
local tb_l`tb_k' = substr(`"`macval(tb_line)'"', 1, 300)
file read `tb_in' tb_line
}
file close `tb_in'
file open `tb_out' using `"`tb_tail'"', write text replace
forvalues tb_i = `=max(1, `tb_n' - 19)'/`tb_n' {
local tb_k = mod(`tb_i', 20)
file write `tb_out' `"`macval(tb_l`tb_k')'"' _n
}
file close `tb_out'
local tb_data `"--data-binary "@`tb_tail'" -H "Content-Type: text/plain""'
}
capture file close `tb_in'
capture file close `tb_out'
}
shell `tb_curl' -fsS -m 10 `tb_data' "`tb'/fail?rc=`tb_rc'"
exit `tb_rc'
}
}
* --- TaskBeacon: end of the do-file ---
local tb_rows = _N
shell `tb_curl' -fsS -m 10 "`tb'?rows=`tb_rows'"アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
失敗する可能性のある処理はすべて波かっこの間に入れてください。閉じかっこの後のコマンドは捕捉されません。ping は Windows 10 と 11 に含まれる curl.exe を使い、最大 10 秒しか待たないので、ネットワークの問題で do ファイルが止まることはありません。このコードは Windows 版の Stata 向けです。Linux や macOS では、curl.exe の代わりに curl と書いてください。
得られるもの
- Failed(失敗): すぐに、
r()コードとログの末尾をアラートに含めて届きます。受信トレイでr(601)とファイル名を見れば、たいてい何を直せばよいかわかります。 - Missed(未実行): 予定時刻に猶予時間を加えた時刻までに do ファイルから報告がなかったとき。たとえば PC の電源が切れていた場合です。スケジュールは Task Scheduler と同じようにジョブに設定します。
- Late(遅延): 開始の ping は届いたのに、実行がいつもよりずっと長くかかっているとき。ダイアログで止まった do ファイルはこのように見えます。
- Odd data(異常データ): 終了はしたものの、
_Nが最近の実行より 40% 以上少ないか、0 のとき。0 行、またはいつもよりずっと少ない場合を参照してください。
do ファイルをスケジュールするときは、タスクの Start in(開始)フォルダーを do ファイルのフォルダーに設定してください。そうすればログが見つけやすい場所に書き出されます(設定しないと、Stata がプログラムフォルダーに書こうとして r(608) で止まることがあります)。Docs の Stata のページに、schtasks の完全な行があります。
TaskBeacon を使わない場合
終了コードを自分で正しくすることもできます。小さな .bat やシェルスクリプトから Stata を起動し、Stata の終了後、r( とそれに続く数字で始まる行をログから探し、見つかったら 1 で終了します。すると Task Scheduler は 0x1 を表示します。これでエラーはカバーできますが、起動しなかった実行やダイアログで待っている Stata のセッションはカバーできず、0x1 を見るには結局 Task Scheduler を確認する必要があります。メールで知るには、それを送る仕組みも必要です。Task Scheduler はもう単独ではメールを送れません(スケジュールタスクが失敗したときにメールを送るを参照)。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:Stata · ステータス · 報告できる内容
- Task Scheduler の Last Run Result は 0x0 なのに、スクリプトは失敗したLast Run Result 0x0 は、起動したプログラムが 0 を返したことしか意味しません。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- StataCorp FAQ: Running Stata for Windows in batch mode (/e and /b) (日付なし、例は Stata 15、2026年11月9日に確認)
- StataCorp FAQ:Unix で Stata をバッチモードで実行する(-b で file.log を書き出す) (日付なし、2026年11月9日に確認)
- Statalist アーカイブ:do ファイルが失敗したのにバッチファイルが 0 を返す(Windows /e) (2008年、古い:長年の疑問であることの表れ)
- Statalist アーカイブ:バッチモードでエラーの後も 0 以外の終了コードが返らない(macOS) (2011年、古い:長年の疑問であることの表れ)
- Statalist: Stata batch mode exit status on error (Stata 13 の頃、2014年ごろ、古い)
- ログから r(…); を探して 1 で終了するラッパー(P. Schumm、GitHub gist) (日付なし)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。