PreviousNext

directory add

Creates a child pointer in the parent directory. The syntax is:

directory add directory_name_list -member child_pointer_list
-clearinghouse clearinghouse_name

Options

-member child_pointer_list
This required option names the child pointers to be added to parent directories in the clearinghouse named by the required -clearinghouse option.

-clearinghouse clearinghouse_name
This required option names the clearinghouse where the child pointers are to be added.

Description
The directory add operation creates a child pointer in the parent directory. The directory_name_list argument is a list of one or more names of parent directories to have child pointers added to them. The value of the required -member option is a list of names of child pointers to be added to each of the directories listed in the argument. Each child pointer name entered should contain only the last RDN (relative distinguished name) of the name. The child object must exist or the command returns an error. The full name of a clearinghouse that holds a replica of the child directory is given as the value to the required -clearinghouse option. This option may only have one value and is used for each of the values of the -member option. Returns an empty string on success. If a child pointer of the same name already exists an error is returned.

This command is only needed to recreate a child pointer that was accidentally deleted, such as in a troubleshooting situation. Normally child pointers are created internally by CDS when creating directories with the directory create command.

Privileges Required
You must have i (insert) permission to the parent directory.

Examples

dcecp> directory add /.: -member foo -clearinghouse /.:/darkstr_ch
dcecp>