SPSS Statistics の本番ジョブが失敗したときにアラートを受け取る
IBM SPSS Statistics のプロダクションジョブ(.spj)が、--production … silent でスケジュール実行されています。シンタックスエラー、ファイルの欠落、失敗した GET DATA はジョブの出力に記録されますが、ジョブはそのまま続行することがあり、スケジューラには何も見えません。シンタックスの中に Python を数行加えれば、エラーを捕まえて通知できます。
プロダクションジョブはエラーをどう扱うか
プロダクションジョブは、1 つ以上のシンタックスファイルをユーザーインターフェースなしで実行します。SPSS Statistics 31 の IBM のドキュメントには、コマンドラインから起動する方法が示されています。たとえば stats.exe --production C:\jobs\monthly.spj silent で(IBM のページにはこのスイッチが -production とも記載されています)、これを Task Scheduler に設定します。なお、同じマシンで Statistics アプリケーションが開いている間は、コマンドラインのプロダクションジョブは実行できません。
ジョブ内の各シンタックスファイルについて、エラー後の動作を選べます。Continue processing after errors(エラー後も処理を続行)か Stop processing immediately(直ちに処理を停止)です。「続行」では、失敗したコマンドは出力に報告され、次のコマンドはそのときあるデータで実行されるため、ジョブが空や古い結果のまま終わることがあります。「停止」では処理が終わりますが、どちらの場合も結果は出力ファイルにあり、スケジューラが理解できる形にはなっていません。
IBM のドキュメントには、失敗したプロダクションジョブが 0 以外の終了コードを返すという記述はありません。例外のすぐ下に terminated with exit code 0 と書かれたジョブのログを投稿しているユーザーもいます(IBM Community、2022年)。終了コードは当てにならないものとして扱い、結果は自分で報告してください。いつものことですが、起動しなかったジョブ(PC の電源が切れていた、ライセンスサーバーが応答しなかった)は、出力をまったく残しません。
シンタックスの中から報告する
SPSS Statistics は BEGIN PROGRAM PYTHON3 を使ってシンタックスの中で Python 3 を実行できます。以下のコードは開始時に TaskBeacon へ ping を送り、spss.Submit であなたのシンタックスを実行し、SPSS がエラーを出したらメッセージ付きで /fail を送ります。シンタックスが正常に終わると、アクティブなデータセットのケース数を送ります。
* --- TaskBeacon: SPSS Statistics with the Python 3 integration ---.
BEGIN PROGRAM PYTHON3.
import json, urllib.request
import spss
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
spss.Submit(r"""
* --- your syntax here (the example data: replace it, e.g. GET FILE='C:\data\sales.sav'.) ---.
DATA LIST FREE / amount.
BEGIN DATA
12.5 7 3
END DATA.
""")
except spss.SpssError as e:
tb_ping("/fail", {"error": str(e)[:200]})
raise
tb_ping("", {"rows": spss.GetCaseCount()})
END PROGRAM.実際の環境ではまだテストしていません。結果をお知らせください。コードはベンダーのドキュメントに沿っています。support@taskbeacon.io までご連絡ください。
アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
例の DATA LIST の代わりに、三重引用符の間にあなたのシンタックスを入れてください。そのブロックの実行中に SPSS がエラーを報告すると、spss.Submit が spss.SpssError を発生させ、コードは /fail を送ってからそのエラーを再送出します。Docs の SPSS のページに、プロダクションジョブの設定とよくある問題があります。
得られるもの
- Failed(失敗): ジョブが失敗するコマンドに達した時点で、SPSS のエラーメッセージ付きで届きます。
- Missed(未実行): 予定時刻に猶予時間を加えた時刻までにジョブから報告がなかったとき。起動しなかった実行も含みます。
- Late(遅延): 開始したものの、いつもよりずっと長くかかっているとき。
- Odd data(異常データ): ケース数が最近の実行より 40% 以上少ないか、0 のとき。空の抽出データを読み込んだ
GET FILEを捕まえます。
TaskBeacon を使わない場合
シンタックスファイルを Stop processing immediately に設定し、出力を決まったファイルに書き出し、ジョブの終了後にそのファイルからエラー行を探して SMTP サーバー経由でメールを送る小さなスクリプト(Python や PowerShell)を用意します。これでエラーは報告できますが、起動しなかった実行については出力ファイルの日付のチェックも必要です。同じ構造の SAS バッチジョブのエラーと Stata do ファイルのエラーも参照してください。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- SAS のバッチジョブがエラーで終了したときにアラートを受け取るSAS は警告で 1、エラーで 2 を返しますが、それも誰かが見ていればの話です。
- バッチモードで Stata の do ファイルが失敗したときにアラートを受け取るStata の /e や -b は、do ファイルの失敗をスケジューラーに伝えません。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- IBM Docs、SPSS Statistics 31:コマンドラインからプロダクションジョブを実行する (バージョン 31、日付なし、2026年11月9日に確認)
- IBM Docs、SPSS Statistics 31:プロダクションジョブ内のシンタックスファイル(エラー後に続行するか停止するか) (バージョン 31、日付なし、2026年11月9日に確認)
- IBM Community:Production Facility の NullPointerException(ログには終了コード 0) (2022年6月6日、古い:問題の表れ)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。