NAME

create child - Creates a child pointer at the master replica of the parent directory

SYNOPSIS

cdscp create child child-name clearinghouse clearinghouse-name

ARGUMENTS

child-nameThe 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 the Cell Directory Service (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 recreate a child pointer that is accidentally deleted.  This command is designed for troubleshooting only. 

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

NOTES

This command is replaced at DCE Version 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).