NCLHELP.HLB  —  create  dns  server  clearinghouse
    create [node node-id] dns server -
       clearinghouse clearinghouse-name [,optional arguments...]

    Creates a clearinghouse on the specified node. You can specify
    the directory version, the initial replica to be stored in the
    clearinghouse, and the filename. This command is useful after
    moving a clearinghouse or if you have moved the clearinghouse
    file. You can also enter this command through the dns$control
    utility.

    The account executing the command needs write access to the
    directory in which you want to name the clearinghouse.  This
    access must be propagated to all members of the directory's
    replica set before you enter this command.  Otherwise, the
    command fails.

    You must have the NET$MANAGE rights identifier (OpenVMS
    systems) or superuser privileges (Tru64 Unix systems).

                               NOTE

    This command is normally executed only by the DECdns
    configuration program during the configuration of a DECdns
    server in an existing namespace.  You should use this command
    only to re-create a clearinghouse whose database files are
    relocated on another server system.

    The following example creates a clearinghouse named
    .sales.ny_ch on node .sales.orion.

    create node .sales.orion dns server -
       clearinghouse .sales.ny_ch

1  –  new_directory_version

    The new directory version optional argument specifies
    the DECdns version number the new directories will
    have at this clearinghouse. Specify the version-number
    as Vx.y.z, where x defines the major release number,
    y specifies the minor version number, and z specifies
    an ECO level. This argument is optional. Set the value to
    V1.0.0 if you intend to create DNS Version 1 directories.
    Set it to  V2.0.0 to create only DECdns Version 2
    directories. If you omit this argument, the default
    is V2.0.0.

2  –  initial_replica

    The initial replicate optional argument specifies the
    full name of the first directory replica to store in the
    clearinghouse.  If you omit this argument, the parent
    directory of this clearinghouse becomes the initial
    replica.

3  –  file

    A file specification that will contain the clearinghouse.
    This argument, which is optional, is useful if you have
    moved an existing clearinghouse and do not want new
    default names to be generated automatically. On Tru64 Unix
    systems, the default is /var/dss/dns. On OpenVMS systems,
    the default is the default directory for the DNS$SERVER
    account.
Close Help