Change DLO Primary Group (CHGDLOPGP)

The Change Document Library Object Primary Group (CHGDLOPGP) command transfers documents or folders from one primary group to another primary group. The second group profile becomes the primary group. The new primary group must be in the system distribution directory. The authorities that other users have to the document or folder are not changed.

The old primary group's authority to the object is revoked unless *NO is specified for the Revoke old authority (RVKOLDAUT) parameter.

Note: The system does not determine document or folder primary group by checking a group profile if one is specified in the user profile.

Restrictions:

To transfer the primary group of a document or folder, the user must have all object (*ALLOBJ) special authority or be the owner of the document or folder. The user must have delete authority (*DLT) to the old primary group profile and add (*ADD) authority to the new primary group profile.

Parameters

Keyword	Description	Choices	Notes
DLO	Document library object, or	Character value, SYSOBJNAM, ALL	Optional, Positional 1
CURPGP	Current primary group	Name	Optional, Positional 2
NEWPGP	New primary group	Name, *NONE	Optional
NEWPGPAUT	New primary group authority	OLDPGP, PRIVATE, ALL, CHANGE, USE, EXCLUDE	Optional
FLR	Folder	Character value, *NONE	Optional
RVKOLDAUT	Revoke old authority	YES, NO	Optional
SYSOBJNAM	System object name	Name	Optional

Top

Document library object, or (DLO)

Specifies the name of the document or folder object that is assigned to a new primary group. The DLO parameter and the Current primary group (CURPGP) parameter are mutually exclusive.

*SYSOBJNAM: The object is identified using the system object name. Object name is specified by the System object name (SYSOBJNAM) parameter.
*ALL: The objects specified by FLR have their primary group changed. The folder, its contents, as well as the contents of all of its subfolders, will have their primary group changed.
If *ALL is specified, a value must be specified on the Folder (FLR) parameter.
name: Specify the name of the document or folder assigned by the user. A maximum of 12 characters can be specified.

Current primary group (CURPGP)

Specifies the primary group profile name of the current primary group from whom all documents or folders are transferred. All documents or folders assigned to this primary group are assigned a new primary group. The CURPGP parameter and the Document library object, or (DLO) parameter are mutually exclusive.

New primary group (NEWPGP)

Specifies the primary group profile name of the new primary group to which the documents or folders are being transferred. The group profile must already exist and have a group ID number (gid) assigned to it.

*NONE: The object does not have a primary group.
name: Specify the new primary group name.

New primary group authority (NEWPGPAUT)

Specifies what authority the new primary group has to the object.

*OLDPGP: The new primary group has whatever authority the old primary group had to the object.
*PRIVATE: The new primary group has the same private authority to the object. If the old primary group did not have a private authority to the object, the new primary group has no authority to the object.
*ALL: The new primary group is given all (*ALL) authority to the object.
*CHANGE: The new primary group is given change (*CHANGE) authority to the object.
*USE: The new primary group is given use (*USE) authority to the object.
*EXCLUDE: The new primary group is given exclude (*EXCLUDE) authority to the object.

Folder (FLR)

Specifies the name of the folder that contains the document.

*NONE: No folder name is specified.
name: Specify the user-assigned name of the folder. The folder name can consist of a series of folder names if the object specified in the DLO parameter is located in a folder that is contained in another folder. A maximum of 63 characters can be specified.

Revoke old authority (RVKOLDAUT)

Specifies whether the current primary group's authority is revoked when the primary group is transferred to the new primary group specified on the NEWPGP parameter.

*YES: The current primary group's authority is revoked when the object is transferred to the new primary group.
*NO: The authority for the current primary group is not revoked when the primary group is changed to the new primary group.

System object name (SYSOBJNAM)

Specifies the system object name of the document or folder. This parameter is valid only when DLO(*SYSOBJNAM) is specified. A full ten characters must be specified.

Examples

Example 1: Transferring Folder Primary Group

CHGDLOPGP   DLO(MYFLR)  NEWPGP(GROUP1)

This command assigns primary group of folder MYFLR to a new primary group named GROUP1. The authority is revoked from the current primary group.

Example 2: Transferring Primary Group of All Documents and Folders

CHGDLOPGP   CURPGP(GROUP1)  NEWPGP(GROUP2)

This command assigns a new primary group for all documents and folders assigned to primary group GROUP1 to the new primary group GROUP2. The authority is revoked from current primary group.