Benachrichtigung, wenn ein SAS-Batch-Job mit Fehlern endet
Ein SAS-Programm läuft jede Nacht im Batch über die Windows-Aufgabenplanung (Task Scheduler) oder cron. Endet es mit Fehlern oder still mit Warnungen, steht der Beleg in einer .log-Datei, die niemand öffnet, bis eine Tabelle falsch ist. SAS meldet das Problem durchaus; eine Prüfung von SYSCC am Ende des Programms macht aus dieser Meldung eine Benachrichtigung.
Was SAS meldet und warum es trotzdem unbemerkt bleibt
Anders als manche Statistikwerkzeuge gibt SAS dem Betriebssystem einen aussagekräftigen Rückgabecode. Die SAS-9.4-Companions für Windows und UNIX führen sie auf: 0, wenn alle Schritte normal endeten, 1 bei Warnungen, 2 bei Fehlern und höhere Werte für ABORT und interne Fehler. Innerhalb des Programms enthält die automatische Makrovariable SYSCC den aktuellen Statuscode: 0 bei Erfolg und 4 nach einer Warnung; nach einem Fehler ist er höher (in der Praxis oft 1012).
Warum schlagen SAS-Jobs dann trotzdem still fehl?
- Niemand schaut auf den Code. Die Aufgabenplanung zeigt
0x2in einer Spalte, cron verwirft ihn. Ein Rückgabecode 1 für Warnungen wird oft absichtlich ignoriert, und damit auch echte Probleme wie variable is uninitialized oder truncated. - SYSCC kann täuschen. Die Variable ist les- und schreibbar, Code kann sie also zurücksetzen. Mit dem Standard
ERRORCHECK=NORMALerhöht eine fehlschlagendeLIBNAME- oderFILENAME-Anweisung sie nicht. Und SAS Problem Note 57254 beschreibt einen Fall in SAS 9.4 (gemeldet in M1, behoben in M4), in demSYSCCnach einem Fehler durch ein nicht geschlossenes Anführungszeichen inSASAUTOS=den Wert 4 hatte. Die Dokumentation von SAS weist außerdem darauf hin, dass es vom Host abhängt, wie ausSYSCCder Rückgabecode des Betriebssystems wird. - Der Lauf fand nie statt: Der Server war aus, die Lizenz abgelaufen, der Eintrag im Planer falsch. Es wird gar kein Log geschrieben.
- Das Programm lief sauber und erzeugte eine leere Tabelle, weil der Quellauszug leer war. Rückgabecode 0.
Am Ende des Programms melden
Der folgende Code verwendet PROC HTTP, das zu Base SAS 9.4 gehört. Er pingt TaskBeacon beim Start; am Ende prüft er SYSCC: Liegt der Wert über 4, sendet er /fail mit dem Code, sonst zählt er die Zeilen Ihrer Ergebnistabelle und sendet sie.
/* --- TaskBeacon: top of the program --- */
%let tb = https://taskbeacon.io/ping/your-job-id;
filename tb_out temp;
%macro tb_ping(path);
proc http url="&tb.&path" method="GET" out=tb_out timeout=10; run;
%mend;
%tb_ping(%str(/start));
/* --- your code here --- */
data work.result; set sashelp.class; run;
/* --- TaskBeacon: end of the program --- */
%macro tb_end;
/* SYSCC: 0 = fine, 4 = only warnings, above 4 = errors */
%if &syscc > 4 %then %do;
/* after an error, batch SAS checks only the syntax (OBS=0) and skips steps: leave that mode so the ping runs */
options nosyntaxcheck obs=max replace;
%tb_ping(%str(/fail?rc=&syscc));
%end;
%else %do;
proc sql noprint; select count(*) into :tb_rows trimmed from work.result; quit;
%tb_ping(%str(?rows=&tb_rows));
%end;
%mend;
%tb_end;Noch nicht an einer echten Installation getestet – sagen Sie uns, wie es gelaufen ist. Der Code folgt der Dokumentation des Herstellers. Schreiben Sie an support@taskbeacon.io.
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.
Ersetzen Sie work.result durch die Tabelle, auf die es Ihnen ankommt. Da Warnungen (4) hier als Erfolg zählen, ergänzen Sie eine eigene Prüfung für die Warnungen, die Ihnen wichtig sind, oder senden Sie eine weitere Zahl und legen eine Regel dafür an; siehe Ihre eigene Zahl.
Kann der Server das Internet nicht direkt erreichen, akzeptiert PROC HTTP einen Proxy (PROXYHOST=); die SAS-Seite in den Docs behandelt den Batch-Betrieb von SAS mit -sysin und die häufigen Probleme.
Was Sie bekommen
- Failed (fehlgeschlagen) mit dem Wert von
SYSCC, direkt nachdem das Programm mit Fehlern endet. - Missed (verpasst), wenn sich das Programm bis zur geplanten Zeit plus Karenzzeit nicht gemeldet hat, auch wenn SAS gar nicht gestartet ist.
- Late (verspätet), wenn es gestartet ist und viel länger läuft als üblich, zum Beispiel weil ein Schritt auf eine gesperrte Tabelle wartet.
- Odd data (ungewöhnliche Daten), wenn die Zeilenzahl mehr als 40 % unter die letzten Läufe fällt oder 0 ist. Siehe 0 Zeilen oder viel weniger als üblich.
Ohne TaskBeacon
SAS kann selbst E-Mails senden: SAS Usage Note 32187 zeigt einen FILENAME EMAIL-Schritt, der läuft, wenn SYSCC einen Fehler anzeigt. Dafür braucht es einen für SAS eingerichteten SMTP-Server (EMAILSYS, EMAILHOST), und wie jede Prüfung innerhalb des Programms kann er keinen Lauf melden, der nie gestartet ist. Kombinieren Sie ihn mit einer Prüfung des Log-Datums durch einen anderen Job, wenn verpasste Läufe für Sie wichtig sind.
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: SAS · Anzahl der Zeilen · Status.
- Benachrichtigung, wenn ein Produktionsjob in SPSS Statistics fehlschlägtProduktionsjobs können nach Fehlern weiterlaufen; das Log ist der einzige Zeuge.
- 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
- SAS Macro Language Reference: SYSCC automatic macro variable (SAS 9.x, ohne Datum; geprüft am 9. November 2026)
- SAS 9.4 Companion for Windows: Rückgabecodes (0 normal, 1 Warnungen, 2 Fehler …) (SAS 9.4, ohne Datum; geprüft am 9. November 2026)
- SAS Problem Note 57254: SYSCC ist 4 nach einem Fehler durch ein nicht geschlossenes Anführungszeichen in SASAUTOS= (behoben in 9.4M4) (14. Dezember 2015, aktualisiert am 2. Februar 2016, alt: ein bestimmter Fehler, behoben in 9.4M4)
- SAS Usage Note 32187: Wie sende ich eine E-Mail, wenn in meinem Log ein Fehler auftritt? (ohne Datum)
- Base SAS 9.4 Procedures Guide: PROC HTTP (SAS 9.4, 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.