Edit DLO Authority (EDTDLOAUT)

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

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:

Restrictions:

  1. A user must have all (*ALL) authority to the document or folder or all object (*ALLOBJ) special authority to change the authority.
  2. 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.
  3. The user must have *ALLOBJ special authority to change the *ROOT folder public authority.
Top

Parameters

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
Top

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