Display DLO Authority (DSPDLOAUT)

The Display Document Library Object Authority (DSPDLOAUT) command allows you to view (only) the list of authorized users of an object and their assigned authorities.

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 primary group (if there is one)
• The name of the authorization list securing the document or folder (if there is one)
• Personal status of the document or folder
• 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 user group has no authority for the document or folder

Restrictions:

• A user must have at least use (*USE) authority for the document or folder to display authority information about the document or folder.
• If the user has all (*ALL) authority to the object, or all object (*ALLOBJ) special authority, the user sees all authority information.

Parameters

Document library object (DLO)

Specifies the name of the document or folder to be displayed.

*SYSOBJNAM

The system object name specified on the System object name (SYSOBJNAM) parameter is displayed.

*ROOT

The public authority value of the *ROOT folder is displayed.

name

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

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

name

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.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*

The output is displayed at the requesting work station if requested by an interactive job. If this is not an interactive job, the output is printed with the job's spooled output.

*PRINT

The output is printed with the job's spooled output.

System object name (SYSOBJNAM)

Specifies the system object name of the folder or document.

name

Specify the system object name for the folder or document displayed. Ten characters must be specified.

Examples

DSPDLOAUT   DLO(DOCA)  FLR(MYFLR)  OUTPUT(*PRINT)

This command prints for DOCA in folder MYFLR a list of all authorized users and their authorities if the user of this command has *ALL authority to DOCA in folder MYFLR. This command prints only the user's authorities if the user of this command has *USE authority. Access codes are also shown.

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.

CPF9009

System requires file &1 in &2 be journaled.

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.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9850

Override of printer file &1 not allowed.

CPF9851

Overflow value for file &1 in &2 too small.