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-name
             The full name of the child pointer.

   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.

   Privilege Required

   You must have 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.

 EXAMPLE

   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
             list child
             show child