CHGPFCST

Modifier contrainte fich phys

En bref

CHGPFCST se lit CHG (Modifier) + PFCST. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGPFCST FILE(…) CST(…)

Paramètres

FILE Fichier obligatoire
CST Nom de la contrainte obligatoire
STATE Etat de la contrainte
CHECK Vérifier les données

Astuce : dans une session 5250, tapez CHGPFCST puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CHGPFCST modifie l'état d'une ou de plusieurs contraintes de vérification pour des contraintes de fichier ou des contraintes référentielles existant entre des fichiers base de données locaux. Pour les contraintes référentielles, les fichiers base de données locaux sont des fichiers physiques qui ont été définis comme fichier parent ou dépendant à l'aide de l'interface SQL ou de la commande ADDPFCST. Pour les contraintes de vérification, le fichier de l'expression de vérification est celui qui a été défini dans une contrainte à l'aide de l'interface SQL ou de la commande ADDPFCST.

Une contrainte référentielle peut passer de l'état inactivé (l'intégrité référentielle n'est plus assurée) à l'état activé (l'intégrité référentielle est de nouveau effectuée), et vice versa. L'état d'une contrainte de vérification peut passer de l'état inactivé (la vérification de validité n'est plus assurée) à l'état activé (la vérification de validité est de nouveau effectuée), et vice versa. Plutôt que de modifier l'état d'une contrainte, vous pouvez l'enlever pour ne plus l'utiliser, puis l'ajouter de nouveau lorsque vous en avez besoin.

Restrictions :

Vous devez disposer du droit de gestion de l'objet (*OBJMGT) ou du droit de modification des attributs de l'objet (*OBJALTER) sur le fichier physique.
Vous devez disposer du droit d'exécution (*EXECUTE) sur la bibliothèque contenant le fichier physique.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
CST	Nom de la contrainte	Valeurs uniques: ALL, CHKPND Autres valeurs (jusqu'à 300 répétitions): Valeur caractère	Obligatoire, positionnel 2
STATE	Etat de la contrainte	SAME, ENABLED, *DISABLED	Facultatif
CHECK	Vérifier les données	YES, NO	Facultatif

Fichier (FILE)

Indique le fichier ou le fichier dépendant pour lequel la contrainte est modifiée et la bibliothèque de l'un ou l'autre de ces fichiers. Il doit s'agir d'un fichier physique comprenant un membre au maximum (MAXMBRS(1)).

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

nom: Indiquez le nom du fichier physique.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle la recherche doit être effectuée.

Nom de la contrainte (CST)

Indique le nom de l'association de contrainte à modifier.

Ce paramètre est obligatoire.

Valeurs uniques

*ALL: Toutes les associations de contrainte appliquées au fichier ou au fichier dépendant sont modifiées.
*CHKPND: Seules les associations de contrainte qui peuvent ne pas être satisfaites par certains enregistrements et qui sont en instance de vérification sont modifiées.

Autres valeurs (jusqu'à 300 répétitions)

valeur-caractères: Indiquez le nom de l'association de contrainte.
Remarque :La casse est conservée lorsque des minuscules sont indiquées.

Etat de la contrainte (STATE)

Indique l'état que la contrainte va prendre. Ce paramètre permet de désactiver provisoirement l'intégrité référentielle (*REFCST) ou la vérification de validité des données (*CHKCST) fournie par une contrainte définie ou établie, ou de l'activer si elle était désactivée.

*SAME: La valeur reste inchangée.
*ENABLED: La contrainte désactivée assure de nouveau l'intégrité référentielle (*REFCST) ou le contrôle de validité (*CHKCST).
*DISABLED: La contrainte n'assure plus d'intégrité référentielle ou de vérification de validité.

Vérifier les données (CHECK)

Indique si les données des fichiers référencés sont vérifiées lorsqu'une contrainte est activée. Dans l'affirmative, il appartient à l'utilisateur de s'assurer que les données en cours dans le fichier sont valides pour la contrainte.

*YES: Les données sont vérifiées lorsque la contrainte est activée.
*NO: Les données ne sont pas vérifiées lorsque la contrainte est activée.

Exemples

CHGPFCST   FILE(ADMN/PERSONNEL)  CST(*CHKPND)
           STATE(*DISABLED)

Cette commande désactive les contraintes référentielles qui ont été à l'origine de l'état (vérification en attente) des enregistrements du fichier PERSONNEL de la bibliothèque ADMN. Tant que l'intégrité référentielle est désactivée, l'utilisateur peut corriger les enregistrements qui ont entraîné la vérification en attente.

Une fois les enregistrements corrigés, la commande ci-dessous est exécutée de sorte que l'intégrité référentielle soit réactivée.

CHGPFCST   FILE(ADMN/PERSONNEL)  CST(*CHKPND)
           STATE(*ENABLED)

Messages d'erreur

Messages *ESCAPE

CPF32B2: La contrainte ne peut pas être modifiée pour le fichier &1.