Validates whether a given cleartext password matches a previously encoded password.

Return-type: LOGICAL

Applies to: SECURITY-POLICY system handle

Syntax

VALIDATE-PASSWORD(password, encoded-value)
password
A CHARACTER expression containing the cleartext password. The AVM converts this value to UTF-8 before encoding it and storing it, ensuring consistency across different code page settings.
encoded-value
A CHARACTER expression containing the encoded password value, generated using either the genpassword utility or the ENCODE-PASSWORD( ) method. The value must include a valid Encoding prefix.

The method returns TRUE if the cleartext password matches the encoded value. The method returns FALSE if the password does not match or the encoded value is malformed or uses an unsupported prefix.