PreviousNext

Attributes

The following are the CDS defined attributes for CDS directory objects:

CDS_AllUpTo
Indicates the date and time of the last successful skulk on the directory. All replicas of the directory are guaranteed to receive all updates whose timestamps are less than the value of this attribute. The value of this attribute is a read-only DTS-style timestamp that is set by the system.

CDS_Convergence
Specifies the degree of consistency among replicas. This attribute's value is defined as one of the following:

low
CDS does not immediately propagate an update. 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 next scheduled skulk makes the replicas consistent. Skulks occur at least once every 12 hours.

high
CDS attempts to immediately propagate an update to all replicas. If the attempt fails (for example, if one of the replicas is unavailable), a skulk is scheduled for within one hour. Skulks usually 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 on the root directory is medium.

CDS_CTS
Specifies the creation timestamp (CTS) of the CDS directory. The value of this attribute is a read-only DTS-style timestamp that is set by the system.

CDS_DirectoryVersion
Specifies the current version of the directory. The version is derived from the CDS_DirectoryVersion attribute of the clearinghouse in which the directory was created. Multiple directory versions are supported in a cell. This read-only attribute is set by the system.

CDS_Epoch
A Universal Unique Identifier (UUID) that identifies a particular instance of the directory. This read-only attribute is set by the system.

CDS_GDAPointers
A set-valued attribute that is present only in the root directory of a cell. This attribute contains location information about registered Global Directory Agents (GDAs) for that cell, similar to the CDS_Replicas attribute. It is created and only used by a GDA.

CDS_InCHName
Indicates whether a directory or any of its descendants can store clearinghouse names. If this value is true, the directory can store clearinghouse names. If it is false, the directory cannot store clearinghouse names. This read-only attribute is set by the system.

As of DCE Release 1.1 and later, CDS creates this attribute on the cell root directory and gives it a value of true. The attribute will not appear in any other directory.

CDS_LastSkulk
Records the timestamp of the last skulk performed on this directory. This read-only attribute is set by the system.

CDS_LastUpdate
Records the timestamp of the most recent change to any attribute of a directory replica, or any change to an entry in the replica. This read-only attribute is set by the system.

CDS_ObjectUUID
Specifies the unique identifier of the directory. This is read-only to the user and is set by the system at creation time.

CDS_ParentPointer
Contains a pointer to this directory's parent in the namespace. This read-only attribute is set by the system.

CDS_Replicas
Specifies the address, UUID, and name of every clearinghouse in which a copy of this directory is located. This attribute also specifies whether the replica in a particular clearinghouse is a master or read-only replica. This read-only attribute is set by the system.

CDS_ReplicaState
Specifies whether a directory replica can be accessed. The state on indicates that the directory replica can be accessed. This read-only attribute is set by the system.

CDS_ReplicaType
Indicates whether a directory replica is a master or read-only replica. Possible values are Master and ReadOnly. This read-only attribute is set by the system.

CDS_ReplicaVersion
Specifies the version of a replica of the directory.The default is 3.0. This read-only attribute is set by the system.

CDS_RingPointer
Specifies the UUID of a clearinghouse containing another replica of this directory. The CDS_RingPointer attribute appears on older directories, but not on DCE Release 1.1 and later directories. This read-only attribute is set by the system.

CDS_UpgradeTo
A single-valued attribute used to control the upgrading of a directory from one version of CDS to another. By modifying this attribute, the process of upgrading a directory to a newer version of CDS may be initiated. After this attribute is set, the background process in CDS notices it and tries to contact each replica. If CDS can contact the replica, the CDS_Directory Version attribute is changed to the value of this attribute.

CDS_UTS
Specifies the timestamp of the most recent update to an attribute of the directory. The value of this attribute is a read-only DTS-style timestamp that is set by the system.

See the OSF DCE Administration Guide - Core Components for more information about directory attributes.