CRTOVL
Créer un fond de page
En bref
La commande CRTOVL (Créer un fond de page) permet de créer une ressource fond de page à partir d'un fichier physique.
CRTOVL se lit CRT
(Créer) + OVL.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTOVL OVL(…) FILE(…)
Paramètres
-
OVLFond de page obligatoire -
FILEFichier obligatoire -
MBRMembre -
DATATYPEType de données -
TEXTTexte 'descriptif' -
REPLACERemplacer fond de page -
AUTDroits
Astuce : dans une session 5250, tapez CRTOVL 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 CRTOVL (Créer un fond de page) permet de créer une ressource fond de page à partir d'un fichier physique. Celui-ci contient les informations relatives à la ressource fond de page. Ces informations peuvent, par exemple, provenir d'un système hôte IBM 370 et être au format SAA.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| OVL | Fond de page | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Fond 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, *OVL | Facultatif, positionnel 3 |
| DATATYPE | Type de données | *AFPDS, *AFPU | Facultatif |
| TEXT | Texte 'descriptif' | Valeur caractère, *MBRTXT, *BLANK | Facultatif |
| REPLACE | Remplacer fond de page | *YES, *NO | Facultatif |
| AUT | Droits | Nom, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE | Facultatif |
Fond de page (OVL)
Fond de page en cours de création.
Ce paramètre est obligatoire.
Qualificatif 1 : Fond de page
- nom
- Indiquez le nom du fond de page.
Qualificatif 2 : Biblio
- *CURLIB
- Le fond de page est placé 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 dans laquelle vous souhaitez placer le fond de page.
Fichier source (FILE)
Fichier contenant les enregistrements de fond de page envoyés au 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 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.
Membre de fichier source (MBR)
Nom du membre contenant les enregistrements du fond de page.
- *OVL
- Le nom du membre de fichier est indiqué au paramètre OVL (Fond de page de cette commande.
- nom
- Indiquez le nom du membre du fichier spécifié au paramètre FILE (Fichier source).
Type de données (DATATYPE)
Type de source du fichier en entrée.
- *AFPDS
- Le fichier en entrée est un fichier base de données contenant un flot AFPDS constitué au préalable.
- *AFPU
- Le fichier en entrée est un fichier source créé à l'aide des Utilitaire d'impression des fonctions avancées IBM.
Remarque :Cette valeur n'est possible que si les Utilitaires AFP/400 sont installés sur votre système.
Texte 'descriptif' (TEXT)
Texte décrivant brièvement l'objet.
- *MBRTXT
- Le texte provient du membre de fichier utilisé pour créer la ressource fond de page. Vous pouvez ajouter ou modifier le texte d'un membre source base de données à l'aide de la commande STRSEU (Démarrer SEU), ADDPFM (Ajouter un membre à un fichier physique) ou CHGPFM (Modifier un membre de fichier physique). Si le fichier est un fichier en entrée ou un fichier unité, le texte est à blanc.
- *BLANK
- Aucun texte n'est précisé.
- valeur-alphanumérique
- Indiquez, entre apostrophes, un texte de 50 caractères au maximum.
Remplacer fond de page (REPLACE)
Indique, dans le cas où un fond de page de même nom que celui en cours de création existe déjà, s'il doit être remplacé.
- *YES
- Le fond de page est remplacé.
- *NO
- Si un fond de page de même nom existe déjà sur le système, l'opération de création échoue. Le fond de page n'est pas remplacé.
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
CRTOVL OVL(MYLIB/MYSIGNTR)
FILE(MYLIB/MYSIGNTR) MBR(MYSIGNTR)
AUT(*EXCLUDE) TEXT('Représentation de ma signature')
Cette commande permet de créer le fond de page MYSIGNTR dans MYLIB. Le fichier MYSIGNTR (bibliothèque MYLIB), qui comporte le membre MYSIGNTR, est utilisé comme entrée. Si vous indiquez *EXCLUDE, aucun autre utilisateur ne peut accéder à la signature. Le texte décrit le fond 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.
- CPF88C2
- Valeur *AFPU du paramètre DATATYPE incorrecte pour la commande &1.
- 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.
- CPF9822
- Non autorisé au fichier &1 de &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.