Recibe una alerta cuando un job batch de SAS termina con errores
Un programa SAS se ejecuta en modo batch cada noche desde Task Scheduler o cron. Cuando termina con errores, o en silencio con advertencias, la prueba está en un archivo .log que nadie abre hasta que una tabla sale mal. SAS sí informa del problema; comprobar SYSCC al final del programa convierte ese aviso en una alerta.
Qué informa SAS y por qué aun así pasa desapercibido
A diferencia de algunas herramientas estadísticas, SAS sí devuelve al sistema operativo un código de retorno con significado. Las guías complementarias de SAS 9.4 para Windows y UNIX los enumeran: 0 cuando todos los pasos terminaron con normalidad, 1 cuando hubo advertencias, 2 cuando hubo errores, y valores más altos para ABORT y errores internos. Dentro del programa, la macrovariable automática SYSCC contiene el código de condición actual: 0 si todo fue bien y 4 tras una advertencia; tras un error es más alto (en la práctica, a menudo 1012).
Entonces, ¿por qué los jobs de SAS siguen fallando en silencio?
- Nadie mira el código. Task Scheduler muestra
0x2en una columna y cron lo descarta. Un código de retorno 1 por advertencias a menudo se ignora a propósito, y con él se ignoran también problemas reales como variable is uninitialized o truncated. - SYSCC puede engañar. Es de lectura y escritura, así que el código puede restablecerlo. Con el valor predeterminado
ERRORCHECK=NORMAL, una sentenciaLIBNAMEoFILENAMEque falla no lo eleva. Y la SAS Problem Note 57254 describe un caso en SAS 9.4 (notificado en M1, corregido en M4) en el queSYSCCvalía 4 tras un error causado por unas comillas sin cerrar enSASAUTOS=. La documentación de SAS también señala que la forma en queSYSCCse convierte en el código de retorno del sistema operativo depende del sistema anfitrión. - La ejecución nunca ocurrió: el servidor estaba caído, la licencia había vencido, la entrada del programador estaba mal. No se escribe ningún log.
- El programa se ejecutó sin errores y produjo una tabla vacía, porque la extracción de origen estaba vacía. Código de retorno 0.
Informa desde el final del programa
El código de abajo usa PROC HTTP, que forma parte de Base SAS 9.4. Envía un ping a TaskBeacon al inicio; al final comprueba SYSCC: si es mayor que 4, envía /fail con el código; si no, cuenta las filas de tu tabla de resultados y las envía.
/* --- 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;Aún no probado en una instalación real: cuéntanos cómo te fue. El código sigue la documentación del fabricante. Escribe a support@taskbeacon.io.
En la app, la pestaña Code (código) de tu job te da este código con la dirección propia del job en lugar de your-job-id, y puedes desmarcar las partes que no necesites.
Sustituye work.result por la tabla que te importa. Como aquí las advertencias (4) cuentan como éxito, añade tu propia comprobación para las advertencias que te importen, o envía otro número y define una regla para él; consulta tu propio número.
Si el servidor no puede acceder directamente a internet, PROC HTTP acepta un proxy (PROXYHOST=); la página de SAS en la documentación explica cómo ejecutar SAS en modo batch con -sysin y los problemas habituales.
Qué obtienes
- Failed (fallido) con el valor de
SYSCC, justo cuando el programa termina con errores. - Missed (no ejecutado) cuando el programa no informó antes de su hora prevista más el margen, también cuando SAS no arrancó.
- Late (retrasado) cuando arrancó y tarda mucho más de lo habitual, por ejemplo un paso que espera a una tabla bloqueada.
- Odd data (datos raros) cuando el número de filas cae más de un 40% por debajo de las ejecuciones recientes o es 0. Consulta 0 filas o muchas menos de lo habitual.
Sin TaskBeacon
SAS puede enviar correo por sí mismo: la SAS Usage Note 32187 muestra un paso FILENAME EMAIL que se ejecuta cuando SYSCC indica un error. Eso requiere un servidor SMTP configurado para SAS (EMAILSYS, EMAILHOST) y, como cualquier comprobación dentro del programa, no puede informar de una ejecución que nunca arrancó. Combínalo con una comprobación de la fecha del log desde otro job si te importan las ejecuciones perdidas.
¿Conectaste Claude o ChatGPT a TaskBeacon? Pregúntale “¿qué falló anoche y por qué?” y te responde a partir de tus jobs. Cómo funciona.
Relacionado
En la documentación: SAS · Número de filas · Estados.
- Recibe una alerta cuando falla un trabajo de producción de SPSS StatisticsLas tareas de producción pueden continuar tras errores; el log es el único testigo.
- Recibe una alerta cuando un job carga 0 filas o muchas menos de lo habitualEl código de salida 0 no dice nada de cuántas filas llegaron.
- Descubre cuándo un job programado no se ejecutó en absolutoUna ejecución que nunca ocurrió no deja ningún error del que avisar.
Todos los casos de uso · Preguntas frecuentes
Empezar con TaskBeacon es gratis, por ahora con todas las funciones abiertas y sin tarjeta de crédito. Crea un job, pega el código y el primer ping aparece en la página del job.
Empieza gratis Ver demo en vivoFuentes
- SAS Macro Language Reference: SYSCC automatic macro variable (SAS 9.x, sin fecha; revisado el 9 de noviembre de 2026)
- SAS 9.4 Companion for Windows: códigos de retorno (0 normal, 1 advertencias, 2 errores …) (SAS 9.4, sin fecha; revisado el 9 de noviembre de 2026)
- SAS Problem Note 57254: SYSCC es 4 tras un error por una comilla sin cerrar en SASAUTOS= (corregido en 9.4M4) (14 de diciembre de 2015, actualizado el 2 de febrero de 2016, antiguo: un error concreto, corregido en 9.4M4)
- SAS Usage Note 32187: How can I send an email if an error occurs in my log? (sin fecha)
- Base SAS 9.4 Procedures Guide: PROC HTTP (SAS 9.4, sin fecha)
Página revisada contra sus fuentes el 9 de noviembre de 2026. Los menús y límites de otros productos cambian; si algo aquí ya no coincide, escribe a support@taskbeacon.io.