directory create

directory create directory_name_list [-attribute attribute_list [-single]]
[[-replica ] -clearinghouse clearinghouse_name]

Options

-attribute attribute_list
Allows you to specify the CDS_Convergence attribute or the CDS_UpgradeTo attribute in an attribute list. The format is:

-attribute {{attr value} {attr value}}

See the Attributes topic of this reference page for a descriptions of the CDS_Convergence attribute and the CDS_UpgradeTo attribute.

-single
Valid only with the -attribute option, this specifies that attribute values are single-valued. Otherwise, attributes are multivalued.

-replica
This option specifies that the directory created is a replica of an existing directory. If you use the -replica option, you must specify a clearinghouse using the -clearinghouse option.

-clearinghouse clearinghouse_name
Required with the -replica option and optional when -replica option is not present, the -clearinghouse option names the clearinghouse where the child pointers are to be added.

Description
The directory create operation creates a new directory of the specified name. The directory_name_list argument is a list of names of directories to be created.

An optional -attribute option specifies a list of attributes to be included in each created directory. The attribute values are multivalued unless the -single option is specified, in which case all attributes are single-valued. The -single option is valid only if the -attribute option is specified.

The -clearinghouse option specifies one clearinghouse to create all the directories in. The value of this option is not a list, it is only one clearinghouse name to create all the directories named in the argument in. If this option is not specified, the new directories are created in the same clearinghouse as the parent directory. The directory create command also takes a -replica option which indicates that a directory replica is created; when this option is used, the -clearinghouse option is required. Returns an empty string on success.

Privileges Required
You must have the following permissions in order to create a directory:

· r (read) and i (insert) permission to the parent directory;

· w (write) permission to the clearinghouse in which the master replica of the new directory is to be stored.

In addition, the server principal (hosts/hostname/cds-server) must have r (read) and i (insert) permission to the parent directory.

Examples
The following command creates a directory named /.:/sales.

dcecp> directory create /.:/sales
dcecp>