CHGFTR

Modifier un filtre

En bref

La commande CHGFTR vous permet de modifier le texte de description d'un filtre.

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

Syntaxe minimale

CHGFTR FILTER(…)

Paramètres

FILTER Filtre obligatoire
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGFTR 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 CHGFTR vous permet de modifier le texte de description d'un filtre.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILTER	Filtre	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Filtre	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Filtre (FILTER)

Indique le nom qualifié du filtre dont la description est en cours de modification.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*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: Le filtre est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée pour ce travail, c'est QGPL qui est prise en compte.
nom-bibliothèque: Indiquez le nom de la bibliothèque dans laquelle le filtre est recherché.
nom-filtre: Indiquez le nom du filtre à modifier.

Texte 'descriptif' (TEXT)

Désigne le texte court de description de l'objet. Pour plus d'informations sur ce paramètre, se reporter à "Appendix A, Expanded Parameter Descriptions" de la brochure CL Reference.

*SAME: La valeur reste inchangée.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte comportant 50 caractères au maximum.

Exemples

CHGFTR   FILTER(MYLIB/MYFILTER)  TEXT('Indiquez le nouveau
texte')

Cette commande permet de modifier la description du filtre MYFILTER dans la bibliothèque MYLIB.

Messages d'erreur

Messages *ESCAPE

CPF812D: Dommage &8 sur le filtre &4.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9807: Une ou plusieurs bibliothèques de la liste ont été supprimées.
CPF9808: Allocation impossible pour une ou plusieurs bibliothèques de la liste.
CPF9830: Allocation de la bibliothèque &1 impossible.