clearinghouse delete

clearinghouse delete clearinghouse_name_list

Description
The clearinghouse delete operation deletes the specified clearinghouse from the local server system. The clearinghouse_name_list argument is a list of one or more names of the clearinghouses you want to delete. Clearinghouses that contain master replicas of directories are not deleted (and also return errors). This command also automatically deletes all read-only replicas from the clearinghouse; however, you should delete all read-only replicas by hand (see directory delete -replica) before invoking this command because invoking many skulks causes the command to execute slower. The command returns an empty string on success.

CDS does not permit you to delete a disabled (cleared) clearinghouse. Before you can delete a disabled (cleared) clearinghouse, you must recreate it using the clearinghouse create command.

Privileges Required
You must have w (write) and d (delete) permission to the clearinghouse and A (Admin) permission to all directories that store replicas in the clearinghouse. The server principal needs d (delete) permission to the associated clearinghouse object entry and A (Admin) permission to all directories that store replicas in the clearinghouse.

Examples
The following command deletes a clearinghouse named /.:/Orion_CH from the local server system:

dcecp> clearinghouse delete /.:/Orion_CH
dcecp>