ADMIN_TASK_STATUS 管理视图 - 检索任务状态信息

ADMIN_TASK_STATUS 管理视图检索有关管理任务调度程序中任务执行状态的信息。

模式为 SYSTOOLS。

首次调用 ADMIN_TASK_ADD 过程时，将创建此视图。

权限

对 ADMIN_TASK_STATUS 管理视图的 SELECT 或 CONTROL 特权。 除非使用 RESTRICTIVE 选项创建数据库，否则缺省情况下将向 PUBLIC 授予 SELECT 特权。

查询 ADMIN_TASK_STATUS 视图时，它将仅返回由会话授权标识创建的任务状态记录。

缺省 PUBLIC 特权

在非限制性数据库中，当自动创建视图时，将向 PUBLIC 授予 SELECT 特权。

示例

示例 1: 请求调度程序中任务的状态:
SELECT * from SYSTOOLS.ADMIN_TASK_STATUS
示例 2: 使用 SQLERRM 函数格式化 SQLERRMC 列中的数据:
SELECT TASKID, STATUS, SQLCODE, SQLSTATE, RC,
   VARCHAR( SQLERRM( 'SQL' || CHAR( ABS(SQLCODE) ),
   SQLERRMC, x'FF', 'en_US', 1 ), 256) AS MSG_TXT
   FROM SYSTOOLS.ADMIN_TASK_STATUS

返回的信息

表 1. ADMIN_TASK_STATUS 管理视图返回的信息
列名 数据类型 描述
名称 VARCHAR(128) 任务的名称。
任务标识 INTEGER 任务标识。
状态 VARCHAR(10) 任务的状态。 有效值为：
  • RUNNING-任务当前正在运行。
  • COMPLETED-任务已完成运行。
  • NOTRUN-发生错误，导致调度程序无法调用任务的过程。
  • UNKNOWN-任务已开始运行，但意外情况导致调度程序无法记录任务结果。 如果系统异常结束或在任务运行时发生电源故障，那么可能会发生此情况。
调用 INTEGER 当前调用计数。
BEGIN_TIME TIMESTAMP 任务开始的时间。1

如果 STATUS 为RUNNING,COMPLETED，或UNKNOWN，此值指示任务开始运行的时间。

如果 STATUS 为NOTRUN，它指示任务应该已开始的时间。
时间 (END_TIME) TIMESTAMP 任务完成运行的时间。1

此值将为NULL如果 STATUS 为RUNNING.

如果 STATUS 为UNKNOWN，此值是任务调度程序检测到任务不再执行并更新状态表的时间。
AGENT_ID BIGINT agent_id -“应用程序句柄（代理程序标识）”监视元素
SQLCODE INTEGER

如果 STATUS 为COMPLETED，此值指示 CALL 返回到过程的 SQLCODE。

如果 STATUS 为NOTRUN，此值指示阻止任务运行的错误的 SQLCODE。

如果状态为RUNNING或UNKNOWN，此值将为NULL.
SQLSTATE CHAR(5)

如果 STATUS 为COMPLETED，此值指示 CALL 返回给过程的 SQLSTATE。

如果 STATUS 为NOTRUN，此值指示阻止任务运行的错误的 SQLSTATE。

如果状态为RUNNING或UNKNOWN，此值将为NULL.
sqlerrmc VARCHAR (70) 用于 BIT 数据

包含一个或多个标记，以 X'FF ' 分隔，因为它们出现在 SQLCA 的 SQLERRMC 字段中。 这些标记将替换为错误条件描述中的变量

如果 STATUS 为COMPLETED，此值指示 CALL 返回给过程的 SQLERRMC。

如果 STATUS 为NOTRUN，此值指示阻止任务运行的错误的 SQLERRMC。

如果状态为RUNNING或UNKNOWN，此值将为NULL.
返回码 INTEGER 如果 STATUS 为COMPLETED，这包含从 CALL 到过程的返回码 (如果过程具有返回码)。 否则，这将是NULL.
  • 1 BEGIN_TIME 和 END_TIME 基于数据库服务器的时区。 用户负责对夏令时 (DST) 进行调整。