RTVQMFORM

Extraire un format QM

En bref

La commande RTVQMFORM (Extraire un format QM) permet d'extraire d'un objet QMFORM (format QM) des enregistrements source de format codés.

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

Syntaxe minimale

RTVQMFORM QMFORM(…) SRCFILE(…)

Paramètres

QMFORM Format de rapport QM obligatoire
SRCFILE Fichier source obligatoire
SRCMBR Membre source
ALWQRYDFN Admettre infos de QRYDFN

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

Le source de format peut également être extrait d'un objet QRYDFN (définition d'analyse) lorsque l'objet QMFORM indiqué n'existe pas.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
QMFORM	Format de rapport QM	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Format de rapport 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, *QMFORM	Facultatif, positionnel 3
ALWQRYDFN	Admettre infos de QRYDFN	NO, YES, *ONLY	Facultatif

Format de rapport QM (QMFORM)

Indique l'objet format QM dont le source est extrait.

Ce paramètre est obligatoire.

Qualificatif 1 : Format de rapport QM

nom: Indiquez le nom du format à extraire.

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 format est recherché dans la bibliothèque en cours pour le 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éé dans lequel vont être placés les enregistrements source de format codés.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier source

nom: Indiquez le nom du fichier source devant contenir le format source.

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 de fichier physique source dans lequel vont être placés les enregistrements source de format codés. Si aucun nom de membre n'est précisé, c'est le nom indiqué au paramètre QMFORM qui est pris en compte.

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 instructions source. Si le membre n'existait pas, il est créé lors de l'exécution de la commande.

*QMFORM: Le nom du membre est identique au nom de format indiqué au paramètre QMFORM.
nom: Indiquez le nom du membre dans lequel sera placé le source du format.

Admettre infos de QRYDFN (ALWQRYDFN)

Indique si des informations sur le format sont extraites d'un objet QRYDFN (définition d'analyse) lorsque aucun objet QMFORM (format 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 codée du formulaire

RTVQMFORM   QMFORM(RPTLIB/SALFORM)  SRCFILE(FORMS)
            SRCMBR(EMPFORM)

Cette commande extrait la source codée du formulaire du formulaire appelé SALFORM, situé dans la bibliothèque RPTLIB. Les enregistrements de la source codée du formulaire qui ont été extraits sont placés dans un nouveau membre ou dans un membre mis à blanc, appelé EMPFORM, dans le premier fichier appelé FORMS de la liste de bibliothèques utilisateur.

Exemple 2 : Extraction de la source depuis QMFORM ou QRYDFN

RTVQMFORM   QMFORM(RPTLIB/SALFORM)  SRCFILE(FORMS)
            SRCMBR(EMPFORM)  ALWQRYDFN(*YES)

Cette commande extrait la source codée du formulaire de gestion de requête (QMFORM) appelé SALFORM qui se trouve dans la bibliothèque RPTLIB. S'il n'existe pas d'objet QMFORM appelé SALFORM dans la bibliothèque RPTLIB, la source du formulaire est extraite de la définition de requête (QRYDFN) appelée SALFORM dans la bibliothèque RPTLIB. Les enregistrements de la source codée du formulaire qui sont extraits sont placés dans le premier fichier appelé FORMS de 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.