Export (0) Print
Expand All
Expand Minimize

3.1.1.3.2.30 msDS-ReplQueueStatistics

Reading the msDS-ReplQueueStatistics attribute returns replication queue statistics.

Like the other ms-dsRepl* rootDSE attributes, the server returns either XML or binary data, depending on the presence of the ";binary" attribute qualifier. For XML, it returns the following representation:

<DS_REPL_QUEUE_STATISTICSW>

<ftimeCurrentOpStarted> ftimeCurrentOpStartedValue </ftimeCurrentOpStarted>

<cNumPendingOps> cNumPendingOpsValue </cNumPendingOps>

<ftimeOldestSync> ftimeOldestSyncValue </ftimeOldestSync>

<ftimeOldestAdd> ftimeOldestAddValue </ftimeOldestAdd>

<ftimeOldestMod> ftimeOldestModValue </ftimeOldestMod>

<ftimeOldestDel> ftimeOldestDelValue </ftimeOldestDel>

<ftimeOldestUpdRefs> ftimeOldestUpdRefsValue </ftimeOldestUpdRefs>

</DS_REPL_QUEUE_STATISTICSW>

The structure returned by this attribute for the binary representation is DS_REPL_QUEUE_STATISTICSW_BLOB (section 2.2.5).

The information returned by reading this attribute is derived from the field replicationQueue of the variable dc specified in [MS-DRSR] section 5.30. dc.replicationQueue is used to serialize IDL_DRSReplicaSync, IDL_DRSReplicaAdd, IDL_DRSReplicaModify, IDL_DRSReplicaDel, and IDL_DRSUpdateRefs request processing [MS-DRSR] on the DC. msDS-ReplQueueStatistics returns the following information about the current state of this queue:

  • ftimeCurrentOpStartedValue is the date and time that the current IDL_DRSReplicaSync, IDL_DRSReplicaAdd, IDL_DRSReplicaModify, IDL_DRSReplicaDel, or IDL_DRSUpdateRefs request left the queue and started running.

  • cNumPendingOpsValue is the number of queued IDL_DRSReplicaSync, IDL_DRSReplicaAdd, IDL_DRSReplicaModify, IDL_DRSReplicaDel, or IDL_DRSUpdateRefs requests.

  • ftimeOldestSyncValue is the date and time that the oldest queued IDL_DRSReplicaSync request entered the queue.

  • ftimeOldestAddValue is the date and time that the oldest queued IDL_DRSReplicaAdd request entered the queue.

  • ftimeOldestModValue is the date and time that the oldest queued IDL_DRSReplicaModify request entered the queue.

  • ftimeOldestDelValue is the date and time that the oldest queued IDL_DRSReplicaDel request entered the queue.

  • ftimeOldestUpdRefsValue is the date and time that the oldest queued IDL_DRSUpdateRefs request entered the queue.

cNumPendingOpsValue is an integer represented as a decimal string. The remaining values are represented as XML dateTime values in UTC, defined in [XMLSCHEMA2/2].

If a designated request does not exist, the corresponding portion of the msDS-ReplQueueStatistics response contains a zero filetime in the binary format, and the XML dateTime value "1601-01-01T00:00:00Z" in XML format. For instance, if there is no IDL_DRSUpdateRefs request in the replication queue, the msDS-ReplQueueStatistics XML response includes:

<ftimeOldestUpdRefs>1601-01-01T00:00:00Z</ftimeOldestUpdRefs>

 
Show:
© 2014 Microsoft