RTVQMQRY

Extraire une requête QM

En bref

La commande RTVQMQRY (Extraire une requête QM) permet d'extraire un source SQL d'un objet QMQRY (requête QM).

RTVQMQRY se lit RTV (Extraire (récupérer)) + QMQRY. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVQMQRY QMQRY(…) SRCFILE(…)

Paramètres

QMQRY Requête QM obligatoire
SRCFILE Fichier source obligatoire
SRCMBR Membre source
ALWQRYDFN Admettre infos de QRYDFN

Astuce : dans une session 5250, tapez RTVQMQRY 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 RTVQMQRY (Extraire une requête QM) permet d'extraire un source SQL d'un objet QMQRY (requête QM). Les enregistrements source sont placés dans un membre de fichier source pouvant être édité.

Un source de requête peut également être extrait d'un objet QRYDFN (définition d'analyse) lorsque l'objet QMQRY indiqué n'existe pas.

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
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCFILE	Fichier source	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier source	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SRCMBR	Membre source	Nom, *QMQRY	Facultatif, positionnel 3
ALWQRYDFN	Admettre infos de QRYDFN	NO, YES, *ONLY	Facultatif

Requête QM (QMQRY)

Indique la requête QM dont le source est extrait.

Ce paramètre est obligatoire.

Qualificatif 1 : Requête QM

nom: Indiquez le nom de la requête dont le source est extrait.

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: Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Fichier source (SRCFILE)

Indique le fichier physique source précédemment créé et dans lequel les enregistrements source de requête vont être placés.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier source

nom: Indiquez le nom du fichier source devant contenir la requête source extraite.

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: Le système effectue la recherche dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre source (SRCMBR)

Indique le membre du fichier source dans lequel les enregistrements source de requête vont être placés. Si le membre existait avant l'exécution de la commande, toutes les données qu'il contient sont effacées avant l'insertion des enregistrements source. Si le membre n'existait pas, il est créé lors de l'exécution de la commande.

*QMQRY: Le nom du membre est identique au nom de requête indiqué au paramètre QMQRY.
nom: Indiquez le nom du membre dans lequel sera placé le source de la requête.

Admettre infos de QRYDFN (ALWQRYDFN)

Indique si des informations sur la requête sont extraites d'un objet QRYDFN (définition d'analyse) lorsque aucun objet QMQRY (requête QM) ne peut être localisé à l'aide du nom d'objet indiqué. Toutes les informations ainsi dérivées sont supprimées une fois la commande exécutée. Aucun objet QM n'est créé.

*NO: Aucune information n'est extraite d'un objet QRYDFN.
*YES: Les informations sont extraites d'un objet QRYDFN lorsque l'objet QMQRY indiqué n'est pas trouvé.
*ONLY: Les informations sont extraites uniquement d'un objet QRYDFN. Les objets QM sont ignorés.

Exemples

Exemple 1 : Extraction de la source SQL

RTVQMQRY   QMQRY(RPTLIB/SALQRY)  SRCFILE(QRYS)  SRCMBR(EMPQRY)

Cette commande extrait la source de la requête appelée SALQRY, située dans la bibliothèque RPTLIB. Les enregistrements source qui ont été extraits sont placés dans un nouveau membre ou dans un membre mis à blanc, appelé EMPQRY, du premier fichier appelé QRYS de la liste de bibliothèques utilisateur.

Exemple 2 : Extraction de la source à partir de QMQRY ou QRYDFN

RTVQMQRY   QMQRY(RPTLIB/SALQRY)  SRCFILE(QRYS)  SRCMBR(EMPQRY)
           ALWQRYDFN(*YES)

Cette commande extrait la source de la requête de gestion de requête (QMQRY) appelée SALQRY dans la bibliothèque RPTLIB. S'il n'existe pas d'objet QMQRY appelé SALQRY dans la bibliothèque RPTLIB, la source de la requête est alors extraite de la définition de requête (QRYDFN) appelée SALQRY dans la bibliothèque RPTLIB. Les enregistrements source sont placés dans le nouveau membre ou dans le membre mis à blanc EMPQRY du premier fichier appelé QRYS dans la liste de bibliothèques utilisateur.

Messages d'erreur

Messages *ESCAPE

QWM2701: La commande &1 a échoué.
QWM2703: La commande &1 a été interrompue.
QWM2705: Fichier source &1 de &2 non disponible.