domain delete

Deletes a domain, excluding the management domain. Optionally deletes the user and group information of the domain, from the user registry. To perform this command, we must log in to the management domain as an administrator.

Requires authentication (administrator ID and password) to use.

This command applies to LDAP registries only.

domain delete domain [-registry]

A domain can be deleted within the management domain only by an administrator with the appropriate privileges.

Options

-registry

The information of the domain, including user and group data, be deleted from the user registry. (Optional) If this option is not selected, user and group data for the specified domain:

• Remains in the registry.
• Can be used again if the domain is re-created.

domain

Name of the domain to be deleted. The domain must exist, or an error is displayed.

Return codes

0

The command completed successfully.

1

The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format (for example, 0x14c012f2). See "Error messages" in the IBM Knowledge Center. This reference provides a list of the ISAM error messages by decimal or hexadecimal codes.

Examples

• The following example deletes a domain named Marketing:

  pdadmin sec_master> domain delete Marketing 

The following example deletes a domain named Finance and removes any user and group information in the user registry:

pdadmin sec_master> domain delete Finance -registry

See also

domain create
domain list
domain modify
domain show

Parent topic: pdadmin commands