WRKQMQRY

Gérer les requêtes QM

En bref

La commande WRKQMQRY (Gérer les requêtes QM) permet d'afficher une liste de requêtes QM, établie à partir d'un sous-ensemble de noms de requêtes QM défini par l'utilisateur.

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

Syntaxe minimale

WRKQMQRY QMQRY(…)

Paramètres

QMQRY Requête QM obligatoire

Astuce : dans une session 5250, tapez WRKQMQRY 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

La commande WRKQMQRY (Gérer les requêtes QM) permet d'afficher une liste de requêtes QM, établie à partir d'un sous-ensemble de noms de requêtes QM défini par l'utilisateur. Diverses fonctions sont disponibles pour gérer les requêtes listées.

Restrictions :

La recherche s'effectue uniquement dans les bibliothèques sur lesquelles vous disposez du droit USE.
Seules les requêtes QM sur lesquelles vous disposez de droits s'affichent sur l'écran.
Pour effectuer des opérations sur les requêtes QM, vous devez disposer du droit USE sur la commande utilisée par l'opération et du droit approprié sur les requêtes QM sur lesquelles l'opération est à effectuer.

Paramètres

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

Requête QM (QMQRY)

Indique le nom et la bibliothèque de la requête QM qui doit s'afficher à l'écran Gestion des requêtes QM. Vous pouvez indiquer un nom spécifique ou générique, et, en option, préciser le nom de la bibliothèque.

Ce paramètre est obligatoire.

Les valeurs possibles sont les suivantes :

*ALL: Toutes les requêtes QM des bibliothèques indiquées s'affichent sur l'écran Gestion des requêtes QM.
nom-requête-générique*: Indiquez un nom générique de requête QM, c'est-à-dire une chaîne constituée d'un ou de plusieurs caractères suivis d'un astérisque (*). Toutes les requêtes QM dont le nom commence par la chaîne de caractères indiquée seront affichées. Si un nom générique est spécifié, toutes les requêtes QM dont le préfixe est le même que celui du nom de la requête QM s'affichent.
nom-requête: Indiquez le nom de la requête QM à afficher.

Qualificateur 2: Biblio

*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 porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

*USRLIBL: S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*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.

*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Exemples

WRKQMQRY   QMQRY(QGPL/DSP*)

Cette commande affiche la liste des requêtes QM de la bibliothèque QGPL commençant par les lettres 'DSP'.

Messages d'erreur

Messages *ESCAPE

CPF9809: Accès à la bibliothèque &1 impossible.