función de tabla CHECK_PASSWORD

La función de tabla CHECK_PASSWORD comprueba si un valor de entrada cumple las reglas de contraseña del sistema. Esta función no cambia la contraseña de ningún usuario.

Las reglas de contraseña se componen de valores del sistema QPWDRQDDIF y QPWDRULES o todos los siguientes: QPWDMINLEN, QPWDMAXLEN, QPWDLMTAJC, QPWDLMTCHR, QPWDLMTREPy QPWDRQDDGT. Los valores del sistema QPWDPOSDIF y QPWDRULES *LMTSAMPOS no se aplican porque no se utiliza una contraseña actual para una comparación.

Se recomienda que la contraseña y el nombre de autorización opcional se proporcionen utilizando variables para evitar ser visibles como parte del texto de la sentencia.

La función es similar a las reglas Comprobar contraseña cumple contraseña (QSYCHKPR) API. Si la contraseña se ajusta a las reglas de contraseña, los programas de salida registrados bajo el punto de salida QIBM_QSY_CHK_PASSWRD, se llama al formato CHKP0200 para permitir una verificación adicional.

Autorización:

No es necesario ninguno si nombre-autorización es *NONE, *CURRENT o coincide con el usuario efectivo de la hebra.
De lo contrario, el llamante debe tener la autorización especial *SECADM y las autorizaciones *OBJMGT y *USE sobre el perfil de usuario.

El esquema es QSYS2.

contraseña

Serie de caracteres que contiene un valor de contraseña que se debe comprobar.

nombre-autorización

Serie gráfica o de caracteres que identifica el nombre del usuario para el que se está comprobando la contraseña. El nombre de perfil de usuario se utiliza al comprobar las reglas de contraseña para los valores del sistema Necesario Diferencia en Contraseñas (QPWDRQDDIF) y Regla de contraseña-la contraseña no puede contener el nombre de usuario (QPWDRULES *LMTPRFNAME).

Puede contener los siguientes valores especiales:

*CURRENT: El nombre del usuario que se está ejecutando actualmente se utiliza como el usuario cuya contraseña se está comprobando.
*NONE: La contraseña que se está comprobando no está asociada con un usuario. Las reglas de contraseña especificadas por los valores del sistema Diferencia Necesaria en las Contraseñas (QPWDRQDDIF) y Regla de Contraseña-la contraseña no puede contener el nombre de usuario (QPWDRULES *LMTPRFNAME) no influyen en la comprobación de contraseña puesto que se aplican a un perfil de usuario específico. Este es el valor por omisión.

El resultado de la función es una tabla que contiene una fila con el formato que se muestra en la tabla siguiente. Todas las columnas admiten nulos.

Tabla 1. Función de tabla CHECK_PASSWORD
Nombre de columna	Tipo de datos	Descripción
CONTRASEÑA_VÁLIDA	VARCHAR(3)	Indica si la validación de contraseña ha sido satisfactoria. NO La contraseña no cumple las reglas del sistema. SI La contraseña cumple las reglas del sistema.
MESSAGE_ID	CHAR(7)	El ID de mensaje que indica la razón de la anomalía. Contiene el valor nulo si PASSWORD_VALID es YES.
MESSAGE_TEXT	VARGRAPHIC(1024) CCSID 1200	Texto de mensaje de primer nivel correspondiente a MESSAGE_ID. Contiene el valor nulo si MESSAGE_ID es nulo.
MESSAGE_SECOND_LEVEL_TEXT	VARGRAPHIC(4096) CCSID 1200	Texto de mensaje de segundo nivel correspondiente a MESSAGE_ID. Contiene el valor nulo si MESSAGE_ID es nulo.

Ejemplo

Compruebe una nueva contraseña potencial para ver si cumple las reglas de contraseña del sistema.
```
SELECT * FROM TABLE(QSYS2.CHECK_PASSWORD('amIvalid?'));
```