create child(8cds)

Synopsis

cdscp create child child-name clearinghouse clearinghouse-name

Arguments

child-name
The full name of the child pointer.

clearinghouse clearinghouse-name
The full name of a clearinghouse that contains a replica of the child directory.

Description
The create child command creates a child pointer at the master replica of the parent directory. When CDS looks up a name in the namespace, it uses child pointers to locate directory replicas. Use the set cdscp preferred clearinghouse command before issuing this command to ensure that the request is directed to the master replica.

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

Notes
Use the create child command only to re-create a child pointer that is accidentally deleted. This command is designed only for troubleshooting.

This command will fail if the associated directory does not exist. If the associated directory exists, this command will return successfully.

This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

Examples
The following command creates the child pointer in the parent directory /.:/subsys. It uses the replica located at the /.:/subsys/NY_CH clearinghouse to fill in its replica set.

cdscp> create child /.:/subsys clearinghouse /.:/subsys/NY_CH

Related Information
Commands:

delete child(8cds)
list child(8cds)
show child(8cds)