Aller au contenu

Service SQL IBM i (AS/400) · Fonction scalaire

SYSTOOLS.CHANGE_VALIDATION_LIST_ENTRY

Modifier une entrée de liste de validation

Change le mot de passe ou les données d'une entrée d'authentification dans une liste de validation (*VLDL), pour une interface externe d'application.

À quoi ça sert

Une liste de validation (objet *VLDL) stocke des identifiants d'authentification pour des applications ou interfaces externes, sans créer de profils utilisateur IBM i. Cette fonction scalaire modifie une entrée existante, repérée par VALIDATION_LIST_LIBRARY, VALIDATION_LIST_NAME et VALIDATION_USER.

On peut changer le mot de passe (PASSWORD) et les données associées (ENTRY_DATA). Les deux sont facultatifs et valent NULL par défaut. L'exemple IBM passe le mot de passe au travers d'une variable globale plutôt que d'un littéral écrit en clair dans l'instruction.

Elle s'utilise avec VALUES, comme les autres fonctions de gestion de listes de validation du schéma SYSTOOLS.

Résultat réel sur un IBM i 7.5

Pas de démonstration : la fonction modifie le mot de passe d'une entrée de liste de validation.

L'exemple d'IBM

Changer le mot de passe d'une entrée d'authentification existante dans une liste de validation.

-- Description: Change the password for an existing authentication entry.
     CREATE VARIABLE MYLIB.VLDL_PW VARCHAR(100); 
 
SET MYLIB.VLDL_PW = 'my new password'; 
 
VALUES SYSTOOLS.CHANGE_VALIDATION_LIST_ENTRY( 
                             VALIDATION_LIST_LIBRARY => 'APPLIB',  
                             VALIDATION_LIST_NAME    => 'APPVLDL', 
                             VALIDATION_USER         => 'my application user name', 
                             PASSWORD                => MYLIB.VLDL_PW);

Bon à savoir

Ne pas écrire le mot de passe en dur dans une instruction conservée dans un script ou le cache des requêtes : passer par une variable, comme dans l'exemple IBM.

Paramètres

ParamètreTypePar défautSignification
VALIDATION_LIST_LIBRARY VARCHAR(10) obligatoire Bibliothèque de la liste de validation
VALIDATION_LIST_NAME VARCHAR(10) obligatoire Nom de la liste de validation
VALIDATION_USER VARCHAR(100) obligatoire Utilisateur de la liste de validation
PASSWORD VARCHAR(600) NULL Mot de passe
ENTRY_DATA VARCHAR(1000) NULL Données de l'entrée