CHGLIB

Modifier une bibliothèque

En bref

La commande CHGLIB (Modifier une bibliothèque) permet de modifier l'attribut de type, le texte descriptif, la valeur par défaut des droits pour objets créés ou la valeur d'audit d'objet par défaut d'une bibliothèque.

CHGLIB se lit CHG (Modifier) + LIB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGLIB LIB(…)

Paramètres

LIB Bibliothèque obligatoire
TYPE Type de bibliothèque
TEXT Texte 'descriptif'
CRTAUT Droits pour objets créés
CRTOBJAUD Audit pour objets créés

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

Si la bibliothèque en cours de modification est journalisée, des postes sont consignés dans le journal qui enregistre les modifications.

Utilisez la commande DSPLIBD (Afficher la description de la bibliothèque) pour afficher les informations journalisées sur la bibliothèque. Pour plus d'informations sur le lancement de la journalisation d'une bibliothèque, reportez-vous à la commande (STRJRNLIB) .

Remarque :Pour en savoir plus sur la journalisation, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Pour indiquer une valeur autre que *SAME pour le paramètre Audit pour objets créés (CRTOBJAUD), vous devez disposer du droit spécial d'audit (*AUDIT).
Pour modifier uniquement ce dernier paramètre, seul le droit spécial *AUDIT est requis. Pour modifier un autre paramètre, vous devez disposer du droit de gestion d'objet (*OBJMGT) sur la bibliothèque à modifier.

Remarque :Si vous n'indiquez pas au moins l'un des paramètres Type de bibliothèque (TYPE), Texte 'descriptif' (TEXT), Droits pour objets créés (CRTAUT) ou Audit pour objets créés (CRTOBJAUD), le message d'achèvement CPC2105 est envoyé pour indiquer que la bibliothèque n'a pas été modifiée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
LIB	Bibliothèque	Nom, *CURLIB	Obligatoire, clé, positionnel 1
TYPE	Type de bibliothèque	SAME, PROD, *TEST	Facultatif, positionnel 2
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
CRTAUT	Droits pour objets créés	Nom, SAME, SYSVAL, CHANGE, ALL, USE, EXCLUDE	Facultatif
CRTOBJAUD	Audit pour objets créés	SAME, SYSVAL, NONE, USRPRF, CHANGE, ALL	Facultatif

Bibliothèque (LIB)

Indique la bibliothèque à modifier.

Ce paramètre est obligatoire.

*CURLIB: La bibliothèque à modifier est la bibliothèque en cours de l'unité d'exécution en cours. Si la liste de bibliothèques de l'unité d'exécution en cours ne contient aucune bibliothèque en cours, la bibliothèque QGPL est modifiée.
nom: Indiquez le nom de la bibliothèque à modifier.

Type de bibliothèque (TYPE)

Indique le nouveau type de la bibliothèque.

*SAME: L'attribut TYPE de la bibliothèque reste inchangé.
*PROD: Il s'agit d'une bibliothèque de production. Les fichiers base de données des bibliothèques de production ne peuvent pas être ouverts en mise à jour si l'utilisateur est en mode débogage et s'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 des bibliothèques de test sont mis à jour lors 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)

Texte décrivant brièvement l'objet.

*SAME: Le texte, le cas échéant, reste inchangé.
*BLANK: Le texte est mis à blanc.
'descriptif': Entrez, entre apostrophes, un texte de 50 caractères au maximum.

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.

*SAME: La valeur par défaut des droits publics n'est pas modifiée.
*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-liste-autorisation: 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.

*SAME: La valeur reste inchangée.
*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 enregistrement 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 pour 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

CHGLIB   LIB(LIB1)  TYPE(*TEST)  TEXT('NOUVEAU TEXTE POUR LIB1')

Cette commande permet de modifier la valeur de l'attribut TYPE de la bibliothèque LIB1 en *TEST et de remplacer le texte descriptif par la valeur indiquée dans le paramètre TEXT.

Messages d'erreur

Messages *ESCAPE

CPF21A0: *AUDIT requis pour la création ou la modification de bibliothèques.
CPF210C: Bibliothèque &1 non modifiée.
CPF2150: Erreur dans la fonction d'informations sur objet.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF2283: La liste d'autorisation &1 n'existe pas.
CPF7003: Poste non journalisé dans &1. Code raison &3.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9830: Allocation de la bibliothèque &1 impossible.