Aller au contenu

CRTPAGSEG

Créer un segment de page

En bref

La commande CRTPAGSEG permet de créer un segment de page en copiant un fichier base de données utilisateur dans un objet interne.

CRTPAGSEG se lit CRT (Créer) + PAGSEG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CRTPAGSEG PAGSEG(…) FILE(…)

Paramètres

  • PAGSEG Segment de page obligatoire
  • FILE Fichier obligatoire
  • MBR Membre
  • TEXT Texte 'descriptif'
  • REPLACE Remplacer segment de page
  • AUT Droits

Astuce : dans une session 5250, tapez CRTPAGSEG 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 CRTPAGSEG permet de créer un segment de page en copiant un fichier base de données utilisateur dans un objet interne. L'utilisateur doit charger la ressource segment de page 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 la convertir en format SAA en vue de son traitement par le système d'exploitation.

Paramètres

Mot-clé Description Valeurs possibles Remarques
PAGSEG Segment de page Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Segment 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, *PAGSEG Facultatif, positionnel 3
TEXT Texte 'descriptif' Valeur caractère, *MBRTXT, *BLANK Facultatif
REPLACE Remplacer segment de page *YES, *NO Facultatif
AUT Droits Nom, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE Facultatif

Segment de page (PAGSEG)

Segment de page en cours de création.

Ce paramètre est obligatoire.

Qualificatif 1 : Segment de page

nom
Indiquez le nom du segment de page.

Qualificatif 2 : Biblio

*CURLIB
Le segment de page 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 bibliothèque dans laquelle sera recherché le segment de page.

Fichier source (FILE)

Fichier contenant les enregistrements de segment 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)

Membre de fichier contenant les enregistrements de segment de page.

*PAGSEG
Le nom du membre de fichier est indiqué au paramètre PAGSEG (Segment de page).
nom
Indiquez le nom du membre du fichier spécifié au paramètre FILE (Fichier source).

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*MBRTXT
Le texte provient du membre de fichier utilisé pour créer le segment 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 segment de page (REPLACE)

Indique, dans le cas où un segment de page de même nom que celui en cours de création existe déjà, s'il doit être remplacé.

*YES
Le segment de page est remplacé.
*NO
Si un segment de page de même nom existe déjà sur le système, l'opération de création échoue. Le segment 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

CRTPAGSEG   PAGSEG(MYLIB/PAGSEG1)  FILE(*LIBL/PAGSGMTS)
            MBR(*PAGSEG)
            AUT(*ALL)  TEXT('Paragraphe 1 type')

Cette commande permet de créer le segment de page PAGSEG1 dans MYLIB et utilise le membre PAGSGMTS PAGSEG1 comme entrée dans la commande. Si vous indiquez *ALL au paramètre AUT, tous les utilisateurs peuvent exécuter quasiment toutes les commandes relatives à l'objet. Le texte fournit une description de l'objet.

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.
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.