Commande CL IBM i (AS/400)

CRTFTR

Créer un filtre

En bref

La commande CRTFTR permet de créer un filtre du type indiqué.

CRTFTR se lit CRT (Créer) + FTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTFTR FILTER(…) TYPE(…)

Paramètres

FILTER Filtre obligatoire
TYPE Type obligatoire
TEXT Texte 'descriptif'
AUT Droits

Astuce : dans une session 5250, tapez CRTFTR 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 CRTFTR permet de créer un filtre du type indiqué. Les filtres comprennent des postes de sélection et des postes d'action. Un filtre permet à l'utilisateur de classer les données en différents groupes et de préciser les actions particulières à appliquer à chacun d'entre eux. L'utilisateur type est un programmeur ou un opérateur système qui assure la gestion du système.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILTER	Filtre	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Filtre	Nom
	Qualificatif 2: Biblio	Nom, *CURLIB
TYPE	Type	ALR, PRB	Obligatoire, positionnel 2
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif
AUT	Droits	Nom, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Facultatif

Filtre (FILTER)

Indique le nom qualifié du filtre créé.

La bibliothèque spécifiée doit se trouver sur le pool de mémoire secondaire du système (ASP numéro 1) ou sur le pool de mémoire secondaire de base configuré de l'utilisateur (ASP numéros 2-32). La bibliothèque ne peut pas se trouver sur un ASP indépendant. Les valeurs possibles pour la bibliothèque sont les suivantes :

*CURLIB: Le filtre est recherché dans la bibliothèque en cours. 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 à créer.

Type (TYPE)

Indique le type du filtre en cours de création. Le type d'un filtre détermine les applications compatibles avec ce filtre et le type de postes qu'il peut contenir.

*ALR: Il s'agit d'un filtre d'alerte. Le gestionnaire d'alertes de l'i5/OS peut utiliser ce filtre pour les alertes qu'il reçoit ou qu'il génère.
*PRB: Il s'agit d'un filtre d'incident. Le gestionnaire d'incidents de l'i5/OS l'utilise pour les postes d'incidents en cours de création, de modification ou de suppression.

Texte 'descriptif' (TEXT)

Désigne le texte court de description de l'objet.

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

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT: Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*CHANGE: L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL: L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE: L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE: L'utilisateur n'a pas accès à l'objet.

nom: Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTFTR   FILTER(MYLIB/MYFILTER)  TYPE(*ALR)  AUT(*CHANGE)
         TEXT('Mon filtre')

Cette commande permet de créer un filtre d'alerte appelé MYFILTER dans la bibliothèque MYLIB. Le type est *ALR et le public dispose du droit *CHANGE sur le filtre correspondant à 'Mon filtre'.

Messages d'erreur

Messages *ESCAPE

CPF2108: Objet &1, type *&3, non ajouté à la bibliothèque &2.
CPF2112: L'objet &1 de type *&3 existe déjà dans &2.
CPF2113: Impossible d'allouer la bibliothèque &1.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2283: La liste d'autorisation &1 n'existe pas.