CHGOBJPGP

Modifier groupe princ d'objet

En bref

La commande CHGOBJPGP (Modifier le groupe principal d'un objet) permet de modifier l'utilisateur constituant le groupe principal de l'objet.

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

Syntaxe minimale

CHGOBJPGP OBJ(…) OBJTYPE(…) NEWPGP(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
ASPDEV Unité ASP
NEWPGP Nouveau groupe principal obligatoire
PGPAUT Droits nouveau groupe princ
RVKOLDAUT Révoquer les anciens droits

Astuce : dans une session 5250, tapez CHGOBJPGP 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 CHGOBJPGP (Modifier le groupe principal d'un objet) permet de modifier l'utilisateur constituant le groupe principal de l'objet. Les droits privés du propriétaire et des autres utilisateurs de l'objet ne sont pas modifiés.

Un utilisateur disposant de droits sur la fonction d'administrateur de la sécurité de la base de données de l'IBM i (QIBM_DB_SECADM) est autorisé à modifier le groupe principal d'un objet dans le système de fichiers QSYS.lib.

Restrictions :

Pour modifier le groupe principal, vous devez disposer :
- du droit d'existence sur l'objet (*OBJEXIST) ;
- des droits d'opération (*OBJOPR) et d'existence sur l'objet (*OBJEXIST) dans le cas d'une description de fichier, de bibliothèque ou de sous-système ;
- du droit spécial (*ALLOBJ) sur tous les objets ou de la propriété de l'objet dans le cas d'une liste d'autorisation ;
- du droit de gestion de l'objet (*OBJMGT) si vous souhaitez révoquer les droits de l'ancien groupe principal ;
- du droit de gestion de l'objet (*OBJMGT) et des droits accordés si une valeur autre que *PRIVATE est indiquée au paramètre PGPAUT ;
- des droits (*USE) sur l'unité ASP (pool de mémoire secondaire), si une telle unité est indiquée.
Le type d'objet *DOC ou *FLR ne peut pas être indiqué. L'utilisateur doit avoir recours au support des documents et des dossiers (DLO).
L'utilisateur du nouveau groupe principal ne peut pas être propriétaire de l'objet.
L'utilisateur du nouveau groupe principal doit disposer d'un numéro d'ID groupe (gid).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OBJTYPE	Type d'objet	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRG, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DTAARA, DTADCT, DTAQ, EDTD, FCT, FILE, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IMGCLG, IPXD, JOBD, JOBQ, JRN, JRNRCV, LIB, LIND, LOCALE, M36, M36CFG, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, NODGRP, NODL, NTBD, NWID, NWSCFG, NWSD, ORTBL, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, RCT, S36, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SQLXSR, SRVPGM, SSND, SVRSTG, TBL, TIMZON, USRIDX, USRPRF, USRQ, USRSPC, VLDL, WSCST	Obligatoire, positionnel 2
ASPDEV	Unité ASP	Nom, , SYSBAS	Facultatif
NEWPGP	Nouveau groupe principal	Nom, *NONE	Obligatoire, positionnel 3
PGPAUT	Droits nouveau groupe princ	OLDPGP, PRIVATE, ALL, CHANGE, USE, EXCLUDE	Facultatif
RVKOLDAUT	Révoquer les anciens droits	YES, NO	Facultatif

Objet (OBJ)

Indique le nom de l'objet dont le groupe principal doit être modifié.

Ce paramètre est obligatoire.

Remarque :Vous pouvez indiquer le nom de bibliothèque pour vous assurer que c'est le bon objet qui change de groupe principal.

nom: Indiquez le nom de l'objet dont le groupe principal doit devenir un autre utilisateur.

Qualificateur 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: La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Type d'objet (OBJTYPE)

Indique le type de l'objet dont le groupe principal doit être modifié. Pour plus d'informations, reportez-vous à la description du paramètre OBJTYPE dans la rubrique "Commonly used parameters: Expanded descriptions" du manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

type-objet: Indiquez le type de l'objet à modifier.

Unité ASP (ASPDEV)

Indiquez le nom d'unité de pool de mémoire secondaire (ASP) où la bibliothèque contenant l'objet (paramètre OBJ) est située. Si la bibliothèque de l'objet réside dans un ASP ne faisant pas partie de l'espace de nom de la bibliothèque, associé au travail, ce paramètre doit être précisé pour s'assurer que l'objet correct est utilisé comme cible pour l'exécution de cette commande.

*: L'objet est recherché dans les ASP faisant actuellement partie de l'espace de nom de la bibliothèque du travail. Ceci inclut l'ASP système (ASP numéro 1), tous les ASP utilisateurs de base définis (ASP numéros 2 à 32) et, si le travail est associé à un groupe d'ASP, tous les ASP indépendants du groupe ASP.
*SYSBAS: L'objet est recherché dans l'ASP système et dans tous les ASP utilisateur. La recherche ne porte sur aucun ASP indépendant, même si le travail est associé à un groupe d'ASP.
nom: Indiquez le nom de l'unité de l'ASP indépendant dans lequel l'objet est recherché. Cet ASP doit avoir été activé (en mettant en fonction l'unité ASP) et avoir l'état DISPONIBLE. La recherche ne s'effectue pas sur l'ASP système et sur les ASP utilisateur de base.

Nouveau groupe principal (NEWPGP)

Indique le nom de l'utilisateur devant constituer le nouveau groupe principal pour l'objet. Le profil utilisateur correspondant doit déjà exister lors de l'exécution de cette commande et posséder un identificateur de groupe (gid).

Ce paramètre est obligatoire.

*NONE: L'objet n'a pas de groupe principal.
nom: Indiquez le nom du profil utilisateur devant constituer le nouveau groupe principal pour l'objet.

Droits nouveau groupe princ (PGPAUT)

Indique quels droits le nouveau groupe principal a sur l'objet.

*OLDPGP: Le nouveau groupe principal dispose des mêmes droits sur l'objet que l'ancien groupe principal.
*PRIVATE: Le nouveau groupe principal dispose des mêmes droits privés sur l'objet qu'auparavant. Si le nouveau groupe principal ne possède pas de droits privés sur l'objet, il devient le groupe principal, mais sans droit sur l'objet.
*ALL: L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou contrôlées par les droits de gestion de la liste d'autorisation. L'utilisateur a un droit d'existence sur l'objet et il peut également modifier le droit de propriété de cet objet.
*CHANGE: Le droit de modification de l'objet est accordé au nouveau groupe principal.
*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 modifier l'objet. Les droits *USE comprennent les droits d'opération, de lecture et d'exécution sur l'objet.
*EXCLUDE: L'utilisateur n'a pas accès à l'objet.

Révoquer les anciens droits (RVKOLDAUT)

Indique si les droits du groupe principal en cours sont révoqués lorsque le groupe principal devient l'utilisateur précisé au paramètre Nouveau groupe principal (NEWPGP).

*YES: Les droits du groupe principal en cours sont révoqués.
*NO: Les droits du groupe principal en cours deviennent des droits privés.

Exemples

CHGOBJPGP   OBJ(USERLIB/PROGRAM1)  OBJTYPE(*PGM)  NEWPGP(ANN)
            PGPAUT(*CHANGE)

Cette commande change le groupe principal du programme PROGRAM1, situé dans la bibliothèque USERLIB, pour l'attribuer au groupe appelé ANN. Le nouveau groupe principal dispose du droit *CHANGE sur l'objet. Le droit du groupe principal en cours est révoqué.

Messages d'erreur

Messages *ESCAPE

CPF22BE: Fonction non exécutée pour le profil utilisateur &1.
CPF22DA: Opération non admise sur le fichier &1 de &2.
CPF220B: Le nouveau groupe principal &1 n'a pas de numéro d'ID groupe.
CPF220C: Le propriétaire et le groupe principal ne peuvent être identiques.
CPF220D: Groupe principal peut-être non modifié pour objet &1 de &3, type &2.
CPF2204: Profil utilisateur &1 non trouvé.
CPF2207: Non autorisé à utiliser objet &1 de &3 type *&2.
CPF2208: Objet &1 de la bibliothèque &3 type *&2 non trouvé.
CPF2209: Bibliothèque &1 introuvable.
CPF221D: Groupe principal peut-être non modifié pour objet &1 de &3, type *&2.
CPF2210: Opération non admise pour objet de type *&1.
CPF2211: Impossible d'allouer l'objet &1 de &3, type *&2.
CPF2213: Impossible d'allouer le profil utilisateur &1.
CPF2216: Non autorisé à utiliser la bibliothèque &1.
CPF2217: Non autorisé au profil utilisateur &1.
CPF2222: Limite mémoire dépassée pour le profil utilisateur &1.
CPF2226: Fonction non exécutée pour le profil utilisateur &1.
CPF2230: Non autorisé à l'objet &1 de la bibliothèque &3.
CPF2232: Non autorisé au profil utilisateur &1.
CPF2233: Pas de droit de suppression sur le profil utilisateur &1.
CPF4ACF: Echec de l'opération pour l'objet &1 dans &2 type *&3 en raison d'erreurs de réplication.