object delete

Deletes a protected object.

Requires authentication (administrator ID and password) to use.

object delete {-recursive}object_name

Options

-recursive

Specifies that a recursive delete is performed. This means that all objects under the specified object name are deleted.

object_name

Protected object to be deleted, which is the fully qualified name of the object, including the object space in which it is located. The object must exist, or an error is displayed.

Examples of object names are:

• /Management/Groups/Travel
• /WebSEAL
• /Management

-recursive

Specifies that a recursive delete is performed. This means that all objects under the specified object name are deleted.

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 the object named /Management/test-object:

  pdadmin sec_master> object delete /Management/test-object

The following example deletes the object named /Management/Groups/Travel:

pdadmin sec_master> object delete /Management/Groups/Travel

See also

object exists
object create

Parent topic: pdadmin commands