/sys$common/syshlp/DNS$CPHELP.HLB  —  initialize

1  –  dns

1.1  –  server

 Creates a new namespace, assigns it the specified nickname, creates
 a clearinghouse, and places the master replica of the root directory
 in that clearinghouse. You can also enter this command through the
 NCL interface.

 INITIALIZE [NODE node-id] DNS SERVER NICKNAME namespace-nickname,
 OWNER name, ROOT CLEARINGHOUSE clearinghouse-name

 Arguments

 node-id

 The name of the node. If you do not specify a node name, the local
 node is assumed.

 namespace-nickname

 The nickname of the namespace.

 name

 The simple name of a user or account to be given initial access
 to the entities created with this command. Based on the name
 you supply, the software generates ACEs that grant the user or
 account read, write, delete, test and control access to the first
 clearinghouse in the namespace and to the root directory. The
 principal name in the ACEs is derived by attaching the full name
 of the node where the command originated to the front of the simple
 name you supply.

 clearinghouse-name

 The name of the first clearinghouse in the namespace.

 Description

 This command creates a new namespace, assigns it the specified
 nickname, creates a clearinghouse, and places the master replica
 of the root directory in that clearinghouse. Initial access to the
 clearinghouse and root directory is given to the specified user, who
 can then define an access control policy. You can also enter this
 command through the NCL interface.

                                 NOTE

    This command should be executed only by the DECnet
    configuration procedure. This operation can only be performed
    once in the lifetime of a namespace.

 PRIVILEGES REQUIRED
 You must have the NET$MANAGE rights identifier (VMS systems) or
 superuser privileges (ULTRIX systems).

1.1.1  –  example

 The following command creates a namespace, assigns it the nickname
 jns, gives all access rights to the .root account, and creates the
 clearinghouse .paris_ch, placing the master replica of the root
 directory in that clearinghouse.

 dns> initialize dns server nickname jns, owner .root, -
 _> root clearinghouse .paris_ch
Close Help