CRTPAGDFN
Créer une définition de page
En bref
La commande CRTPAGDFN (Créer une définition de page) permet de créer une définition de page en copiant un fichier base de données utilisateur dans un objet interne.
CRTPAGDFN se lit CRT
(Créer) + PAGDFN.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTPAGDFN PAGDFN(…) FILE(…)
Paramètres
-
PAGDFNDéfinition de page obligatoire -
FILEFichier obligatoire -
MBRMembre -
TEXTTexte 'descriptif' -
REPLACERemplacer définition de page -
AUTDroits
Astuce : dans une session 5250, tapez CRTPAGDFN 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 CRTPAGDFN (Créer une définition de page) permet de créer une définition de page en copiant un fichier base de données utilisateur dans un objet interne. L'utilisateur doit charger les données source dans la base de données à partir d'un système éloigné (tel qu'un IBM 370) ou d'un support externe (une bande, par exemple), et les convertir en format SAA en vue de leur traitement par le système d'exploitation.
Restrictions : Si connectez des fichiers spoule à un IBM 370, le nom de définition de page doit commencer par 'P1'.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| PAGDFN | Définition de page | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Définition de page | Nom | ||
| Qualificatif 2: Biblio | Nom, *CURLIB | ||
| FILE | Fichier | Nom d'objet qualifié | Obligatoire, positionnel 2 |
| Qualificatif 1: Fichier | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| MBR | Membre | Nom, *PAGDFN | Facultatif, positionnel 3 |
| TEXT | Texte 'descriptif' | Valeur caractère, *MBRTXT, *BLANK | Facultatif |
| REPLACE | Remplacer définition de page | *YES, *NO | Facultatif |
| AUT | Droits | Nom, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE | Facultatif |
Définition de page (PAGDFN)
Indique la définition de page à créer.
Ce paramètre est obligatoire.
Qualificatif 1 : Définition de page
- nom
- Indiquez le nom de la définition de page (8 caractères maximum).
Qualificatif 2 : Biblio
- *CURLIB
- La définition de page est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant la définition de page.
Fichier (FILE)
Fichier de données contenant les enregistrements de la définition de page envoyés sur ce système.
Ce paramètre est obligatoire.
Qualificatif 1 : Fichier
- nom
- Indiquez le nom du fichier à utiliser.
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 de données est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant le fichier de données.
Membre (MBR)
Membre de fichier de données contenant les enregistrements de la définition d'imprimé.
- *PAGDFN
- Le nom du membre du fichier de données est le même que celui indiqué au paramètre PAGDFN (Définition de page) de cette commande.
- nom
- Indiquez le nom du membre du fichier de données.
Texte 'descriptif' (TEXT)
Texte décrivant brièvement l'objet.
- *MBRTXT
- Le texte provient du membre de fichier utilisé pour créer la définition de page.
- *BLANK
- Aucun texte n'est précisé.
- valeur-alphanumérique
- Indiquez, entre apostrophes, un texte de 50 caractères au maximum.
Remplacer définition de page (REPLACE)
Indique, dans le cas où une définition de page de même nom que celle en cours de création existe déjà, si elle doit être remplacée.
- *YES
- La définition de page est remplacée.
- *NO
- Si une définition de page de même nom existe déjà sur le système, l'opération de création échoue. La définition de page n'est pas remplacée.
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 en utilisant la valeur indiquée au paramètre CRTAUT (Droits pour objets créés) de la commande CRTLIB, pour la bibliothèque qui contiendra l'objet à créer. Si la valeur spécifiée au paramètre CRTAUT (Droits pour objets créés) est modifiée, la nouvelle valeur n'affectera 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. Les droits sur l'objet définis dans la liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.
Exemples
CRTPAGDFN PAGDFN(*CURLIB/P1DFLT) FILE(*CURLIB/PAGDFNS)
MBR(*PAGDFN) AUT(*EXCLUDE)
TEXT('Définition de page par défaut')
Cette commande permet de créer la définition de page P1DFLT dans la bibliothèque en cours ou, si cette dernière n'est pas indiquée, dans QGPL. L'entrée provient du fichier source PAGDFNS qui comporte le membre P1DFLT, dans la bibliothèque en cours. Si vous indiquez *EXCLUDE au paramètre AUT, l'utilisation de l'objet est limitée à son propriétaire. Le texte décrit la définition de page.
Messages d'erreur
Messages *ESCAPE
- CPF2283
- La liste d'autorisation &1 n'existe pas.
- CPF8056
- &1 de &2 n'est pas un fichier physique.
- CPF88C1
- Ressource imprimante &2 de type &1 non créée dans &3.
- CPF9822
- Non autorisé au fichier &1 de &2.
- CPF9809
- Accès à la bibliothèque &1 impossible.
- CPF9810
- Bibliothèque &1 non trouvée.
- CPF9812
- Fichier &1 non trouvé dans la bibliothèque &2.
- CPF9845
- Erreur lors de l'ouverture du fichier &1.
- CPF9846
- Erreur lors du traitement du fichier &1 de &2.
- CPF9847
- Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
- CPF9870
- L'objet &2 de type *&5 existe déjà dans la bibliothèque &3.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.