ADMIN_UTL_MODIFY存储过程

ADMIN_UTL_MODIFY是一个自动存储过程，用于维护 SYSIBM.SYSAUTORUNS_HIST 和 SYSIBM.SYSAUTOALERTS 目录表。

开始通用编程接口信息。 ADMIN_UTL_MODIFY存储过程将删除 SYSIBM.SYSAUTORUNS_HIST 表中所有早于可配置阈值的条目，并删除 SYSIBM.SYSAUTOALERTS 表中所有早于可配置阈值且状态为“完成”的条目。

环境

ADMIN_UTL_MODIFY存储过程在WLM建立的地址空间中运行，并使用资源恢复服务附件功能连接到 Db2。 ADMIN_UTL_MODIFY存储过程是必需的，必须安装并可以执行。

需要授权

要执行CALL语句，包含CALL语句的程序包或计划的所有者必须拥有DBADM或更高权限。

语法

选项说明

ADMIN_UTL_MODIFY存储过程有以下选项：

修改选项

ADMIN_UTIL_MODIFY存储过程的配置参数字符串表示形式，由以逗号分隔的“名称=值”对组成。可选参数包括：

HISTORY-DAYS

删除 SYSIBM.SYSAUTORUNS_HIST 表中的条目和 SYSIBM.SYSAUTOALERTS 表中的完整警报后的天数。天数应为正数。

修改选项是一个VARCHAR(30000)类型的输入参数

历史条目编号

返回一个唯一标识符，当存储过程 SYSPROC.ADMIN_UTL_MODIFY 执行时，可用于读取 SYSIBM.SYSAUTORUNS_HIST 表中的执行日志。这是一个BIGINT类型的输出参数。

返回码

提供存储过程的返回代码。可能的值包括：

0: 通话已成功结束。
4: 通话已成功结束。消息输出参数包含一条警告消息。
12: 通话未成功完成。消息输出参数包含描述错误的消息。

返回码参数是一个整数类型的输出参数。

消息

包含描述存储过程所遇到错误的信息。

消息参数是VARCHAR(1331)类型的输出参数

示例

以下示例展示了Java™对ADMIN_UTL_MODIFY存储过程的调用：

String options = "history-days=90";
CallableStatement callStmt =
con.prepareCall("CALL SYSPROC.ADMIN_UTL_MODIFY(?, ?, ?, ?)");
callStmt.setString(1, options);
callStmt.registerOutParameter(2,Types.INTEGER);
callStmt.registerOutParameter(3,Types.INTEGER);
callStmt.registerOutParameter(4,Types.LONGVARCHAR);
callStmt.execute();
if ( callStmt.getInt(3) > 0 )
{
    System.err.println("Error: " + callStmt.getString(4));
}

外部输入

AUTO_UTL_MODIFY存储过程从 SYSIBM.SYSAUTORUNS_HIST 和 SYSIBM.SYSAUTOALERTS 目录表中读取其他输入。

输出

ADMIN_UTL_MONITOR存储过程返回以下输出参数：

历史条目编号
返回码
消息

ADMIN_UTL_MODIFY存储过程还会从 SYSIBM.SYSAUTORUNS_HIST 和 SYSIBM.SYSAUTOALERTS 表中删除行，并在 SYSIBM.SYSAUTORUNS_HIST 表中插入一行以记录其活动。通用编程接口信息结束。