CHGPFTRG

Modifier déclencheur fich phys

En bref

La commande CHGPFTRG modifie l'état ou la sécurité de l'un ou de l'ensemble des déclencheurs d'un fichier.

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

Syntaxe minimale

CHGPFTRG FILE(…) TRG(…)

Paramètres

FILE Fichier obligatoire
TRG Déclencheur obligatoire
TRGLIB Bibliothèque du déclencheur
STATE Etat du déclencheur
TRGSEC Sécurité déclencheur
MIRROR Protection par disque miroir

Astuce : dans une session 5250, tapez CHGPFTRG 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 CHGPFTRG modifie l'état ou la sécurité de l'un ou de l'ensemble des déclencheurs d'un fichier. Les déclencheurs ont été définis à l'aide de l'instruction SQL CREATE TRIGGER ou de la commande ADDPFTRG.

Un déclencheur peut passer de l'état inactivé (il n'est plus appelé au cours des opérations d'entrée-sortie) à l'état activé (il est à nouveau appelé au cours des opérations d'entrée-sortie) et inversement. Plutôt que de modifier l'état du déclencheur, vous pouvez enlever celui-ci lorsque vous ne voulez pas qu'il soit appelé, puis l'ajouter de nouveau lorsque vous en avez besoin.

La valeur du paramètre de sécurité d'un déclencheur peut être *YES ou *NO afin d'indiquer que le déclencheur est considéré comme sécurisé ou non sécurisé pour le contrôle d'accès de ligne et de colonne. Si le contrôle d'accès de ligne ou de colonne est actif pour la table de déclenchement, une erreur est renvoyée lorsque la valeur *YES est remplacée par *NO pour le paramètre de sécurité.

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.
Vous devez disposer du droit QIBM_DB_SECADM pour modifier la valeur du paramètre de sécurité d'un déclencheur.

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
TRG	Déclencheur	Valeur caractère, *ALL	Obligatoire, positionnel 2
TRGLIB	Bibliothèque du déclencheur	Nom, ALL, CURLIB	Facultatif
STATE	Etat du déclencheur	SAME, ENABLED, *DISABLED	Facultatif
TRGSEC	Sécurité déclencheur	SAME, YES, *NO	Facultatif
MIRROR	Protection par disque miroir	SAME, NO	Facultatif

Fichier (FILE)

Indique le fichier pour lequel un déclencheur doit être modifié. Il doit s'agir d'un fichier physique.

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 sur laquelle doit porter la recherche.

Déclencheur (TRG)

Indique le nom du déclencheur à modifier.

*ALL: Tous les déclencheurs définis pour le fichier sont modifiés.
Remarque :Lorsque *ALL est indiqué, tous les déclencheurs définis pour le fichier sont modifiés. Toutes les valeurs indiquées pour le paramètre Bibliothèque du déclencheur (TRGLIB) sont ignorées.
valeur-caractères: Indiquez le nom du déclencheur.
Remarque :La casse est conservée lorsque des minuscules sont indiquées.

Bibliothèque du déclencheur (TRGLIB)

Indique la bibliothèque du déclencheur à modifier.

*ALL: Tous les déclencheurs des bibliothèques de déclencheurs sont utilisés.
*CURLIB: La bibliothèque en cours du travail est utilisée. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
Remarque :La valeur spéciale *CURLIB correspond à la valeur du travail en cours d'exécution lors de la modification du déclencheur.
nom: Indiquez le nom de la bibliothèque à utiliser.

Etat du déclencheur (STATE)

Indique l'état que le déclencheur va prendre. Ce paramètre permet d'interdire provisoirement l'appel d'un déclencheur (désactivation) ou de permettre qu'il soit à nouveau appelé au cours des opérations d'entrée-sortie (activation).

*SAME: La valeur reste inchangée.
*ENABLED: Le déclencheur qui était désactivé est à nouveau appelé au cours des opérations d'entrée-sortie.
*DISABLED: Le déclencheur n'est pas appelé au cours des opérations d'entrée-sortie.

Sécurité déclencheur (TRGSEC)

Indique si le déclencheur est considéré comme sécurisé ou non sécurisé pour le contrôle d'accès de ligne et de colonne.

*SAME: La valeur reste inchangée.
*YES: Indique que le déclencheur est considéré comme sécurisé pour le contrôle d'accès de ligne et de colonne.
*NO: Indique que le déclencheur est considéré comme non sécurisé pour le contrôle d'accès de ligne et de colonne.

Protection par disque miroir (MIRROR)

Indique si un déclencheur exécuté dans un environnement protégé par disque miroir sera appelé uniquement sur le système qui initie l'opération ou sur les deux systèmes de la paire protégée par disque miroir.

*SAME: La valeur reste inchangée.
*YES: Indique qu'un déclencheur exécuté dans un environnement protégé par disque miroir sera appelé sur les deux systèmes de la paire protégée par disque miroir.
*NO: Indique qu'un déclencheur exécuté dans un environnement protégé par disque miroir sera appelé uniquement sur le système qui initie l'opération.

Exemples

CHGPFTRG   FILE(ADMN/PERSONNEL)  TRG(*ALL)  STATE(*DISABLED)

Cette commande désactive tous les déclencheurs du fichier PERSONNEL de la bibliothèque ADMN.

La commande suivante permet de rappeler tous les déclencheurs :

CHGPFTRG   FILE(ADMN/PERSONNEL)  TRG(*ALL)  STATE(*ENABLED)

Messages d'erreur

Messages *ESCAPE

CPF32C6: La procédure de reprise du déclencheur a échoué.