set directory(8cds)
Changes the value of a modifiable, single-valued attribute of a directory
Synopsis
cdscp set directory directory-name
attribute-name [ =attribute-value ]
Arguments
directory-name
The full name of the directory.
attribute-name
The name of a particular attribute. Specify only one attribute at a time. See The cds_attribute File in the OSF DCE Administration Guide - Core Components
for the list of attributes and corresponding data types that your application uses.
attribute-value
The value of a particular attribute. The value of an application-defined attribute is dependent on the type of attribute.
Description
The set directory command changes the value of a modifiable, single-valued attribute of a directory. If the attribute does not exist, this command creates
it. Usually, this task is performed through the client application. See the OSF DCE Administration Guide - Core Components for more information about attributes. You can specify
an application-defined attribute or the following attributes:
CDS_Convergence = value
Specifies the degree of consistency among replicas. By default, every directory inherits the convergence of its
parent at creation time. The default setting on the root directory is medium. You can define one of the following for value:
low
CDS does not immediately propagate any updates. The next skulk distributes all updates that occurred since the previous skulk. Skulks occur at least once every 24 hours.
medium
CDS attempts to immediately propagate an update to all replicas. If the attempt fails, the software lets the next scheduled skulk make the replicas consistent. Skulks
occur at least once every 12 hours.
high
CDS attempts to immediately 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 one hour. Background skulks occur at least once every 12 hours. Use this setting temporarily and briefly because it uses extensive system resources.
CDS_UpgradeTo = v.n
Controls the upgrading of a directory from one version of CDS to another. By modifying this attribute, you can initiate the upgrading of a
directory to a higher version of CDS. Specify the value as v.n, where v indicates the major version number and n specifies the minor version number. There is no default.
Privileges Required
You must have w (write) permission to the directory.
Notes
This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.
Examples
The following command sets a low convergence value on the /.:/mfg directory:
cdscp> set directory /.:/mfg CDS_Convergence = low
The following commands upgrades the directory version on the /.:/host directory:
dcecp> directory modify /.:/host -add {CDS_UpgradeTO 1.2} -single
dcecp> directory synchronize /.:/host
Related Information
Commands:
Book: OSF DCE Administration Guide - Core Components