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
-
QMFORMFormat de rapport QM obligatoire -
SRCFILEFichier source -
SRCMBRMembre source -
TEXTTexte 'descriptif' -
AUTDroits -
REPLACERemplacer objet
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.