Benachrichtigung, wenn ein Stata-Do-File im Batch-Modus fehlschlägt
Sie führen jede Nacht ein Do-File im Batch-Modus von Stata aus, es bricht mit einem Fehler ab, und die Aufgabenplanung (Task Scheduler) meldet trotzdem The operation completed successfully (0x0). Niemand erfährt davon, bis jemand den Bericht öffnet. Der Batch-Modus von Stata verbirgt den Fehler vor dem Planer, aber das Do-File selbst kann ihn melden, mit dem r()-Code von Stata.
Warum der Planer glaubt, es habe funktioniert
Unter Windows führt Stata ein Do-File ohne Fenster mit StataMP-64.exe /e do job.do aus (/b geht auch, wartet aber am Ende darauf, dass Sie auf OK klicken, was ein Zeitplan nicht kann). Unter Linux und macOS ist das Gegenstück stata -b do job.do. So oder so schreibt Stata die Ausgabe in job.log, und wenn das Do-File an einem Fehler stoppt, steht der Fehler in diesem Log: eine Zeile wie r(601);.
Der Prozess selbst endet aber normal. Stata-Nutzer berichten seit Jahren, unter Windows, Linux und macOS, dass der Batch-Modus nach einem Fehler den Exit-Code 0 zurückgibt (dasselbe haben wir mit Stata 17 MP für Windows mit /e gesehen), und die FAQs von StataCorp zum Batch-Modus sagen nichts über Exit-Codes. Ein Planer kann einen Job nur nach seinem Exit-Code beurteilen, also zeigt die Aufgabenplanung 0x0, und cron sieht einen Erfolg. Der übliche Ausweg ist, das Log danach nach r( zu durchsuchen; das funktioniert, bis das Log in einem Ordner landet, mit dem Sie nicht gerechnet haben.
Zwei weitere Arten, wie ein Stata-Job verstummt: Die Aufgabe startet nie (der PC war aus oder im Ruhezustand, oder das Konto der Aufgabe kann sich nicht anmelden), und Stata wartet auf einen Dialog, statt sich zu beenden, was manche Nutzer sogar im Batch-Modus erlebt haben. Keines von beiden erzeugt eine Logzeile, die Ihnen auffallen würde.
Den Fehler aus dem Do-File heraus melden
Die Lösung: Das Do-File fängt seinen eigenen Fehler ab und meldet ihn, statt sich auf den Exit-Code zu verlassen. Der folgende Code umschließt Ihre Arbeit mit capture noisily { … }. Schlägt darin etwas fehl, sendet er /fail mit dem Rückgabecode (zum Beispiel rc=601, Datei nicht gefunden) und, wenn Sie tb_log auf das Log des Do-Files setzen, dessen letzte 20 Zeilen. Danach bricht er mit demselben Fehler ab. Unter Windows endet Stata im Batch-Modus trotzdem mit 0 (wir haben diesen Code auf Stata 17 MP mit /e ausgeführt: Die Pings kamen an, und Windows sah nach r(601) den Exit-Code 0); es ist also die Benachrichtigung, die es Ihnen sagt, nicht die Aufgabenplanung. Endet das Do-File gut, sendet er die Zahl der Beobachtungen im Speicher.
* --- 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'"In der App gibt Ihnen der Tab Code Ihres Jobs diesen Code mit der eigenen Adresse des Jobs statt your-job-id, und Sie können die Teile abwählen, die Sie nicht brauchen.
Setzen Sie alles, was fehlschlagen kann, zwischen die geschweiften Klammern: Ein Befehl nach der schließenden Klammer wird nicht abgefangen. Die Pings verwenden curl.exe, das zu Windows 10 und 11 gehört, und warten höchstens 10 Sekunden, sodass ein Netzwerkproblem Ihr Do-File nie anhält. Der Code ist für Stata unter Windows geschrieben; unter Linux oder macOS schreiben Sie curl statt curl.exe.
Was Sie bekommen
- Failed (fehlgeschlagen), sofort, mit dem
r()-Code und dem Ende des Logs in der Benachrichtigung.r(601)und den Dateinamen im Posteingang zu sehen, reicht meist, um zu wissen, was zu beheben ist. - Missed (verpasst), wenn sich das Do-File bis zur geplanten Zeit plus Karenzzeit nicht gemeldet hat, zum Beispiel weil der PC aus war. Den Zeitplan stellen Sie am Job ein wie in der Aufgabenplanung.
- Late (verspätet), wenn der Start-Ping kam, der Lauf aber viel länger dauert als üblich – so sieht ein Do-File aus, das an einem Dialog hängt.
- Odd data (ungewöhnliche Daten), wenn es fertig wurde,
_Naber mehr als 40 % unter die letzten Läufe fiel oder 0 ist. Siehe 0 Zeilen oder viel weniger als üblich.
Um das Do-File zu planen, setzen Sie den Ordner Start in (Starten in) der Aufgabe auf den Ordner des Do-Files, damit das Log dort geschrieben wird, wo Sie es finden (sonst versucht Stata womöglich seinen Programmordner und bricht mit r(608) ab). Die Stata-Seite in den Docs enthält die vollständige schtasks-Zeile.
Ohne TaskBeacon
Sie können den Exit-Code selbst ehrlich machen: Starten Sie Stata aus einem kleinen .bat- oder Shell-Skript, und durchsuchen Sie nach dem Ende von Stata das Log nach einer Zeile, die mit r( gefolgt von Ziffern beginnt; wird eine gefunden, beenden Sie mit 1. Die Aufgabenplanung zeigt dann 0x1. Das deckt Fehler ab, aber keinen Lauf, der nie gestartet ist, und keine Stata-Sitzung, die auf einen Dialog wartet, und Sie müssen trotzdem in der Aufgabenplanung nachsehen, um das 0x1 zu bemerken. Für eine E-Mail brauchen Sie außerdem etwas, das sie sendet, was die Aufgabenplanung von sich aus nicht mehr tut (siehe E-Mail, wenn eine geplante Aufgabe fehlschlägt).
Claude oder ChatGPT mit TaskBeacon verbunden? Fragen Sie: „Was ist letzte Nacht fehlgeschlagen, und warum?“, und die Antwort kommt aus Ihren Jobs. So funktioniert das.
Verwandte Themen
In den Docs: Stata · Status · Was gemeldet werden kann.
- Aufgabenplanung zeigt Last Run Result 0x0, aber das Skript ist fehlgeschlagenLast Run Result 0x0 bedeutet nur, dass das gestartete Programm 0 zurückgegeben hat.
- Benachrichtigung, wenn ein Job 0 Zeilen oder viel weniger als üblich lädtExit-Code 0 sagt nichts darüber, wie viele Zeilen angekommen sind.
- Erfahren, wenn ein geplanter Job gar nicht gelaufen istEin Lauf, der nie stattfand, hinterlässt keinen Fehler, der eine Benachrichtigung auslösen könnte.
Der Einstieg in TaskBeacon ist kostenlos, derzeit mit allen Funktionen und ohne Kreditkarte. Legen Sie einen Job an, fügen Sie den Code ein, und der erste Ping erscheint auf der Seite des Jobs.
Kostenlos starten Live-Demo ansehenQuellen
- StataCorp FAQ: Running Stata for Windows in batch mode (/e und /b) (ohne Datum, Beispiele mit Stata 15; geprüft am 9. November 2026)
- StataCorp FAQ: Stata im Batchmodus unter Unix ausführen (-b schreibt file.log) (ohne Datum; geprüft am 9. November 2026)
- Statalist-Archiv: Eine Batchdatei gibt 0 zurück, obwohl das Do-File fehlgeschlagen ist (Windows /e) (2008, alt: ein Zeichen für eine seit Langem bestehende Frage)
- Statalist-Archiv: kein Exit-Code ungleich 0 nach einem Fehler im Batchmodus (macOS) (2011, alt: ein Zeichen für eine seit Langem bestehende Frage)
- Statalist: Stata batch mode exit status on error (Zeit von Stata 13, etwa 2014; alt)
- Ein Wrapper, der das Log nach r(…); durchsucht und mit 1 endet (P. Schumm, GitHub Gist) (ohne Datum)
Diese Seite wurde am 9. November 2026 mit ihren Quellen abgeglichen. Menüs und Grenzen anderer Produkte ändern sich; wenn hier etwas nicht mehr stimmt, schreiben Sie an support@taskbeacon.io.