The Change Document Library Object Owner (CHGDLOOWN) command allows you to transfer document or folder ownership from one user to another user. The first owner no longer owns the object and the second user becomes the owner. The new owner must be enrolled in the system distribution directory. The authorities of other users to the document or folder do not change.

Restrictions:

To transfer ownership of a document or folder, all object (*ALLOBJ) special authority is required or the requester must be the owner of the document or folder.

Parameters

Keyword	Description	Choices	Notes
DLO	Document library object, or	Character value, *SYSOBJNAM	Optional, Positional 1
OWNER	Current owner	Element list	Optional, Positional 2
	Element 1: User profile	Name
NEWOWN	New owner	Element list	Optional
	Element 1: User profile	Name
FLR	Folder	Character value, *NONE	Optional
CUROWNAUT	Current owner authority	*REVOKE, *SAME	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 owner. When the Current owner (OWNER) parameter is specified, the DLO parameter cannot be specified.

name

Specify the name of the document or folder assigned by the user. A maximum of 12 characters can be specified.

*SYSOBJNAM

The object is identified using the system object name. The object name is specified on the System object name (SYSOBJNAM) parameter. If *SYSOBJNAM is specified, then FLR(*NONE) must also be specified.

Current owner (OWNER)

Specifies the user profile name of the current owner from whom all documents or folders are transferred. All documents or folders owned by this user are assigned a new owner. When the Document library object, or (DLO) parameter is specified, the Current owner (OWNER) parameter cannot be specified.

name

Specify the name of the user profile by which the current owner is known on the system.

New owner (NEWOWN)

Specifies the user profile of the new owner to whom the documents or folders are transferred.

name

Specify the name of the user profile by which the new owner is known on the system.

Folder (FLR)

Specifies the name of the folder where objects identified on the Document library object, or (DLO) parameter are located.

*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 is located in a folder that is contained in another folder. A maximum of 63 characters can be specified.

Current owner authority (CUROWNAUT)

Specifies whether the authorities for the current owner are revoked when ownership is changed.

*REVOKE

The authority of the current owner is revoked when the object is changed to the new owner.

*SAME

The authority of the current owner is not changed when the object is changed to the new owner.

System object name (SYSOBJNAM)

Specifies the system object name of the document or folder. This parameter is ignored if an object name is specified on the Document library object, or (DLO) parameter.

name

Specify the system object name of the document or folder using the entire 10 characters.

Examples

Example 1: Transferring Folder Ownership

CHGDLOOWN   DLO(MYFLR)  NEWOWN(ANN)

This command assigns ownership of folder MYFLR to a new owner named ANN. The authority is revoked from the current owner.

Example 2: Transferring Ownership of All Documents and Folders

CHGDLOOWN   OWNER(ANDERSON)  NEWOWN(SMITH)

This command assigns ownership of all documents and folders owned by ANDERSON to the new owner SMITH. The authority is revoked from the current owner.

Error messages

*ESCAPE Messages

CPF2204

User profile &1 not found.

CPF2232

Not authorized to user profile &1.

CPF2233

No delete authority to user profile &1.

CPF8A49

New owner &1 does not have a uid.

CPF8360

Not enough storage for commitment control operation.

CPF897E

Name &1 already exists for document list owned by &2 &3.

CPF9005

System resource required to complete this request not available.

CPF9006

User not enrolled in system distribution directory.

CPF9009

System requires file &1 in &2 be journaled.

CPF9012

Start of document interchange session not successful for &1.

CPF9029

Not allowed to specify owner profile &1.

CPF9032

Document interchange session not started.

CPF9048

Ownership of &2 document library objects changed to profile &1; &3 not changed.

CPF908A

Requester &1 not enrolled.