NAME

   create clearinghouse - Creates a clearinghouse on the local server
                          system or makes an existing clearinghouse
                          available

 SYNOPSIS

   cdscp create clearinghouse clearinghouse-name

 ARGUMENTS

   clearinghouse-name
             The full name of the clearinghouse.

 DESCRIPTION

   The create clearinghouse command creates a clearinghouse on the
   local server system or makes an existing clearinghouse available.
   The server start-up command usually creates a new clearinghouse
   when you configure a new CDS server.  Occasionally, you may need to
   create a second clearinghouse on a particular server; for example,
   if you are temporarily relocating a clearinghouse on a different
   server.  See the OSF DCE Administration Guide for more information
   about relocating a clearinghouse.

   Clearinghouses should be named only in the root.  When you enter the
   command, CDS creates a read-only replica of the root directory and
   stores it in the new clearinghouse as the initial replica.  Because
   the process that creates the new clearinghouse initiates a skulk of
   the root directory, all replicas of the root should be reachable when
   you enter the command.

   Privilege Required

   You need write permission to the server on which you intend to create
   the clearinghouse and administer permission to the cell root
   directory. The server principal needs read, write, and administer
   permission to the cell root directory.

 NOTES

   This command is usually executed only by the network configuration
   procedure.  To ensure that all replicas of the root are reachable,
   perform an immediate skulk of /.: prior to issuing this command.

   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 a clearinghouse named /.:/Boston_CH
   on the local server system:

        cdscp> create clearinghouse /.:/Boston_CH

 RELATED INFORMATION

   Commands: clear clearinghouse
             delete clearinghouse
             list clearinghouse
             set cdscp preferred clearinghouse
             show cached clearinghouse
             show cdscp preferred clearinghouse
             show clearinghouse

   Books: OSF DCE Administration Guide