WRKFTR

Gérer les filtres

En bref

La commande WRKFTR permet de gérer et d'imprimer une liste de filtres, de modifier et de supprimer les filtres indiqués, de gérer les postes de sélection et d'action figurant dans des filtres spécifiques et de créer de nouveaux filtres.

WRKFTR se lit WRK (Gérer) + FTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKFTR FILTER(…)

Paramètres

FILTER Filtre obligatoire

Astuce : dans une session 5250, tapez WRKFTR 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

Restrictions :

La recherche porte uniquement sur les bibliothèques pour lesquelles vous disposez du droit *READ.
Seuls les filtres sur lesquels vous avez des droits sont indiqués.
Pour effectuer des opérations sur les filtres, vous devez disposer du droit d'utilisation *USE de la commande qui leur est associée, ainsi que du droit correspondant aux filtres sur lesquels l'opération doit être effectuée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILTER	Filtre	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Filtre	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALL, *ALLUSR

Filtre (FILTER)

Indique le nom qualifié du filtre affiché.

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. Tous les objets contenus dans ces bibliothèques sont affichés avec leur nom.

*CURLIB: La recherche s'effectue 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.
*USRLIBL: La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques.
*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

'xxxxx' représente le numéro de l'ASP principal.
L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom-bibliothèque: Indiquez le nom de la bibliothèque dans laquelle les filtres sont recherchés.
*ALL: Tous les filtres de la bibliothèque indiquée sont répertoriés.
nom-filtre: Indiquez le nom du filtre affiché.
nom-filtre-générique*: Indiquez le nom générique du filtre. Un nom générique est une chaîne d'un ou plusieurs caractères suivie d'un astérisque (*), par exemple ABC*. Si un nom générique est indiqué, le système affiche tous les filtres dont le nom commence par ce nom générique et sur lesquels l'utilisateur a des droits. Si le nom générique (préfixe) ne comprend pas d'astérisque, le système considère qu'il s'agit d'un nom de filtre complet.

Exemples

WRKFTR   FILTER(MYLIB/MY*)

Cette commande permet d'afficher une liste de filtres dont les noms commencent par 'MY' dans la bibliothèque MYLIB. A partir de cette liste, vous pouvez modifier, supprimer ou gérer des postes pour un ou plusieurs des filtres affichés. Vous avez également la possibilité de créer un filtre.

Messages d'erreur

Messages *ESCAPE

CPF812F: Filtre endommagé.
CPF91E8: Une erreur interne de traitement s'est produite.
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.