CHGOBJOWN

Modifier propriétaire d'objet

En bref

La commande CHGOBJOWN (Modifier le propriétaire d'un objet) permet de transférer la propriété d'un objet.

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

Syntaxe minimale

CHGOBJOWN OBJ(…) OBJTYPE(…) NEWOWN(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
ASPDEV Unité ASP
NEWOWN Nom du nouveau propriétaire obligatoire
CUROWNAUT Droits du propriétaire actuel

Astuce : dans une session 5250, tapez CHGOBJOWN 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 CHGOBJOWN (Modifier le propriétaire d'un objet) permet de transférer la propriété d'un objet. Les droits des autres utilisateurs sur l'objet restent inchangés.

Le propriétaire d'un objet dispose toujours de tous les droits applicables à l'objet sauf s'ils sont explicitement révoqués. Le propriétaire est autorisé à accorder aux autres utilisateurs n'importe quel droit sur l'objet qu'il possède. Les propriétaires peuvent également accorder à eux-mêmes des droits précédemment révoqués. Ils peuvent, par exemple, supprimer certains des droits dont ils disposent à titre de précaution et, le cas échéant, accorder de nouveau les mêmes droits à eux-mêmes.

Un utilisateur disposant des droits spéciaux *ALLOBJ est autorisé à transférer la propriété d'un objet dans le système de fichiers QSYS.lib.

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é à transférer la propriété d'un objet dans le système de fichiers QSYS.lib. Toutefois, les utilisateurs disposant de droits sur la fonction QIBM_DB_SECADM ne peuvent pas transférer la propriété vers eux-mêmes sauf s'ils possèdent les autorisations nécessaires pour cette opération.

Tous les utilisateurs possèdent les droits d'ajout et de suppression sur leur propre profil utilisateur ; en d'autres termes, ils peuvent ajouter ou supprimer des objets (qu'ils ont créés) dans leur profil utilisateur en modifiant leur propriétaire.

Restrictions :

Pour transférer la propriété d'un objet, tout utilisateur (y compris le propriétaire en cours de l'objet) doit disposer :
- des droits d'existence sur l'objet (*OBJEXIST) (sauf dans le cas d'une liste d'autorisation) ;
- 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 ;
- des droits spéciaux sur tous les objets (*ALLOBJ), à moins que l'utilisateur ne soit le propriétaire de l'objet, dans le cas d'une liste d'autorisation ;
- des droits d'ajout (*ADD) sur le profil utilisateur du nouveau propriétaire ;
- des droits de suppression (*DLT) sur le profil utilisateur du propriétaire en cours ;
- du droit spécial sur tous les objets (*ALLOBJ) et du droit spécial d'administrateur de la sécurité (*SECADM) pour modifier le propriétaire d'un programme ou d'un module SQL adoptant les droits de son propriétaire ;
- des droits (*USE) sur l'unité ASP (pool de mémoire secondaire), si une telle unité est indiquée.
Pour les claviers-écrans, si cette commande n'est pas exécutée à partir de l'unité associée à la propriété ou à la propriété de file d'attente de messages à modifier, vous devez d'abord lancer la commande ALCOBJ (Allouer un objet) suivie de la commande DLCOBJ (Désallouer un objet).
Le type d'objet *DOC ou *FLR ne peut pas être indiqué ; l'utilisateur doit recourir aux fonctions dossiers et documents.
Le transfert de la propriété d'un objet associé à un dépositaire de droits modifie également la propriété de ce dépositaire de droits.

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, IGCSRT, IMGCLG, IPXD, JOBD, JOBQ, JRN, JRNRCV, LIB, LIND, LOCALE, M36, M36CFG, MEDDFN, MENU, MGTCOL, MODD, MODULE, MSGF, MSGQ, NODGRP, NODL, NTBD, NWID, NWSCFG, NWSD, 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
NEWOWN	Nom du nouveau propriétaire	Nom	Obligatoire, positionnel 3
CUROWNAUT	Droits du propriétaire actuel	REVOKE, SAME	Facultatif

Objet (OBJ)

Indique l'objet à affecter à un nouveau propriétaire.

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 propriétaire.

Qualificatif 1 : Objet

nom: Indiquez le nom de l'objet dont le propriétaire doit être modifié.

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 propriétaire 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 dont le propriétaire doit être modifié.

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.

Nom du nouveau propriétaire (NEWOWN)

Indique le profil utilisateur du propriétaire de l'objet. Le profil utilisateur doit déjà exister lors de l'exécution de cette commande.

Ce paramètre est obligatoire.

nom: Indiquez le nom du profil utilisateur.

Droits du propriétaire actuel (CUROWNAUT)

Indique si les droits du propriétaire actuel sont révoqués lorsque l'objet est attribué à un autre utilisateur.

*REVOKE: Les droits du propriétaire actuel sont révoqués lorsque l'objet est attribué à un autre utilisateur.
*SAME: Les droits du propriétaire actuel sont retenus comme droits privés sur l'objet.

Exemples

CHGOBJOWN   OBJ(USERLIB/PROGRAM1)  OBJTYPE(*PGM)  NEWOWN(ANN)

Cette commande attribue la propriété du programme appelé PROGRAM1, situé dans la bibliothèque USERLIB, à l'utilisateur ANN. Le droit de l'utilisateur en cours est révoqué.

Messages d'erreur

Messages *ESCAPE

CPF0609: Non autorisé à utiliser le profil utilisateur indiqué.
CPF22BD: Propriétaire peut être non modifié pour objet &1 de &3 type *&2.
CPF22BE: Fonction non exécutée pour le profil utilisateur &1.
CPF22DA: Opération non admise sur le fichier &1 de &2.
CPF220A: Le nouveau propriétaire &1 n'a pas de numéro d'ID utilisateur.
CPF220C: Le propriétaire et le groupe principal ne peuvent être identiques.
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.
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.
CPF2231: Non autorisé à modifier la propriété du programme &1.
CPF2232: Non autorisé au profil utilisateur &1.
CPF2233: Pas de droit de suppression sur le profil utilisateur &1.
CPF2298: Droits non révoqués pour objet &2 dans &3 de l'utilisateur &1.
CPF4ACF: Echec de l'opération pour l'objet &1 dans &2 type *&3 en raison d'erreurs de réplication.
CPF4AC0: Le propriétaire ne peut pas être remplacé par &1 pour l'objet &2 de &3 type *&4.