CRTPNLGRP
Créer un groupe de panneaux
En bref
La commande CRTPNLGRP crée des groupes de panneaux d'aide en ligne qui peuvent être affichés avec les écrans DDS (Spécifications de description de données), les commandes CL ou l'aide par index.
CRTPNLGRP se lit CRT
(Créer) + PNLGRP.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTPNLGRP PNLGRP(…)
Paramètres
-
PNLGRPGroupe de panneaux obligatoire -
SRCFILEFichier source -
SRCMBRMembre source -
TEXTTexte 'descriptif' -
OPTIONOptions pour liste source -
INCFILEInclure fichier -
CHRIDIdentificateur de caractères -
AUTDroits -
REPLACERemplacer groupe de panneaux
Astuce : dans une session 5250, tapez CRTPNLGRP 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 CRTPNLGRP crée des groupes de panneaux d'aide en ligne qui peuvent être affichés avec les écrans DDS (Spécifications de description de données), les commandes CL ou l'aide par index.
Restrictions :
- Vous devez disposer des droits de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque où le groupe de panneaux doit être créé.
- Si le groupe de panneaux existe déjà, vous devez disposer des droits d'existence de l'objet (*OBJEXIST), de gestion de l'objet (*OBJMGT) et de lecture (*READ) sur le groupe de panneaux.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| PNLGRP | Groupe de panneaux | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Groupe de panneaux | Nom | ||
| Qualificatif 2: Biblio | Nom, *CURLIB | ||
| SRCFILE | Fichier source | Nom d'objet qualifié | Facultatif, positionnel 2 |
| Qualificatif 1: Fichier source | Nom, QPNLSRC | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| SRCMBR | Membre source | Nom, *PNLGRP | Facultatif, positionnel 3 |
| TEXT | Texte 'descriptif' | Valeur caractère, *SRCMBRTXT, *BLANK | Facultatif |
| OPTION | Options pour liste source | Values (jusqu'à 3 répétitions): *SOURCE, *NOSOURCE, *SRC, *NOSRC, *NOSECLVL, *SECLVL, *NOEVENTF, *EVENTF | Facultatif, positionnel 4 |
| INCFILE | Inclure fichier | Valeurs uniques: *SRCFILE Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: Inclure fichier | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| CHRID | Identificateur de caractères | Valeurs uniques: *DEVD, *SYSVAL, *JOBCCSID, *CHRIDCTL Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Jeu de caractères graphiques | Entier | ||
| Élément 2: Page de codes | Entier | ||
| AUT | Droits | Nom, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE | Facultatif |
| REPLACE | Remplacer groupe de panneaux | *YES, *NO | Facultatif |
Groupe de panneaux (PNLGRP)
Indique le groupe de panneaux à créer.
Ce paramètre est obligatoire.
Qualificatif 1 : Groupe de panneaux
- nom
- Indiquez le nom du groupe de panneaux à créer.
Qualificatif 2 : Biblio
- *CURLIB
- Le groupe de panneaux est placé dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant le groupe de panneaux.
Fichier source (SRCFILE)
Indique le fichier source contenant les instructions source de description du groupe de panneaux. La longueur des enregistrements du fichier source doit être comprise entre 13 et 92.
Qualificatif 1 : Fichier source
- QPNLSRC
- Le fichier source QPNLSRC contient les instructions source de description du groupe de panneaux.
- nom
- Indiquez le nom du fichier source qui contient les instructions source de description du groupe de panneaux.
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 fichier source est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant le fichier source.
Membre source (SRCMBR)
Indique le membre du fichier source qui contient la description du groupe de panneaux.
- *PNLGRP
- Le nom du membre contenant la description du groupe de panneaux est identique à celui indiqué pour le paramètre PNLGRP (Groupe de panneaux).
- nom
- Indiquez le nom du membre qui contient la description du groupe de panneaux.
Texte 'descriptif' (TEXT)
Indique le texte qui décrit brièvement le groupe de panneaux.
- *SRCMBRTXT
- Le texte associé au membre du fichier source indique est utilisé.
- *BLANK
- Aucun texte n'est utilisé.
- valeur-alphanumérique
- Indiquez, entre apostrophes, un texte de 50 caractères au maximum.
Options pour liste source (OPTION)
Indique les options utilisées pour la sortie générée lors de la compilation. Vous pouvez indiquer plusieurs valeurs dans l'ordre de votre choix. Si aucune valeur ou les deux valeurs de chaque groupe sont indiquées, la valeur soulignée est utilisée.
Remarque :Les valeurs soulignées de ce paramètre sont identiques aux valeurs par défaut mais elles ne sont pas réellement les valeurs par défaut. Elles ne peuvent donc pas être modifiées à l'aide de la commande CHGCMDDFT.
Option pour la liste source
- *SRC ou *SOURCE
- Une liste source est produite.
- *NOSRC ou *NOSOURCE
- Aucune liste source n'est produite, sauf si des erreurs sont détectées.
Option pour les messages de deuxième niveau
- *NOSECLVL
- Le message de deuxième niveau n'est pas fourni avec le message de premier niveau lorsque les messages sont imprimés en fin de liste.
- *SECLVL
- Le message de deuxième niveau est fourni avec le message de premier niveau lorsque les messages sont imprimés en fin de liste.
Option de création d'un fichier événements
- *NOEVENTF
- Le compilateur ne crée pas de fichier événements pour le produit Environnement développement coopératif (CODE).
- *EVENTF
- Le compilateur crée un fichier événements qui peut être utilisé par le produit CODE. Le fichier événements est créé comme membre du fichier EVFEVENT dans votre bibliothèque d'objets. Le produit CODE utilise ce fichier pour proposer un suivi d'erreurs intégré à l'éditeur CODE. Cette valeur est généralement indiquée par le produit CODE pour votre compte.
Inclure fichier (INCFILE)
Indique le fichier source contenant les membres à inclure.
Remarque :Si l'ID codé de jeu de caractères (CCSID) du fichier source est différent de celui du fichier source primaire indiqué dans le paramètre SRCFILE (Fichier source), le premier est remplacé par le second. Tous les membres source utilisés pour créer l'objet doivent avoir le même CCSID.
Valeurs uniques
- *SRCFILE
- Le fichier d'inclusion correspond au fichier indiqué pour le paramètre SRCFILE.
Qualificatif 1 : Inclure fichier
- nom
- Indiquez le nom du fichier source contenant les membres à inclure.
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 fichier source est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant le fichier source.
Identificateur de caractères (CHRID)
Indique si l'identificateur de caractères (jeu de caractères graphiques et page de codes) des variables de dialogue et du groupe de panneaux est remplacé lorsque le groupe de panneaux s'affiche.
Valeurs uniques
- *DEVD
- Aucune modification. L'identificateur de caractères des variables de dialogue et du groupe de panneaux est identique à celui de l'unité.
- *SYSVAL
- L'identificateur de caractères des variables de dialogue est remplacé par la valeur système QCHRID par défaut de l'unité. L'identificateur de caractères du groupe de panneaux est le même que celui de l'unité.
- *JOBCCSID
- L'identificateur de caractères des variables de dialogue, qui avait pour valeur le CCSID du travail, est remplacé par l'identificateur de caractères de l'unité. L'identificateur de caractères du groupe de panneaux, qui avait pour valeur le CCSID du fichier source désigné dans le paramètre SRCFILE, est remplacé par l'identificateur de caractères de l'unité.
- *CHRIDCTL
- Le système vérifie l'attribut de travail CHRIDCTL afin de déterminer la valeur spéciale (*JOBCCSID ou *DEVD) à indiquer au paramètre CHRID de ce groupe de panneaux.
Elément 1 : Jeu de caractères graphiques
- entier
- Indiquez le jeu de caractères graphique à utiliser. Les valeurs correctes sont comprises entre 1 et 32767.
Elément 2 : Page de codes
- entier
- Indiquez la page de codes à utiliser. Les valeurs correctes sont comprises entre 1 et 32767.
Remarque :Une conversion peut se révéler nécessaire selon l'identificateur de caractères du poste de travail ou de l'imprimante.
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.
Replace (REPLACE)
Indique le remplacement éventuel d'un groupe de panneaux du même nom dans la bibliothèque mentionnée.
Remarque :Le groupe de panneaux ne peut pas être remplacé s'il est en cours d'utilisation par ce travail ou un autre.
- *YES
- Le groupe de panneaux existant est remplacé et transféré dans la bibliothèque système QRPLOBJ.
- *NO
- Le groupe de panneaux existant n'est pas remplacé. Si ce groupe de panneaux existe, la création n'aboutit pas.
Exemples
CRTPNLGRP PNLGRP(PAYLIB/PAYROLL)
SRCFILE(QPNLSRC) OPTION(*SECLVL)
Cette commande crée un groupe de panneaux appelé PAYROLL dans la bibliothèque PAYLIB, utilise le fichier source QPNLSRC dans la liste de bibliothèques et imprime le texte des messages de second niveau dans la liste.
Messages d'erreur
Messages *ESCAPE
- CPF5A02
- Le groupe de panneaux &1 n'a pas été créé dans la bibliothèque &2. Panel group &1 not created in library &2.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.