/sys$common/syshlp/helplib.hlb DCE_CDS, cdscp, set_directory  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   set directory - 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_attributes file 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 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.

   Privilege Required

   You must have write permission to the directory.

 NOTE
   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: create directory
             delete directory
             list directory
             remove directory
             set directory to skulk
             show directory

   Books: OSF DCE Administration Guide