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.

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

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.