Delete Document List (DLTDOCL)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Delete Document List (DLTDOCL) command allows you to delete a document list from the system. All document lists are stored in library QUSRSYS.

Restrictions:

To delete a document list, you must have object existence (*OBJEXIST) authority for the document list, all object (*ALLOBJ) special authority, or security administrator (*SECADM) special authority.
To delete a document list for another user, you must have *ALLOBJ or *SECADM special authority.

Top

Parameters

Keyword	Description	Choices	Notes
DOCL	Document list	Single values: *ALL Other values (up to 300 repetitions): Name	Required, Positional 1
OWNER	Document list owner	Element list	Optional, Positional 2
OWNER	Element 1: User profile	Name, CURRENT, ALL	Optional, Positional 2

Top

Document list (DOCL)

Specifies the document lists that are to be deleted from the system.

*ALL: All document list objects for the specified owner are deleted.
name: Specify the name of the document list object that is to be deleted. A maximum of 300 document list objects can be specified.

Top

Document list owner (OWNER)

Specifies the owner of the document lists that are to be deleted. This parameter is ignored if a list of document list names is specified on the Document list (DOCL) parameter.

*CURRENT: All document lists owned by you are to be deleted.
*ALL: All document lists for all owners are deleted.
name: Specify the name of the user who owns the document lists that are to be deleted. All document lists owned by this user are deleted.

Top

Examples

Example 1: Deleting Current User's Document Lists

DLTDOCL   DOCL(*ALL)  OWNER(*CURRENT)

This command deletes all document lists owned by the current user.

Example 2: Deleting All Users' Document Lists

DLTDOCL   DOCL(*ALL)  OWNER(*ALL)

This command deletes all document lists owned by all users.

Example 3: Deleting Document Lists Owned By a Specified User

DLTDOCL   DOCL(*ALL)  OWNER(ANN)

This command deletes all document lists owned by ANN.

Example 4: Deleting a Specific Document List Owned By User

DLTDOCL   DOCL(AN8T475237)

This command deletes document list AN8T475237, owned by the user running this command. Displaying the user's owned objects will show the system object name for a specific document list.

Top

Error messages

*ESCAPE Messages

CPF9002: Not allowed to delete specified document lists.
CPF9009: System requires file &1 in &2 be journaled.
CPF9012: Start of document interchange session not successful for &1.
CPF9032: Document interchange session not started.
CPF9051: &1 document lists deleted; &2 document lists not deleted.
CPF9810: Library &1 not found.
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