Aller au contenu

CRTQMFORM

Créer un format QM

En bref

La commande CRTQMFORM permet de créer un format QM à partir d'un membre de fichier source donné.

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

Syntaxe minimale

CRTQMFORM QMFORM(…)

Paramètres

Astuce : dans une session 5250, tapez CRTQMFORM 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 CRTQMFORM permet de créer un format QM à partir d'un membre de fichier source donné. Ce format décrit la présentation des données (extraites à l'aide d'une requête) lors de l'affichage ou de l'impression d'un rapport.

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, *CURLIB
SRCFILE Fichier source Nom d'objet qualifié Facultatif, positionnel 2
Qualificatif 1: Fichier source Nom, QQMFORMSRC
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
SRCMBR Membre source Nom, *QMFORM Facultatif, positionnel 3
TEXT Texte 'descriptif' Valeur caractère, *SRCMBRTXT, *BLANK Facultatif
AUT Droits Nom, *USE, *CHANGE, *ALL, *EXCLUDE, *LIBCRTAUT Facultatif
REPLACE Remplacer objet *YES, *NO Facultatif

Format de rapport QM (QMFORM)

Indique le format QM à créer.

Ce paramètre est obligatoire.

Ce paramètre est obligatoire.

Qualificatif 1 : Format de rapport QM

nom
Indiquez le nom du format à créer.

Qualificatif 2 : Biblio

*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 devant contenir le format.

Fichier source (SRCFILE)

Indique le fichier source contenant le source du format créé. Ce dernier est identifié par le nom indiqué au paramètre QMFORM.

Qualificatif 1 : Fichier source

QQMFORMSRC
Le fichier source IBM QQMFORMSRC contient la source du format à créer.
nom
Indiquez le nom du fichier contenant le source du format à créer.

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 source contenant le source du format à créer.

*QMFORM
Le nom du membre est identique au nom de format indiqué au paramètre QMFORM.
nom
Indiquez le nom du membre contenant la source du format.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement le format QM.

*SRCMBRTXT
Le texte descriptif associé à l'objet en cours de création est le même que celui du membre source. Si aucun texte descriptif n'a été indiqué pour le membre source ou s'il s'agit de blancs, c'est le commentaire éventuellement contenu dans le format exporté qui est pris en compte ; en l'absence de commentaire, la valeur *BLANK est prise par défaut.
*BLANK
Aucun texte n'est indiqué. Lorsque l'exécution d'une commande entraîne le remplacement d'un objet, le texte descriptif associé à cet objet est remplacé par des blancs.
valeur-alphanumérique
Indiquez, entre apostrophes, un texte de 50 caractères au maximum. Les apostrophes ne sont pas comprises dans la chaîne de 50 caractères.

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.

Remplacer objet (REPLACE)

Indique si l'objet généré par la commande va remplacer un objet de même nom et de même type existant dans la bibliothèque utilisée pour la création.

*YES
L'objet existant sera remplacé par l'objet généré par la commande.
*NO
L'objet existant ne sera pas remplacé par l'objet généré par la commande.

Exemples

CRTQMFORM   QMFORM(FORMEMP)  SRCFILE(RPTLIB/FORMSRC)

Cette commande permet de créer un formulaire appelé FORMEMP dans la bibliothèque en cours. La source du formulaire est dans le membre FORMEMP, qui se trouve dans le fichier source FORMSRC de la bibliothèque RPTLIB.

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.
QWM2706
&1 de &2 non remplacé.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.