Stata
Nutzt curl über shell: curl.exe unter Windows 10 und 11, curl unter macOS und Linux (der Code wählt mit c(os) das passende, sodass dasselbe Do-File überall läuft). Stata im Batchmodus endet immer mit 0, deshalb wird der Fehler im Do-File abgefangen und mit dem r()-Code von Stata gesendet. Setzen Sie tb_log auf das Log des Do-Files (stata -b do job.do schreibt job.log), dann gehen dessen letzte 20 Zeilen mit dem Fehler mit.
Der Code
Das ist der Code, den der Tab Code erzeugt (mit Start, Fehler und Zeilen angehakt). In der App enthält er bereits die eigene Adresse Ihres Jobs.
* --- 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'"So funktioniert es
Der Code pingt /start, wenn das Skript beginnt, die einfache Adresse mit der Zeilenzahl, wenn es gut endet, und /fail, wenn es fehlschlägt, mit dem Rückgabecode von Stata und, wenn tb_log gesetzt ist, den letzten 20 Zeilen des Logs.
Entfernen Sie auf dem Tab Code Haken bei Optionen, um Teile wegzulassen; entfernen Sie den Haken bei Send output lines (Ausgabezeilen senden), um keine Ausgabe zu senden, nur den Fehler oder Exit-Code. Siehe was gemeldet werden kann.
Ein Do-File nach Zeitplan ausführen
Stata für Windows führt ein Do-File ohne Fenster mit dem Schalter /e aus (mit /b wartet es, bis Sie auf OK klicken, was ein Zeitplan nicht kann). Verwenden Sie den vollständigen Pfad Ihrer Stata-Edition:
"C:\Program Files\Stata18\StataMP-64.exe" /e do "C:\jobs\sales.do"
Um es jeden Morgen zu starten, legen Sie eine Aufgabe aus einer Eingabeaufforderung an (eine Zeile):
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "\"C:\Program Files\Stata18\StataMP-64.exe\" /e do \"C:\jobs\sales.do\""
Unter macOS oder Linux führen Sie es im Batch-Modus aus cron aus (crontab -e; der Programmname hängt von Ihrer Edition ab, z. B. stata-mp):
0 6 * * * cd /home/me/jobs && /usr/local/stata/stata-mp -b do sales.do
Der Code oben verwendet curl.exe unter Windows und sonst curl (er prüft c(os)), sodass dasselbe Do-File auf jedem Rechner funktioniert.
Stata schreibt sales.log in seinen Arbeitsordner. Stellen Sie in der Aufgabenplanung (Task Scheduler) Start in (Starten in) auf den Ordner des Do-Files (Aufgabe bearbeiten → Actions / Aktionen → Start in), sonst landet das Log womöglich im Programmordner von Stata, in den Sie meist nicht schreiben dürfen (Stata bricht dann mit r(608) ab).
Warum der Exit-Code lügt
Wenn ein Do-File im Batch-Modus an einem Fehler stoppt, steht der Fehler im Log, aber Stata selbst meldet ihn Windows nicht als Fehlschlag: Die Aufgabenplanung zeigt weiterhin The operation completed successfully (0x0).
Deshalb packt der Code oben Ihre Arbeit in capture noisily { … }: Das Do-File fängt seinen eigenen Fehler ab, sendet /fail?rc= mit dem Rückgabecode von Stata (zum Beispiel rc=601, Datei nicht gefunden) und beendet sich dann mit exit.
Setzen Sie alles, was fehlschlagen kann, in die geschweiften Klammern. Ein Befehl nach der schließenden Klammer, der fehlschlägt, wird nicht abgefangen.
Die Zeilenzahl melden
Die letzte Zeile sendet _N, die Zahl der Beobachtungen im Speicher, wenn das Do-File endet. Ist der Datensatz, auf den es ankommt, am Ende nicht der im Speicher, zählen Sie ihn dort, wo er ist:
use "C:\data\sales_clean.dta", clear
local tb_rows = _N
TaskBeacon benachrichtigt Sie, wenn die Zeilen mehr als 40 % unter die letzten Läufe fallen oder 0 sind. Beide Regeln können Sie auf der Job-Seite ändern.
Häufige Probleme
- Überhaupt kein Ping.
shellstartetcurl.exeunter Windows (in Windows 10 und 11 enthalten) odercurlunter macOS und Linux. Führen Sie die curl-Zeile in einer Eingabeaufforderung oder einem Terminal auf diesem Rechner aus; ein Proxy oder eine Firewall, die HTTPS blockiert, zeigt sich dort. - Ein schwarzes Fenster blitzt auf (Windows). Das ist
shell, das eine Konsole für curl öffnet; es ist harmlos. - Der Start kommt an, das Ende nie. Das Do-File stoppte außerhalb von
capture noisily, oder Stata wurde abgebrochen. Nach der Karenzzeit erscheint der Job als „Late“ (verspätet). - Netzlaufwerke. Eine Aufgabe, die läuft, während Sie abgemeldet sind, sieht keine verbundenen Laufwerksbuchstaben wie
S:; verwenden Sie UNC-Pfade (\\server\share\…).
Anwendungsfälle: Benachrichtigung, wenn ein Stata-Do-File im Batch-Modus fehlschlägt. Weitere Fragen: FAQ.