SAS
実環境ではまだテストされていません。結果をお知らせください。コードはベンダーのドキュメントに沿って作成しています。support@taskbeacon.io までご連絡ください。
PROC HTTP を使います。
コード
これは Code(コード)タブが生成するコードです(開始、エラー、行数 にチェックを入れた状態)。アプリでは、あなたのジョブ専用のアドレスがすでに入っています。
/* --- 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;仕組み
コードはスクリプトの開始時に /start、正常に終わったときに行数付きでそのままのアドレス、失敗したとき(SYSCC が 4 より大きい)に /fail を ping し、SYSCC をリターンコードとして送ります。
一部を省きたい場合は、Code タブでオプションのチェックを外してください。報告できる内容もご覧ください。
SAS プログラムをスケジュールで実行する
SAS for Windows は -sysin でプログラムをバッチ実行します。指定しない限り、ログとリストはプログラムの隣に出力されます。インストール先のパスを使ってください。
"C:\Program Files\SASHome\SASFoundation\9.4\sas.exe" -sysin "C:\jobs\sales.sas" -log "C:\jobs\logs" -nosplash -icon
この行を Task Scheduler(操作:Start a program(プログラムの開始))か、タスクが起動する .bat ファイルに入れます。SAS サーバーでは管理者が独自のスケジューラーを使っている場合がありますが、ping は同じように動きます。
終了コードだけでは足りない理由
SAS 9.4 for Windows は終了時に Windows へコードを返します。すべてのステップが正常に終わったときは 0、警告があれば 1、エラーがあれば 2 です(SAS 9.4 Companion for Windows、日付なし、2026年11月に閲覧)。
SAS の後に他のコマンドを実行する .bat ラッパーはこのコードを隠してしまうことがあり、0 で終わるプログラムでも空のテーブルを作ることがあります。
上のコードは最後に &syscc を確認します。4 を超えるとエラーを意味し、行数の代わりに /fail?rc= を送ります。
エラーの後、バッチ実行の SAS は構文チェックモードに切り替わります。OBS=0 を設定して残りのステップを飛ばすので、PROC HTTP も実行されません。そのため失敗時の処理では、まず options nosyntaxcheck obs=max replace; を実行してこのモードを抜けてから ping を送ります(SYNTAXCHECK システムオプション、SAS 9.4 および Viya、2026年更新)。
行数を報告する
プログラムの最後で、PROC SQL を使って work.result の行数を数えます。プログラムが作るテーブル(たとえば mylib.sales_daily)に置き換えてください。
よくある問題
- PROC HTTP が接続できない。 SAS セッションがインターネットに接続できるか確認してください。社内プロキシは PROC HTTP の
PROXYHOST=オプションで設定します。 - エラーの後に終了の ping が届かない。
OPTIONS ERRORABENDや%ABORTがあると、最後の行が実行される前に SAS が止まり、ジョブは Late(遅延)と表示されます。そのオプションを外すか、最後のブロックを必ず実行されるステップに移してください。 - ネットワーク ドライブ。 ログアウト中に実行されるタスクからは、割り当てたドライブ文字が見えません。
LIBNAMEとFILENAMEでは UNC パスを使ってください。
ユースケース: SAS のバッチジョブがエラーで終了したときにアラートを受け取る。その他のご質問: FAQ