CHGDLOPGP

Modifier groupe principal DLO

En bref

La commande CHGDLOPGP (Modifier groupe principal DLO) transfère les documents ou les dossiers d'un groupe principal dans un autre.

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

Syntaxe minimale

CHGDLOPGP

Paramètres

DLO Document ou dossier, ou
CURPGP Groupe principal en cours
NEWPGP Nouveau groupe principal
NEWPGPAUT Droits nouveau groupe princ
FLR Dossier
RVKOLDAUT Révoquer les anciens droits
SYSOBJNAM Nom d'objet système

Astuce : dans une session 5250, tapez CHGDLOPGP 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 CHGDLOPGP (Modifier groupe principal DLO) transfère les documents ou les dossiers d'un groupe principal dans un autre. Le profil du deuxième groupe devient le groupe principal. Le nouveau groupe principal doit être dans le répertoire de distribution du système. Les droits dont disposent d'autres utilisateurs sur ce document ou ce dossier ne sont pas modifiés.

Le droit détenu par le groupe principal antérieur sur l'objet est révoqué sauf si *NO est indiqué pour le paramètre Révoquer les anciens droits (RVKOLDAUT).

Remarque :Le système ne définit pas de groupe principal d'un document ou d'un dossier en vérifiant un profil de groupe si un groupe est déjà précisé dans le profil utilisateur.

Restrictions :

Pour transférer le groupe principal d'un document ou d'un dossier, l'utilisateur doit détenir le droit spécial sur tous les objets (*ALLOBJ) ou être propriétaire du document ou du dossier. Il doit disposer du droit de suppression (*DLT) sur le profil de l'ancien groupe principal et du droit d'ajout (*ADD) sur celui du nouveau groupe principal.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DLO	Document ou dossier, ou	Valeur caractère, SYSOBJNAM, ALL	Facultatif, positionnel 1
CURPGP	Groupe principal en cours	Nom	Facultatif, positionnel 2
NEWPGP	Nouveau groupe principal	Nom, *NONE	Facultatif
NEWPGPAUT	Droits nouveau groupe princ	OLDPGP, PRIVATE, ALL, CHANGE, USE, EXCLUDE	Facultatif
FLR	Dossier	Valeur caractère, *NONE	Facultatif
RVKOLDAUT	Révoquer les anciens droits	YES, NO	Facultatif
SYSOBJNAM	Nom d'objet système	Nom	Facultatif

Document ou dossier, ou (DLO)

Indique le nom de l'objet document ou dossier attribué à un nouveau groupe principal. Les paramètres DLO et Groupe principal en cours (CURPGP) sont incompatibles.

*SYSOBJNAM: L'objet est identifié à l'aide du nom d'objet système. Le nom d'objet est indiqué par le paramètre Nom d'objet système (SYSOBJNAM).
*ALL: Le groupe principal des objets désignés par FLR est modifié. Le groupe principal affecté au dossier, à son contenu et au contenu de tous les sous-dossiers associés est modifié.
Si *ALL est précisé, vous devez indiquer une valeur dans le paramètre Dossier (FLR).
nom: Indiquez le nom attribué au document ou dossier par un utilisateur. Vous pouvez entrer jusqu'à 12 caractères.

Groupe principal en cours (CURPGP)

Indique le nom du profil du groupe principal en cours duquel tous les documents ou dossiers sont transférés. Tous les documents ou dossiers attribués à ce groupe principal sont réattribués à un nouveau groupe principal. Les paramètres Document ou dossier, ou (DLO) et CURPGP sont incompatibles.

Nouveau groupe principal (NEWPGP)

Indique le nom de profil du nouveau groupe principal dans lequel les documents ou les dossiers sont transférés. Le profil de groupe doit déjà exister et disposer d'un numéro d'identification de groupe qui lui a été attribué.

*NONE: L'objet n'a pas de groupe principal.
nom: Indiquez le nom du nouveau groupe principal.

Droits nouveau groupe princ (NEWPGPAUT)

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. Si l'ancien groupe principal ne disposait pas de tels droits sur l'objet, le nouveau groupe n'en dispose pas non plus.
*ALL: Le droit *ALL sur l'objet est attribué au nouveau groupe principal.
*CHANGE: Le droit *CHANGE sur l'objet est attribué au nouveau groupe principal.
*USE: Le droit *USE sur l'objet est attribué au nouveau groupe principal.
*EXCLUDE: Le droit *EXCLUDE sur l'objet est attribué au nouveau groupe principal.

Dossier (FLR)

Indique le nom du dossier contenant le document.

*NONE: Aucun nom de dossier n'est indiqué.
nom: Indiquez le nom de dossier défini par l'utilisateur. Il comprend une série de noms de dossiers si l'objet indiqué au paramètre DLO se trouve dans un dossier contenant un autre dossier. Vous pouvez entrer jusqu'à 63 caractères.

Révoquer les anciens droits (RVKOLDAUT)

Indique si les droits du groupe principal en cours sont révoqués lorsque le groupe principal est transféré au nouveau groupe principal indiqué au paramètre NEWPGP.

*YES: Les droits du groupe principal en cours sont révoqués lorsque l'objet est transféré au nouveau groupe principal.
*NO: Les droits du groupe principal en cours ne sont pas révoqués lorsque l'objet est transféré au nouveau groupe principal.

Nom d'objet système (SYSOBJNAM)

Nom d'objet système du document ou dossier. Ce paramètre est correct uniquement si DLO (*SYSOBJNAM) est indiqué. Vous devez entrer 10 caractères.

Exemples

Exemple 1 : Transfert du groupe principal du dossier

CHGDLOPGP   DLO(MYFLR)  NEWPGP(GROUP1)

Cette commande affecte le groupe principal du dossier MYFLR à un nouveau groupe principal appelé GROUP1. Les droits associés au groupe principal en cours sont révoqués.

Exemple 2 : Transfert du groupe principal de tous les documents et dossiers

CHGDLOPGP   CURPGP(GROUP1)  NEWPGP(GROUP2)

Cette commande affecte le nouveau groupe principal GROUP2 à tous les documents et dossiers qui étaient associés au groupe principal GROUP1. Les droits associés au groupe principal en cours sont révoqués.

Messages d'erreur

Messages *ESCAPE

CPF2204: Profil utilisateur &1 non trouvé.
CPF89C1: Groupe principal de documents ou dossiers &2 remplacé par groupe principal &1 ; &3 inchangé.