CRTLIB

Créer une bibliothèque

En bref

La commande CRTLIB (Créer une bibliothèque) permet d'ajouter une nouvelle bibliothèque au système.

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

Syntaxe minimale

CRTLIB LIB(…)

Paramètres

LIB Bibliothèque obligatoire
TYPE Type de bibliothèque
TEXT Texte 'descriptif'
AUT Droits
ASP Numéro d'ASP
ASPDEV Unité ASP
CRTAUT Droits pour objets créés
CRTOBJAUD Audit pour objets créés

Astuce : dans une session 5250, tapez CRTLIB 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 : Oui

La commande CRTLIB (Créer une bibliothèque) permet d'ajouter une nouvelle bibliothèque au système. Celle-ci doit exister avant que des objets puissent y être placés. Une fois la bibliothèque créée, elle apparaît comme appartenant à la bibliothèque QSYS (système).

Restrictions :

Une bibliothèque du nom de QRCL ou QRPLOBJ est créée uniquement dans l'ASP système (ASP 1).
Une bibliothèque appelée QRCLxxxxx ou QRPLxxxxx peut uniquement être créée dans l'ASP dont le numéro correspond à 'xxxxx' (où 'xxxxx' désigne le numéro d'un ASP principal justifié à droite et complété à gauche par des zéros) ; par exemple, la bibliothèque QRPL00033 ne peut être créée que dans l'unité ASP correspondant à l'ASP numéro 33.
Lorsque la bibliothèque QSPLnnnn est créée dans un ASP principal ou secondaire, elle doit être créée dans l'ASP dont le numéro correspond à 'nnnn' (où 'nnnn' désigne le numéro d'un ASP principal ou secondaire justifié à droite et complété à gauche par des zéros).
Vous ne pouvez pas créer une bibliothèque appelée QSYSxxxxx, QSYS2xxxxx ou SYSIBxxxxx (où 'xxxxx' représente un nombre).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
LIB	Bibliothèque	Nom	Obligatoire, positionnel 1
TYPE	Type de bibliothèque	PROD, TEST	Facultatif, positionnel 2
TEXT	Texte 'descriptif'	Valeur caractère, *BLANK	Facultatif
AUT	Droits	Nom, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Facultatif
ASP	Numéro d'ASP	1-32, 1, *ASPDEV	Facultatif
ASPDEV	Unité ASP	Nom, ASP, ASPGRPPRI, *SYSTEM	Facultatif
CRTAUT	Droits pour objets créés	Nom, SYSVAL, CHANGE, ALL, USE, *EXCLUDE	Facultatif
CRTOBJAUD	Audit pour objets créés	SYSVAL, NONE, USRPRF, CHANGE, *ALL	Facultatif

Bibliothèque (LIB)

Indique la bibliothèque à créer.

Remarque :N'utilisez pas un nom commençant par la lettre Q. Le système considère que les bibliothèques dont le nom commence par cette lettre sont des bibliothèques système.

Ce paramètre est obligatoire.

nom: Indiquez le nom de la bibliothèque à créer.

Type de bibliothèque (TYPE)

Indique le type de bibliothèque à créer.

*PROD: Il s'agit d'une bibliothèque de production. Les fichiers base de données d'une bibliothèque de production ne peuvent être ouverts en mise à jour lorsque l'utilisateur est en mode débogage et qu'il a demandé la protection des bibliothèques de production. Avant de lancer un test, un utilisateur peut protéger l'ensemble des fichiers base de données des bibliothèques de production contre les mises à jour. Il lui suffit pour cela d'indiquer *NO pour le paramètre MàJ fichiers de production (UPDPROD) de la commande STRDBG (Démarrer le débogage). Cependant, cette protection n'empêche pas le programme de supprimer des fichiers base de données ou de modifier d'autres objets (zones de données, par exemple) de la bibliothèque.
*TEST: Il s'agit d'une bibliothèque de test. Tous les objets d'une bibliothèque de test peuvent être mis à jour au cours d'un test, même si les bibliothèques de production ont fait l'objet d'une demande de protection spéciale.

Texte 'descriptif' (TEXT)

Présente brièvement la description de la bibliothèque.

*BLANK: Le texte est mis à blanc.
'descriptif': Entrez, entre apostrophes, un texte de 50 caractères au maximum.

Droits (AUT)

Indique les droits publics par défaut correspondant à cette bibliothèque. Il s'agit des droits que vous accordez à un utilisateur qui ne dispose pas de droits spécifiques sur la bibliothèque, qui ne figure pas sur la liste d'autorisation de la bibliothèque et dont les profils de groupe ne détiennent pas de droits spécifiques sur la bibliothèque.

*LIBCRTAUT: Le droit sur la bibliothèque est le même que le droit de création pour la bibliothèque QSYS. Vous pouvez afficher le droit de création pour la bibliothèque QSYS à l'aide de la commande DSPLIBD. Si ce droit est modifié à l'aide de la commande CHGLIB, les nouveaux droits n'auront aucune incidence sur les bibliothèques existantes.
*CHANGE: Le droit de modification (*CHANGE) permet d'effectuer toutes les opérations sur la bibliothèque à l'exception de celles réservées au propriétaire ou gérées par le droit d'existence sur l'objet (*OBJEXIST) et le droit de gestion de l'objet (*OBJMGT). L'utilisateur peut modifier et effectuer des fonctions de base sur la bibliothèque. Le droit de modification *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données.
*ALL: Le droit *ALL permet d'effectuer toutes les opérations, sauf celles réservées au propriétaire ou qui requièrent le droit de gestion de liste d'autorisation (*AUTLMGT). L'utilisateur est autorisé à contrôler l'existence de la bibliothèque, indiquer la sécurité associée à cette dernière, modifier la bibliothèque et exécuter des fonctions de base sur celle-ci. L'utilisateur peut également modifier la propriété de la bibliothèque.
*USE: Vous pouvez recourir au droit d'utilisation (*USE) pour effectuer sur la bibliothèque des opérations élémentaires telles que le lancement d'un programme ou la lecture d'un fichier, mais vous ne pouvez pas modifier la bibliothèque. 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 ne peut pas accéder à la bibliothèque.
nom: Indiquez le nom d'une liste d'autorisation. Les droits sur la bibliothèque définis dans cette liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister lors de la création de la bibliothèque.

Numéro d'ASP (ASP)

Indique le numéro du pool de mémoire secondaire (ASP) système ou utilisateur de base contenant la mémoire attribuée à la bibliothèque. Tous les objets d'une bibliothèque se trouvant dans un ASP doivent résider dans le même ASP que celle-ci. Lorsqu'une valeur différente de *ASP est indiquée pour le paramètre Unité ASP (ASPDEV), *ASPDEV est la seule valeur admise pour le paramètre Numéro d'ASP (ASP), le cas échéant. De même, lorsqu'une valeur autre que *ASP est indiquée pour le paramètre ASPDEV, le paramètre ASP peut être omis et la valeur qui lui est associée par défaut est ignorée.

1: La mémoire allouée à la bibliothèque se trouve dans le pool de mémoire secondaire du système, ASP 1.
*ASPDEV: La mémoire allouée à la bibliothèque se trouve dans l'ASP principal ou secondaire indiqué pour le paramètre ASPDEV.
numéro: Indiquez une valeur comprise entre 1 et 32 correspondant au numéro de l'ASP système ou utilisateur de base.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP contenant la mémoire allouée à la bibliothèque. Lorsqu'une valeur différente de *ASPDEV est indiquée pour le paramètre Numéro d'ASP (ASP), ASPDEV(*ASP) est la seule valeur admise pour le paramètre Unité ASP (ASPDEV), le cas échéant. Les autres valeurs du paramètre ASPDEV sont admises si le paramètre ASP est omis. Dans ce cas, la valeur par défaut du paramètre ASP est ignorée.

*ASP: La mémoire allouée à la bibliothèque se trouve dans l'ASP système ou utilisateur de base indiqué pour le paramètre ASP.
*ASPGRPPRI: La mémoire allouée à la bibliothèque se trouve dans l'ASP principal du groupe d'ASP de l'unité d'exécution. Si aucun groupe d'ASP n'est associé à l'unité d'exécution, un message d'erreur est envoyé.
*SYSTEM: La mémoire allouée à la bibliothèque se trouve dans l'ASP système (ASP 1).
nom: Indiquez le nom d'un ASP principal ou secondaire. La mémoire allouée à la bibliothèque se trouve dans l'ASP principal ou secondaire. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'.
Remarque :Pour indiquer un nom d'ASP spécifique, vous devez disposer du droit d'utilisation (*USE) sur chaque ASP du groupe d'ASP.

Droits pour objets créés (CRTAUT)

Indique les droits publics par défaut pour un objet créé dans cette bibliothèque. Il s'agit des droits accordés à un utilisateur qui ne dispose pas de droits spécifiques sur l'objet, qui ne figure pas sur la liste d'autorisation de l'objet et dont les groupes n'ont pas de droits spécifiques sur l'objet.

Lors de la création d'un objet dans cette bibliothèque, le paramètre Droits (AUT) de la commande de création de l'objet détermine les droits publics sur l'objet. Si la valeur AUT de la commande de création d'objet est *LIBCRTAUT, la valeur CRTAUT est affectée au droit public sur cet objet pour la bibliothèque.

*SYSVAL: Le droit public par défaut est déterminé par la valeur du paramètre système QCRTAUT lors de la création d'un objet dans cette bibliothèque.

*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 de la liste d'autorisation protégeant l'objet.

Audit pour objets créés (CRTOBJAUD)

Précise la valeur d'audit des objets créés dans la bibliothèque indiquée.

Remarque :Pour indiquer une valeur autre que *SYSVAL pour ce paramètre, vous devez disposer du droit spécial d'audit (*AUDIT).

*SYSVAL: La valeur d'audit est déterminée par la valeur du paramètre système QCRTOBJAUD lors de la création d'un objet dans cette bibliothèque.
*NONE: L'utilisation ou la modification de cet objet n'entraîne pas l'envoi d'un poste d'audit au journal de sécurité.
*USRPRF: Le profil de l'utilisateur accédant à cet objet est utilisé afin de déterminer si un poste d'audit doit être envoyé au journal de sécurité pour cet accès. Le paramètre Valeur d'audit d'objet (OBJAUD) de la commande CHGUSRAUD permet d'activer l'audit d'un utilisateur spécifique.
*CHANGE: Tous les accès en modification à cet objet effectués par tous les utilisateurs entraînent l'envoi d'un poste d'audit au journal de sécurité.
*ALL: Tous les accès en modification ou en lecture à cet objet effectués par tous les utilisateurs entraînent l'envoi d'un poste d'audit au journal de sécurité.

Exemples

Exemple 1 : Création d'une bibliothèque de production

CRTLIB   LIB(MYLIB)  TEXT('Ma bibliothèque de production')

La bibliothèque MYLIB est ajoutée au système. Il s'agit d'une bibliothèque de production ; seul le propriétaire dispose de droits d'existence (*OBJEXIST) et de gestion (*OBJMGT) d'objets pour cette bibliothèque. Les droits des utilisateurs sur la bibliothèque MYLIB sont déterminés par le droit de création de la bibliothèque QSYS, dans la mesure où la valeur *LIBCRTAUT a été utilisée par défaut pour le paramètre AUT. Le texte, 'Ma bibliothèque de production', apparaît chaque fois que la description de la bibliothèque MYLIB est affichée.

Exemple 2 : Création d'une bibliothèque de test

CRTLIB   LIB(Z)  TYPE(*TEST)  AUT(*EXCLUDE)
         TEXT('Ceci est une bibliothèque de test')

La bibliothèque de test Z est ajoutée au système. Seul le propriétaire de Z peut l'utiliser car aucun autre utilisateur n'a reçu de droits. Le texte indiqué ('Ceci est une bibliothèque de test') apparaît chaque fois que la description de la bibliothèque Z est affichée.

Exemple 3 : Création d'une bibliothèque dans un pool de mémoire secondaire (ASP) indépendant

CRTLIB   LIB(INVENTORY) ASPDEV(SALES)
         TEXT('Bibliothèque d'inventaire de l'ASP SALES')

La bibliothèque INVENTORY s'ajoute au système dans un pool de mémoire secondaire (ASP) indépendant appelé SALES. L'ASP SALES doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. Il s'agit d'une bibliothèque de production ; seul le propriétaire dispose de droits d'existence (*OBJEXIST) et de gestion (*OBJMGT) d'objets pour cette bibliothèque. Les droits des utilisateurs sur la bibliothèque INVENTORY sont déterminés par le droit de création de la bibliothèque QSYS, dans la mesure où la valeur *LIBCRTAUT a été utilisée par défaut pour le paramètre AUT. Le texte, 'Bibliothèque d'inventaire de l'ASP SALES', apparaît chaque fois que la description de la bibliothèque INVENTORY est affichée.

Messages d'erreur

Messages *ESCAPE

CPFB8ED: La description d'unité &1 est incorrecte pour l'opération.
CPF21A0: *AUDIT requis pour la création ou la modification de bibliothèques.
CPF210E: Bibliothèque &1 non disponible pour le code raison &2.
CPF2111: La bibliothèque &1 existe déjà.
CPF2122: Limite mémoire dépassée pour le profil utilisateur &1.
CPF2138: Création de la bibliothèque &3 impossible.
CPF2166: Le nom de bibliothèque &1 n'est pas valide. Library name &1 not valid.
CPF2172: Valeur ASPDEV incorrecte avec la valeur indiquée pour ASP.
CPF218A: La bibliothèque &1 ne peut pas être créée dans l'ASP &2.
CPF218B: La bibliothèque &1 ne peut pas être créée dans ASPDEV &2.
CPF2197: La bibliothèque &1 ne peut être crée dans l'ASP utilisateur &2.
CPF2283: La liste d'autorisation &1 n'existe pas.
CPF7012: Pool de mémoire secondaire &4 non trouvé pour objet &1.
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &1.
CPF9833: *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.