Edit DLO Authority (EDTDLOAUT)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No

The Edit Document Library Object Authority (EDTDLOAUT) command is used to change user authorization to a document or folder object.

The following information is displayed for the specified document or folder:

The name of the document or folder
The owner of the document or folder
The name of the authorization list securing the document or folder (if there is one)
Personal status of the document or folder
A list of specific users authorized for the document or folder
The authority given to the users with no specific authority (*PUBLIC), who are not on the authorization list, and whose group has no authority for the document or folder

Restrictions:

A user must have all (*ALL) authority to the document or folder or all object (*ALLOBJ) special authority to change the authority.
You must have authority to use the Add DLO Authority (ADDDLOAUT), Change DLO Authority (CHGDLOAUT) , and the Remove DLO Authority (RMVDLOAUT) commands to use this command.
The user must have *ALLOBJ special authority to change the *ROOT folder public authority.

Top

Keyword	Description	Choices	Notes
DLO	Document library object	Character value, SYSOBJNAM, ROOT	Required, Positional 1
FLR	Folder	Character value, *NONE	Optional
SYSOBJNAM	System object name	Name	Optional

Document library object (DLO)

Specifies the name of the document or folder for which user authority is being changed.

*SYSOBJNAM: User authority is being changed for the document or folder with the system object name specified on the System object name (SYSOBJNAM) parameter.
*ROOT: The public authority value of the *ROOT folder is changed.
character: Specify the user-assigned name of the document or folder for which user authority is being changed. A maximum of 12 characters can be specified.

Top

Folder (FLR)

Specifies the folder where the object specified for the Document library object (DLO) parameter is located.

*NONE: A folder name is not specified. If a name is specified on the DLO parameter, and the object is located in a folder, *NONE cannot be specified.
character: Specify the name of the folder that contains the object. The name can consist of a series of folder names if the folder containing the object is located in another folder. A maximum of 63 characters can be specified.

Top

System object name (SYSOBJNAM)

Specifies the system object name of the folder or document. This parameter is valid only when *SYSOBJNAM is specified on the Document library object (DLO) parameter.

name: Specify the system object name for the folder or document for which user authority is being changed. You must specify 10 characters.

Top

Examples

EDTDLOAUT   DLO(DOCA)  FLR(MYFLR)

This command allows the user of this command to change the list of authorized users and their authorities to the document library object named DOCA in folder MYFLR. The user of this command must have *ALL authority to the object or be the owner of the object.

Top

Error messages

*ESCAPE Messages

CPF8A77: Folder &1 not found.
CPF8A78: Folder &1 in use.
CPF8A79: Folder &1 is logically damaged.
CPF8A80: Document &2 in use in folder &1.
CPF8A82: Document &2 not found in folder &1.
CPF8A88: Operation not allowed on document &2 in folder &1.
CPF8A89: Document &2 in folder &1 is logically damaged.
CPF89C0: You have specified an incorrect value.
CPF90BA: Authority request for document library object failed.
CPF90B6: You have specified an incorrect input value.
CPF9073: No authority to view or change the security of document library object &1.
CPF9079: Request to get document description not successful for user profile &1.
CPF908A: Requester &1 not enrolled.
CPF908B: Document library object not found.
CPF909A: Document &2 in folder &1 is damaged.
CPF9095: Folder &1 is damaged.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.

Top