set directory(1m)                   OSF                   set directory(1m)




 NAME    [Toc]    [Back]
      set directory - Changes the value of a modifiable, single-valued
      attribute of a directory

 SYNOPSIS    [Toc]    [Back]
      cdscp set directory directory-name attribute-name = attribute-value

 ARGUMENTS    [Toc]    [Back]
      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    [Toc]    [Back]
      The set directory command changes the value of a modifiable, singlevalued
 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.




 Hewlett-Packard Company            - 1 OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96






 set directory(1m)        Open Software Foundation         set directory(1m)




                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    [Toc]    [Back]
      You must have write permission to the directory.

 NOTE    [Toc]    [Back]
      This command is replaced at Revision 1.1 by the dcecp command and may
      not be provided in future releases of DCE.

 EXAMPLES    [Toc]    [Back]
      The following command sets a low convergence value on the /.:/mfg
      directory:

      dscp> set directory /.:/mfg CDS_Convergence = low


      The following commands upgrades the directory version on the /.:/host
      directory:

      cecp> directory modify /.:/host -add {CDS_UpgradeTO 1.2} -single
      cecp> directory synchronize /.:/host


 RELATED INFORMATION    [Toc]    [Back]
      Commands: create directory(1m), delete directory(1m), list
      directory(1m), remove directory(1m), set directory to skulk(1m), show
      directory(1m)

      Books: OSF DCE Administration Guide


 Hewlett-Packard Company            - 2 -OSF DCE 1.1/HP DCE 1.8 PHSS_26394-96