Control queue extended operation

Edit online

The control queue extended operation explains its use with the server and provides the results.

Description
This extended operation is used to skip changes in the replication queue for an agreement.
Request
OID
1.3.18.0.2.12.17
Syntax
requestValue ::= SEQUENCE {
action ActionValue,
agreementDN DistinguishedName,
changeId LDAPString
}
ActionValue ::= INTEGER {
skipAll (0),
skipSingle (1)
}
Response
OID
1.3.18.0.2.12.17
Syntax
Response Value ::= SEQUENCE {
#fields of interest from LDAPResult:
resultCode INTEGER (0..MAX),
errorMessage LDAPString,
#operation information:
changesSkipped INTEGER (0..MAX)
}
The following codes are possible return codes:
  • LDAP_SUCCESS
  • LDAP_NO_SUCH_OBJECT
  • LDAP_UNWILLING_TO_PERFORM
  • LDAP_OPERATIONS_ERROR
  • LDAP_INSUFFICIENT_ACCESS
  • LDAP_NO_MEMORY
Behavior
This extended operation skips changes in the replication agreements queue. If skipSingle is used, and changeID is the next ID in the replication agreements queue, then changeID is skipped over. If changeID is not at the head of the list of pending changes, the operation fails. If skipAll is used, then all outstanding changes in the replication agreements queue are skipped.
The following persons are enabled to call the extended operation:
  • Primary Directory Administrator
  • Local Administration Group members with DirDataAdmin and ReplicationAdmin roles
  • Global Administration Group members
  • Master Server DN
  • Authenticated Directory User
Note: If the extended operation is called by a user who does not have access, LDAP_INSUFFICIENT_ACCESS is returned.
This extended operation has the following possible return codes:
  • LDAP_SUCCESS
  • LDAP_PROTOCOL_ERROR
  • LDAP_DECODING_ERROR
  • LDAP_NO_MEMORY
  • LDAP_UNDEFINED_TYPE
  • LDAP_INVALID_DN_SYNTAX
This extended operation is not supported by the Administration Server.
Scope
This extended operation affects only the current operation.
Auditing
Skip: [ All | changeId | Unknown ]
Agreement DN: agreementDn