Aller au contenu

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

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.