DNS$CPHELP.HLB  —  set  directory
 Modifies characteristics for the specified directory.

 SYNOPSIS

      SET DIRECTORY directory-name characteristic

 Arguments

 directory-name

 The full name of the directory to be modified.

 characteristic

 The name and value of the characteristic to be modified. Specify one
 or more of the following:

 DNS$Convergence [=] value
 DNS$InCHName [=] boolean
 DNS$UpgradeTo [=] v.n

 Description

 This command modifies characteristics for the specified directory.
 You can specify one or more of the listed characteristics to be
 modified. Use a comma to separate characteristics.

 Characteristics

 DNS$Convergence [=] value

 Specifies the degree of consistency among replicas. Specify the
 value argument as one of the following:

 Low            The next skulk distributes all updates that occurred
                since the previous skulk. Skulks occur at least once
                every 24 hours.
 Medium         DECdns attempts to propagate an update to all
                replicas. If the attempt fails, the next scheduled
                skulk makes the replicas consistent. Skulks occur at
                least once every 12 hours.
 High           DECdns attempts to propagate an update to all
                replicas. If that attempt fails (for example, if
                one of the replicas is unavailable), a skulk is
                scheduled for within 1 hour. Background skulks will
                occur at least once every 12 hours. Use this setting
                temporarily and briefly because it uses extensive
                system resources.

 By default, every directory inherits the convergence setting of its
 parent at creation time. The default setting of the root directory
 is medium.

 DNS$InCHName [=] boolean

 Specifies whether a directory or any of its descendants can store
 clearinghouse names. The boolean argument can be specified as one of
 the following:

 True       The directory or its descendants can store clearinghouse
            names.
 False      The directory or its descendants cannot store
            clearinghouse names. This is the default value.

 DNS$UpgradeTo [=] v.n

 Controls the upgrading of a directory from one version of DECdns to
 another. By modifying this attribute, you can initiate the upgrading
 of a directory to a higher version of DECdns. Specify the value as
 v.n where v indicates the major version number and n specifies the
 minor version number. There is no default.

 ACCESS RIGHTS
 You must have write access to the directory whose attribute you
 intend to modify.

1  –  example 

 The following command sets a low convergence value on the .mfg
 directory.

 dns> set directory .mfg DNS$Convergence = low

2  –  to_new_epoch 

 Reconstructs a directory's replica set, allowing you to exclude a
 replica or re-specify replica types.

 SYNOPSIS

      SET DIRECTORY directory-name TO NEW EPOCH MASTER

      clearinghouse-name [,READ-ONLY clearinghouse-name] [...]

      [,EXCLUDE clearinghouse-name]

 directory-name

 The full name of the directory.

 clearinghouse-name

 The name of the clearinghouse in which an individual replica is
 located. The first clearinghouse-name specifies where the master
 replica is stored.

 ACCESS RIGHTS
 You must have read and control access to all the replicas in the
 replica set. To change the type of replica, you must have write
 access to the clearinghouse that stores the replica whose type is
 being changed.

2.1  –  example 

 The following command sets a new epoch for the directory .mfg.
 The master replica is in .paris_ch, and read-only replicas are in
 .chicago1_ch, .seattle_ch, and .ny1_ch. The new replica set excludes
 the replica in .ny1_ch.

 dns> set directory .mfg to new epoch master .paris1_ch, -
 _> read-only .chicago1_ch, read-only .seattle_ch, exclude .ny1_ch

3  –  to_skulk 

 Skulks a directory immediately. The control program prompt (dns>)
 does not return until skulking completes. It may take a while for
 skulking to complete.

 SYNOPSIS

      SET DIRECTORY directory-name TO SKULK

 Argument

 directory-name

 The full name of the directory.

 ACCESS RIGHTS
 You must have write access to the directory you intend to skulk.

3.1  –  example 

 The following command initiates a skulk on the .admin directory.

 dns> set directory .admin to skulk
Close Help