DLS Messages
- Last Updated: September 10, 2026
- 3 minute read
- MarkLogic Server
- Version 12.0
- Documentation
DLS-CHECKEDOUT
Message Text
Document variable1 cannot be changed when checked out
Cause
Attempt made to update a managed document that is currently checked out by another user.
Response
Wait for the document to be checked back into Library Services and check out before updating.
DLS-CHECKOUTCONFLICT
Message Text
variable1 has a conflicting checkout
Cause
Attempt made to check out a document that has already been checked out by another user.
Response
Wait for the document to be checked back into Library Services before checking out.
DLS-DELETEVERSION
Message Text
Cannot delete the latest version variable1 of document variable2
Cause
An attempt was made to delete a document's latest version.
Response
Avoid deleting a document's latest version.
DLS-DOCUMENTVERSION
Message Text
Cannot update or checkout document version variable1
Cause
An attempt was made to check out or update a document that is already checked out by another user.
Response
Wait for the document to be checked back in.
DLS-DUPLICATERULE
Message Text
variable1 already exists as a retention rule name
Cause
Attempt was made to insert a retention rule with the same name as an existing retention rule.
Response
Use a different name for the retention rule.
DLS-EMPTYRULE
Message Text
Cannot have empty retention rule
Cause
Attempt made to create a retention rule without a document query.
Response
Add a document query to the retention rule.
DLS-INVALIDVERSION
Message Text
variable1 has no version number variable2
Cause
Attempt to return a non-existent version of a managed document.
Response
Use dls:document-version-uris to determine the available versions of the document and retry using a valid version.
DLS-MANAGED
Message Text
variable1 is already a managed document
Cause
Attempt was made to place a managed document under managed version control.
Response
Treat the document as a managed document or use dls:document-unmanage to remove the document from management.
DLS-NOREFVERSION
Message Text
no version exists for query variable1
Cause
An attempt was made to query for a version of a document that does not exist.
Response
Use dls:document-history to return the version history of the document, then retry the query for an existing version of the document.
DLS-NOSUCHRULE
Message Text
retention rule variable1 does not exist
Cause
Attempt was made to remove a non-existent rule.
Response
Specify the name of an existing retention rule.
You can use the following query to return the names of all of the retention rules:
xquery version "1.0-ml";import module namespace dls = "http://marklogic.com/xdmp/dls" at "/MarkLogic/dls.xqy";
fn:data(dls:retention-rules("*")/dls:name)
DLS-NOTCHECKEDOUT
Message Text
variable1 is not checked out and cannot be modified
Cause
Attempt made to modify a managed document that has not been checked out.
Response
Use dls:document-checkout to check out the document.
DLS-NOVERSION
Message Text
variable1 has no version at variable2
Cause
An attempt was made to check out a document that is not managed.
Response
Use the dls:document-manage function to place the document under management.
DLS-PERMDENIED
Message Text
user needs variable2 permission for variable1
Cause
The user does not have the proper permissions for the operation.
Response
Make sure the user has the dls-user role and, if this is a DLS administrative task, the dls-admin role.
DLS-SPECIALPROP
Message Text
Cannot update properties in dls namespace
Cause
Attempt made to add or set a property for a document under namespace "http://marklogic.com/xdmp/dls".
Response
Avoid using "http://marklogic.com/xdmp/dls" as the namespace for a property of your document.
DLS-UNMANAGED
Message Text
variable1 is not a managed document
Cause
Attempt to execute a DLS function on an unmanaged document.
Response
Use dls:document-manage to place the document under management.