CHGDLOPGP (Change Document Library Object Primary Group) Command Description

CHGDLOPGP Command syntax diagram

Purpose

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 RVKDLOAUT 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.

Restriction: To transfer the primary group of a document or folder, the user must have *ALLOBJ authority or be the owner of the document or folder. The user must have delete authority to the old primary group profile and add authority to the new primary group profile.

Required Parameters

DLO

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

*SYSOBJNAM: The object is identified using the system object name. Object name is specified by the SYSOBJNAM parameter.

*ALL: The primary group is changed for all objects in the specified folder. If *ALL is specified, a value must be specified on the Folder prompt (FLR parameter).

document-library-object-name: Specify the name of the document or folder assigned by the user. Up to 12 characters can be specified.

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 DLO parameter are mutually exclusive.

Optional Parameters

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 number) assigned to it.

*NONE: The object does not have a primary group.

primary-group-profile-name: Specify the new primary group profile name.

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 authority to the object.

*CHANGE: The new primary group is given *CHANGE authority to the object.

*USE: The new primary group is given *USE authority to the object.

*EXCLUDE: The new primary group is given *EXCLUDE authority to the object.

FLR

Specifies the name of the folder that contains the document.

*NONE: No folder name is specified.

folder-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.

SYSOBJNAM

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

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.

Examples for CHGDLOPGP

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.

Error messages for CHGDLOPGP

*ESCAPE Messages

None.