Función de tabla ADMIN_TASK_STATUS

La función ADMIN_TASK_STATUS devuelve una tabla con una fila para cada tarea definida en la lista de tareas del planificador de tarea administrativa. Cada fila indica el estado de la tarea en la última ocasión en que se ejecutó.

Opcionalmente, si especifica el parámetro max-history, la función devuelve una fila de datos para cada ejecución de una tarea (hasta el valor max-history ). Para las tareas que no se han ejecutado, esta función devuelve una fila de datos con un estado NULL.

Autorización

El usuario que llame a esta función debe tener privilegios de administrador ( MONITOR1 ).

El esquema es DSNADM.

max-history: Especifica el número máximo de estados de ejecución por tarea que se devolverán. Se devuelven los estados de ejecución más recientes.
Si el parámetro se establece en NULL, se devuelven todos los estados de ejecución de tareas disponibles. Si el parámetro se establece en 1, solo se devuelve el estado de la última vez que se ejecutó la tarea, que es el mismo resultado que no especificar esta opción. Es un parámetro de entrada de tipo INTEGER.

El resultado de la función es una tabla con el formato que se muestra en la siguiente tabla.

Tabla 1. Formato de la tabla resultante para ADMIN_TASK_STATUS
Nombre de columna	Tipo de datos	Contiene
TASK_NAME	VARCHAR(128)	Contiene el nombre de la tarea que se ha ejecutado, se está ejecutando o se ha omitido.
Estado	VARCHAR(10)	Contiene uno de los siguientes valores que indica el estado de la tarea: EN EJECUCIÓN La tarea se está ejecutando actualmente COMPLETED La tarea ha terminado de ejecutarse. Para tareas asíncronas (trabajos JCL), esta columna contiene COMPLETADO siempre que el trabajo se envía para su ejecución. De lo contrario, esta columna contiene COMPLETADO solo después de que la tarea haya terminado de ejecutarse. NO CORRER La tarea no se ejecutó a la hora de invocación programada. La columna MSG contiene el mensaje de error o advertencia que indica por qué no se ejecutó la tarea. UNKNOWN El programador se cerró mientras la tarea estaba en ejecución. El programador se inicia de nuevo, pero no puede conocer el estado de ejecución de esta tarea interrumpida.
NUM_ INVOCACIONES	ENTERO	Contiene el número de veces que el programador de tareas administrativas ha intentado ejecutar la tarea, incluida la hora actual si la tarea se está ejecutando en ese momento. Los valores de esta columna no indican si la tarea se ejecutó correctamente.
START_ TIMESTAMP	TIMESTAMP	Contiene la hora en que la tarea comenzó a ejecutarse si la columna STATUS (Estado) contiene COMPLETED (Completada), RUNNING (En ejecución) o UNKNOWN (Desconocido). De lo contrario, esta columna contiene la hora a la que la tarea debería haber comenzado a ejecutarse, pero no pudo.
FIN_ HORA	TIMESTAMP	Contiene la hora en que la tarea terminó de ejecutarse.
JOB_ID	CHAR(8)	Contiene el ID de trabajo que se asigna al trabajo JCL enviado por el programador de tareas administrativas. Esta columna contiene NULL si la tarea es un procedimiento almacenado o si la columna STATUS no contiene COMPLETED.
MAXRC	ENTERO	Contiene el código de retorno más alto de la presentación de un trabajo JCL. Si la tarea es sincrónica, el valor de esta columna cambia al código de retorno que se devuelve cuando el trabajo termina de ejecutarse. Esta columna se establece en NULL si la tarea es un procedimiento almacenado, si la columna STATUS no contiene COMPLETED, o si una tarea síncrona ha finalizado y se ha ejecutado con JES3 en un sistema z/OS® 1.7 o anterior.
COMPLETION_ TYPE	ENTERO	Contiene uno de los siguientes valores que indica el tipo de finalización del trabajo JCL enviado por el programador de tareas administrativas: 0 Sin información de finalización 1 El trabajo ha finalizado con normalidad 2 Trabajo finalizado por código de finalización 3 El trabajo tenía un error JCL 4 El trabajo se ha cancelado 5 Oferta de trabajo cancelada 6 El convertidor falló al procesar el trabajo 7 El trabajo no ha superado los controles de seguridad 8 Error de trabajo al final de la memoria Esta columna contiene NULL si la tarea es un procedimiento almacenado, si la columna STATUS no contiene COMPLETED o si el trabajo JCL se ejecuta con JES3 en un sistema z/OS 1.7 o anterior.
ABENDCD	ENTERO	Contiene el código de error del sistema devuelto por un trabajo JCL fallido que fue enviado por el programador de tareas administrativas. Esta columna contiene NULL si la tarea es un procedimiento almacenado, si la columna STATUS no contiene COMPLETED o si el trabajo JCL se ejecuta con JES3 en un sistema z/OS 1.7 o anterior.
USER_ABENDCD	ENTERO	Contiene el código de error de usuario devuelto por un trabajo JCL fallido que fue enviado por el programador de tareas administrativas. Esta columna contiene NULL si la tarea es un procedimiento almacenado, si la columna STATUS no contiene COMPLETED o si el trabajo JCL se ejecuta con JES3 en un sistema z/OS 1.7 o anterior.
MSG	VARCHAR(128)	Contiene el mensaje de error o advertencia de la última vez que se ejecutó la tarea.
SQLCODE	ENTERO	Contiene el SQLCODE establecido por el administrador de tareas administrativas ( Db2 ) cuando el programador de tareas administrativas llamó a un procedimiento almacenado. Esta columna contiene NULL si la tarea es un trabajo JCL o si la columna STATUS no contiene COMPLETED.
SQLSTATE	CHAR (5)	Contiene el SQLSTATE establecido por Db2 cuando el programador de tareas administrativas llamó a un procedimiento almacenado. Esta columna contiene NULL si la tarea es un trabajo JCL o si la columna STATUS no contiene COMPLETED.
SQLERRP	VARCHAR(8)	Contiene el SQLERRP establecido por Db2 cuando el programador de tareas administrativas llamó a un procedimiento almacenado. Esta columna contiene NULL si la tarea es un trabajo JCL o si la columna STATUS no contiene COMPLETED.
SQLERRMC	VARCHAR(70)	Contiene el SQLERRMC establecido por Db2 cuando el programador de tareas administrativas llamó a un procedimiento almacenado. Esta columna contiene NULL si la tarea es un trabajo JCL o si la columna STATUS no contiene COMPLETED.
DB2_SSID	VARCHAR(4)	Contiene el ID del subsistema de programación de tareas ( Db2 ) asociado con el programador de tareas administrativas que ejecutó la tarea o debería haberla ejecutado.
USERID	VARCHAR(128)	Contiene el ID de usuario con el que se ejecutó la tarea.

Ejemplo 1 : Recuperar información de estado sobre todas las tareas que se han ejecutado en la lista de tareas del programador de tareas administrativas:

   SELECT *
     FROM TABLE (DSNADM.ADMIN_TASK_STATUS()) AS T;