ADD_VALIDATION_LIST_ENTRY 标量函数
标量函数 ADD_VALIDATION_LIST_ENTRY 将一个条目添加到指定的验证列表中。
验证列表条目中的值由使用验证列表控制的特定接口使用。 该功能提供了一种添加条目的方法，但不执行任何特定规则。
该函数使用 QsyAddValidationLstEntry()--Add Validation List Entry API 添加条目。
该功能要求安装 IBM i 操作系统的选项 13（包括系统开放性）。
授权： 参见下面的注释。
模式为 SYSTOOLS。
- 验证列表库
- 字符串，包含验证列表库的名称。 可包含 *CURLIB 或 *LIBL 的特殊值。
- 验证-列表名
- 字符串，包含验证列表的名称。
- 验证用户
- 字符串，包含用户与 IBM i 交互时提供的名称。 名称长度不超过 100 个字符。 该名称不必与 IBM i 用户配置文件名称相对应。
- 密码
- 字符串，包含与 validation-user 相对应的密码。 密码长度不超过 600 个字符。 该值存储在验证列表中时将被加密。
- 条目数据
- 字符串，包含条目的附加数据。 字符串最长可达 1000 个字符。 此参数是可选参数。 如果省略，则没有与 validation-user 相关的附加数据。
函数的结果是一个整数。 如果添加操作成功，函数返回值为 0。 如果操作返回错误，函数将从 API 返回 errno 值。
注
该函数在 SYSTOOLS 模式中提供，作为一个 SQL 标量函数如何简化复杂 API 的示例。 与 SYSTOOLS 中提供的其他 Db2® for i 工具类似，可以提取 SQL 源并将其用作构建类似辅助函数的模型，或在用户指定的模式中创建自定义版本。
SYSTOOLS 中提供的服务有授权要求，这些要求由用于实现服务的接口决定。 为了解权限要求，请提取服务的 SQL 并检查实现情况。
示例
为外部接口的用户添加验证条目。 使用全局变量，这样在函数调用中就看不到密码。 对调用进行包装，以便返回一个描述性的 errno 值。
CREATE VARIABLE MYLIB.VLDL_PW VARCHAR(100);
SET MYLIB.VLDL_PW = 'password for my user access';
VALUES SYSTOOLS.ERRNO_INFO(SYSTOOLS.ADD_VALIDATION_LIST_ENTRY(
VALIDATION_LIST_LIBRARY => 'APPLIB',
VALIDATION_LIST_NAME => 'APPVLDL',
VALIDATION_USER => 'my application user name',
PASSWORD => MYLIB.VLDL_PW));