SAS のバッチジョブがエラーで終了したときにアラートを受け取る
SAS プログラムが毎晩 Task Scheduler や cron からバッチで実行されています。エラーで終わったとき、あるいは警告だけ出して静かに終わったとき、その証拠は .log ファイルの中にあり、テーブルがおかしくなるまで誰も開きません。SAS 自体は問題を報告しています。プログラムの最後で SYSCC を確認すれば、その報告をアラートに変えられます。
SAS が報告する内容と、それでも気づかれない理由
一部の統計ツールと違い、SAS はオペレーティングシステムに意味のあるリターンコードを返します。SAS 9.4 の Windows 版と UNIX 版のコンパニオンには、すべてのステップが正常に終わったときは 0、警告があったときは 1、エラーがあったときは 2、ABORT や内部エラーではそれより大きい値、と記載されています。プログラムの中では、自動マクロ変数 SYSCC が現在の条件コードを保持しています。成功なら 0、警告の後は 4、エラーの後はそれより大きい値(実際には 1012 であることが多い)です。
では、なぜ SAS のジョブは今でも静かに失敗するのでしょうか。
- 誰もコードを見ていない。 Task Scheduler は列に
0x2を表示するだけで、cron はそれを捨ててしまいます。警告を示すリターンコード 1 は意図的に無視されることが多く、そのとき variable is uninitialized や truncated といった本当の問題も一緒に無視されます。 - SYSCC は誤解を招くことがある。 読み書き可能なので、コードでリセットできてしまいます。既定の
ERRORCHECK=NORMALでは、失敗したLIBNAMEやFILENAMEステートメントでも値は上がりません。また SAS Problem Note 57254 には、SAS 9.4 で(M1 で報告され M4 で修正)、SASAUTOS=の中の閉じていない引用符によるエラーの後でもSYSCCが 4 だったケースが記載されています。SAS のドキュメントには、SYSCCがどのようにオペレーティングシステムのリターンコードになるかはホストによって異なる、とも書かれています。 - 実行そのものが行われなかった: サーバーが停止していた、ライセンスが切れていた、スケジューラの設定が間違っていた。この場合、ログはまったく書かれません。
- プログラムは問題なく動き、空のテーブルを作った: 元の抽出データが空だったためです。リターンコードは 0 です。
プログラムの最後で報告する
以下のコードは Base SAS 9.4 に含まれる PROC HTTP を使います。開始時に TaskBeacon へ ping を送り、最後に SYSCC を確認します。4 より大きければコード付きで /fail を送り、そうでなければ結果テーブルの行数を数えて送ります。
/* --- 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;実際の環境ではまだテストしていません。結果をお知らせください。コードはベンダーのドキュメントに沿っています。support@taskbeacon.io までご連絡ください。
アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
work.result を、確認したいテーブルに置き換えてください。ここでは警告(4)を成功として扱うので、気になる警告については独自のチェックを追加するか、別の数値を送ってそれにルールを設定してください。独自の数値を参照してください。
サーバーがインターネットに直接接続できない場合、PROC HTTP はプロキシ(PROXYHOST=)を指定できます。Docs の SAS のページでは、-sysin を使った SAS のバッチ実行とよくある問題を説明しています。
得られるもの
- Failed(失敗): プログラムがエラーで終わった直後に、
SYSCCの値付きで届きます。 - Missed(未実行): 予定時刻に猶予時間を加えた時刻までにプログラムから報告がなかったとき。SAS が起動しなかった場合も含みます。
- Late(遅延): 開始したものの、いつもよりずっと長く実行されているとき。たとえば、ロックされたテーブルを待っているステップなどです。
- Odd data(異常データ): 行数が最近の実行より 40% 以上少ないか、0 のとき。0 行、またはいつもよりずっと少ない場合を参照してください。
TaskBeacon を使わない場合
SAS は自分でメールを送れます。SAS Usage Note 32187 には、SYSCC がエラーを示したときに実行される FILENAME EMAIL ステップが紹介されています。ただし SAS 用に設定された SMTP サーバー(EMAILSYS、EMAILHOST)が必要で、プログラム内部のチェックはどれもそうですが、起動しなかった実行は報告できません。実行漏れが問題になるなら、別のジョブによるログの日付チェックと組み合わせてください。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- SPSS Statistics の本番ジョブが失敗したときにアラートを受け取るプロダクションジョブはエラーの後も続行することがあり、証拠はログだけです。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- SAS Macro Language Reference: SYSCC automatic macro variable (SAS 9.x、日付なし、2026年11月9日に確認)
- SAS 9.4 Companion for Windows:リターンコード(0 正常、1 警告、2 エラー …) (SAS 9.4、日付なし、2026年11月9日に確認)
- SAS Problem Note 57254:SASAUTOS= の対応しない引用符によるエラーの後、SYSCC が 4 になる(9.4M4 で修正) (2015年12月14日、2016年2月2日更新、古い:9.4M4 で修正された特定のバグ)
- SAS Usage Note 32187:ログにエラーが出たときにメールを送るには (日付なし)
- Base SAS 9.4 Procedures Guide: PROC HTTP (SAS 9.4、日付なし)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。