Error Codes

Every job call returns an integer value: 0 means success, any other value an error (see Introduction). This page collects the error codes documented so far in a central place, grouped by meaning.

This overview is new and not yet complete. It contains only error codes that are described elsewhere in the documentation or derived from concrete implementations, and is extended continuously. The absence of a code does not mean it cannot occur.

All codes are integer (INT) return values of the same mechanism. They are usually not job-specific but apply across the job calls (e.g. dms.XMLInsert, dms.XMLUpdate, dms.XMLImport, dms.GetResultList, check-in/check-out). The Code column lists the decimal return value (signed 32-bit integer). The Jobs column notes the triggers verified against a enaio® server.

1. Job-Dependent Specifics

The following observations were verified directly against a test server and should be considered when evaluating return values:

The same cause yields a different code depending on the job:
- Unknown field: dms.XMLImport → -24, dms.GetResultList → -1031.
- Unknown object type: dms.XMLImport → -7, dms.GetResultList → -1030.
- Non-existent object when filling a portfolio: dms.AddPortfolio → -22, dms.ModPortfolio → -1073 for a document, -47 for a folder (the rights check precedes the existence check).
dms.XMLImport reports XML structure errors as a generic -1. The actual diagnosis is only available in the DMSResult buffer, not in the return value. dms.GetResultList, in contrast, returns specific codes (-1016 / -1029).
Each server namespace has its own codes for parameter errors. The dms. jobs return small, documented codes (-1024 / -1025) or -1; std., mng., wfm. and krn.* instead return large, HRESULT-style values (see Parameter Errors by Namespace).
No-error cases: Some jobs still return 0 for a functionally negative answer — the result is in the output value, not in the return value. Examples: dms.GetUserData and dms.IsUserData with an unknown name; dms.GetObjectTypeByID with an ObjectID that does not exist (ObjectType = -1, no entry in the error stack); krn.VerifyPassword with a password that does not satisfy the password syntax rule (Matches = false); ado.ExecuteSQL with invalid SQL (return_code = 0 and an empty result — the SQL error is swallowed, so error detection must not rely on the return value here); mng.GetUserRoles with an unknown, syntactically invalid or null UserGUID (return_code = 0 and an empty Result — an empty result therefore does not necessarily mean "user has no system role"); lic.CheckLicense when none of the requested modules is available (Result = 602, reason in the error stack, see Diagnostic Entries with Return Value 0); lic.LicGetQueueStatus with unknown module labels (empty file).
Functional rejection as an error code instead of an output value: krn.CheckUserAccount documents the verdicts "user unknown", "wrong password" and "account locked" as values of the output parameter Action, but in practice returns them as error codes (-1042218023, -1042218021, -1042218019). A caller must therefore not check Action alone.
Configuration-dependent findings: dms.XMLMove can enforce a server-side configured target capacity (-89 when exceeded). -1012 (moving a register into one of its own children) was not reproducible on the test server — the move was allowed with return_code = 0; this behaviour is therefore not guaranteed.

2. Parameter Errors by Namespace

Each server namespace returns its own codes for parameter errors, grouped by error class. The dms. jobs return small codes documented in this list; the other namespaces (std., mng., wfm., krn.*) instead return large, HRESULT-style values:

Namespace Parameter missing Wrong parameter type Value not supported

Namespace	Parameter missing	Wrong parameter type	Value not supported
`dms.*`	`-1024` / `-1025`	`-1024`	—
`std.*`	`-1043201825`	`-1043201825`	—
`mng.*`	`-1043332470`	`-1043332106`	—
`wfm.*`	`-1043332470`	`-1043332106`	—
`krn.*`	`-1043332470`	—	`-1043332107` / `-1043332815`
`lic.*`	`-1043332470`	—	—

dms.*

-1024 / -1025

-1024

—

std.*

-1043201825

—

mng.*

-1043332470

-1043332106

—

wfm.*

-1043332470

-1043332106

—

krn.*

-1043332470

—

-1043332107 / -1043332815

lic.*

-1043332470

—

This table is not exhaustive. Other namespaces and jobs (std., mng., wfm., lic., …) may return their own large, HRESULT-style values for parameter errors.

3. General Errors

Code Meaning Jobs

Code	Meaning	Jobs
`-1`	General error (not further specifiable).	dms.XMLImport for XML structure errors (details only in the `DMSResult` buffer), dms.CreateOsEvent for an OS event that already exists (cause in the error stack, see `-1042609876`) (verified)
`-2`	No cabinet specified.
`-4`	No register type specified.
`-6`	No document type specified.
`-10`	Required folder identification is missing. Server message: `The location of the object that should be inserted is unknown`.	dms.XMLImport (document insert without `folder_id`/`register_id`) (verified)
`-11`	Required document identification is missing.
`-12`	Required register identification is missing.
`-16`	Folder update failed.
`-17`	Document update failed.
`-18`	Register update failed.
`-24`	The field name could not be resolved. Server message: `The DMS field >…< could not be found`.	dms.XMLImport (unknown field) (verified)
`-28`	The value for the given field is not allowed.
`-29`	The specified object ID is invalid.
`-30`	The mandatory fields have not been filled in. Server message: `Field >…< is required, but was not filled out`.	dms.XMLImport (verified)
`-31`	The specified value does not match the type on the archive server. Server message: `invalid date format …` / `Invalid decimal format`.	dms.XMLImport (invalid date/decimal value) (verified)
`-40`	A transfer parameter is incorrect or missing.	dms.ModPortfolio (unknown portfolio ID)
`-65`	No index could be obtained from the server.
`-1004`	No document list was specified.
`-1006`	The requested functionality is not implemented in the current version.
`-1007`	An error occurred while reading the object definitions.
`-1013`	A system ID was specified but no foreign ID.
`-1016`	An error occurred while parsing the XML text. Server message: `Missing type ident attributes`.	dms.GetResultList (malformed XML / missing type attribute) (verified)
`-1017`	An error occurred while validating the XML text.
`-1018`	The XML text is incomplete.
`-1024`	A job parameter is missing or has the wrong type. Server message: `A required parameter was not specified: …` or `Parameter <…> has an invalid type: <1> instead of <2>`. For dms.RemoveStoredQuery without `QueryID` the error stack contains `-1043332470` and `-1042612199`.	dms.GetObjectDetails (missing and wrong type), dms.GetObjectTypeByID, dms.RemoveStoredQuery, dms.IsUserData, dms.GetUserData (verified)
`-1025`	The specified parameter value is invalid or missing. Server message: `The specified parameter value is invalid` / `Missing argument >XML<` / `…not specified: QueryID`. Occurs among other things when the XML parameter is passed as a string instead of binary; the cause then appears as `-1042609859` in the error stack.	dms.GetResultList, dms.ExecuteStoredQuery, dms.GetStoredQuery (verified)
`-1027`	More values were specified for a table field than there are columns.
`-1028`	An error occurred while inserting the note objects/texts. Among other cases it appears when a text longer than 8000 characters is passed under database note storage (cause `-1042611967` in the error stack), and when `UPDATE_TEXT` hits a note whose text file is missing (cause `-1043201745`).	dms.XMLInsert, dms.XMLUpdate (verified)
`-1029`	An XML element is unknown or incorrectly positioned. Server message: `Unknown or incorrectly positioned XML element: …`.	dms.GetResultList (verified)
`-1032`	The job was cancelled by user request.
`-1033`	The specified condition is invalid.
`-1034`	An XML attribute is invalid.
`-1035`	A required XML attribute is missing.
`-1047`	The user data specifications are ambiguous.
`-1051`	The query format is not supported.
`-1055`	An expression has an invalid format.
`-1056`	The section name is invalid.
`-1057`	General error while reading the query.
`-1058`	Unknown query type.
`-1060`	The query could not be processed.
`-1067`	The full-text query contains only words that are to be ignored.
`-1068`	Insufficient memory is available.
`-1043267169`	A GUID parameter marked as mandatory is empty (`GUID '<parameter name>' is not set`).	wfm.GetRunningActivities
`-1043201825`	Missing or wrong-type parameter in the `std.*` namespace. Large, HRESULT-style value (see Parameter Errors by Namespace).	std.GetObjectInfo
`-1043332470`	Missing parameter (`A required parameter was not specified: <name>.`). Large, HRESULT-style value — this is the server kernel’s generic parameter validation and occurs for arbitrary jobs, primarily in the `mng.`/`wfm.`/`krn.*` namespaces (see Parameter Errors by Namespace).	mng.GetUserAttributes, mng.SetUserAttributes (call with only `UserGUID` and `Locked`), wfm.GetWorkflowList, krn.EnumRJCJobs (RJC introspection without `IPAddress1`/`IPAddress2`), krn.VerifyPassword and krn.CheckUserAccount (without `Password`), lic.LicCheckThreshold (without `Modules`), krn.NameSpaceGetJobsInfo (with `NameSpaces` instead of `NameSpace`) (verified)
`-1042612199`	Missing argument, reported by the DMS engine. Server message: `Missing argument ><name>< during call of job`. A cause code in the error stack, not a return value: it follows `-1043332470` there, while the job itself returns `-1024`.	dms.RemoveStoredQuery (without `QueryID`, return value `-1024`) (verified)
`-1043332106`	Wrong parameter type (`Parameter <name> was provided, but has an invalid type: <actual> instead of <expected>.`). Large, HRESULT-style value of the server kernel’s generic parameter validation, primarily in the `mng.`/`wfm.` namespaces (see Parameter Errors by Namespace). In the measured cases the type numbers are reversed compared to the `-1024` message (here `<2> instead of <1>`, there `<1> instead of <2>`); both wordings were taken from the respective server answers.	mng.GetUserAttributes (`User` passed as INT), wfm.AdminTerminateProcess (`ProcessId` passed as INT; the parameter validation rejects the call, nothing is terminated) (verified)
`-1043332107`	A supplied parameter value is invalid (`Parameter <name> was provided, but the value is invalid: <value>.`). The second half of the server kernel’s generic parameter validation — unlike `-1043332470`, the parameter was supplied but its value is unusable (empty string, disallowed value). Job-specific manifestation: for adm.ServerEventsEnumJobs the requested server-event type is not bound to a job — only job-bound OS events (`KernelBeforeJob`, `KernelAfterJob`, `JobBeforeObject`, `JobAfterObject`) can be queried. Global / per-session events (`OnObjectHistoryEntry`, `OnSessionLogin`) return this error.	adm.ServerEventsEnumJobs (non-job-bound event), krn.VerifyPassword (empty `Password`) (verified)
`-1043332815`	Unsupported parameter value in the `krn.*` namespace (`info number not supported`). Large, HRESULT-style value (see Parameter Errors by Namespace).	krn.GetServerInfo

-1

General error (not further specifiable).

dms.XMLImport for XML structure errors (details only in the DMSResult buffer), dms.CreateOsEvent for an OS event that already exists (cause in the error stack, see -1042609876) (verified)

-2

No cabinet specified.

-4

No register type specified.

-6

No document type specified.

-10

Required folder identification is missing. Server message: The location of the object that should be inserted is unknown.

dms.XMLImport (document insert without folder_id/register_id) (verified)

-11

Required document identification is missing.

-12

Required register identification is missing.

-16

Folder update failed.

-17

Document update failed.

-18

-24

The field name could not be resolved. Server message: The DMS field >…< could not be found.

dms.XMLImport (unknown field) (verified)

-28

The value for the given field is not allowed.

-29

The specified object ID is invalid.

-30

The mandatory fields have not been filled in. Server message: Field >…< is required, but was not filled out.

dms.XMLImport (verified)

-31

The specified value does not match the type on the archive server. Server message: invalid date format … / Invalid decimal format.

dms.XMLImport (invalid date/decimal value) (verified)

-40

A transfer parameter is incorrect or missing.

dms.ModPortfolio (unknown portfolio ID)

-65

No index could be obtained from the server.

-1004

No document list was specified.

-1006

The requested functionality is not implemented in the current version.

-1007

An error occurred while reading the object definitions.

-1013

A system ID was specified but no foreign ID.

-1016

An error occurred while parsing the XML text. Server message: Missing type ident attributes.

dms.GetResultList (malformed XML / missing type attribute) (verified)

-1017

An error occurred while validating the XML text.

-1018

The XML text is incomplete.

-1024

A job parameter is missing or has the wrong type. Server message: A required parameter was not specified: … or Parameter <…> has an invalid type: <1> instead of <2>. For dms.RemoveStoredQuery without QueryID the error stack contains -1043332470 and -1042612199.

dms.GetObjectDetails (missing and wrong type), dms.GetObjectTypeByID, dms.RemoveStoredQuery, dms.IsUserData, dms.GetUserData (verified)

-1025

The specified parameter value is invalid or missing. Server message: The specified parameter value is invalid / Missing argument >XML< / …not specified: QueryID. Occurs among other things when the XML parameter is passed as a string instead of binary; the cause then appears as -1042609859 in the error stack.

dms.GetResultList, dms.ExecuteStoredQuery, dms.GetStoredQuery (verified)

-1027

More values were specified for a table field than there are columns.

-1028

An error occurred while inserting the note objects/texts. Among other cases it appears when a text longer than 8000 characters is passed under database note storage (cause -1042611967 in the error stack), and when UPDATE_TEXT hits a note whose text file is missing (cause -1043201745).

dms.XMLInsert, dms.XMLUpdate (verified)

-1029

An XML element is unknown or incorrectly positioned. Server message: Unknown or incorrectly positioned XML element: ….

dms.GetResultList (verified)

-1032

The job was cancelled by user request.

-1033

The specified condition is invalid.

-1034

An XML attribute is invalid.

-1035

A required XML attribute is missing.

-1047

The user data specifications are ambiguous.

-1051

The query format is not supported.

-1055

An expression has an invalid format.

-1056

The section name is invalid.

-1057

General error while reading the query.

-1058

Unknown query type.

-1060

The query could not be processed.

-1067

The full-text query contains only words that are to be ignored.

-1068

Insufficient memory is available.

-1043267169

A GUID parameter marked as mandatory is empty (GUID '<parameter name>' is not set).

wfm.GetRunningActivities

-1043201825

Missing or wrong-type parameter in the std.* namespace. Large, HRESULT-style value (see Parameter Errors by Namespace).

std.GetObjectInfo

-1043332470

Missing parameter (A required parameter was not specified: <name>.). Large, HRESULT-style value — this is the server kernel’s generic parameter validation and occurs for arbitrary jobs, primarily in the mng./wfm./krn.* namespaces (see Parameter Errors by Namespace).

mng.GetUserAttributes, mng.SetUserAttributes (call with only UserGUID and Locked), wfm.GetWorkflowList, krn.EnumRJCJobs (RJC introspection without IPAddress1/IPAddress2), krn.VerifyPassword and krn.CheckUserAccount (without Password), lic.LicCheckThreshold (without Modules), krn.NameSpaceGetJobsInfo (with NameSpaces instead of NameSpace) (verified)

-1042612199

Missing argument, reported by the DMS engine. Server message: Missing argument ><name>< during call of job. A cause code in the error stack, not a return value: it follows -1043332470 there, while the job itself returns -1024.

dms.RemoveStoredQuery (without QueryID, return value -1024) (verified)

-1043332106

Wrong parameter type (Parameter <name> was provided, but has an invalid type: <actual> instead of <expected>.). Large, HRESULT-style value of the server kernel’s generic parameter validation, primarily in the mng./wfm. namespaces (see Parameter Errors by Namespace). In the measured cases the type numbers are reversed compared to the -1024 message (here <2> instead of <1>, there <1> instead of <2>); both wordings were taken from the respective server answers.

mng.GetUserAttributes (User passed as INT), wfm.AdminTerminateProcess (ProcessId passed as INT; the parameter validation rejects the call, nothing is terminated) (verified)

-1043332107

A supplied parameter value is invalid (Parameter <name> was provided, but the value is invalid: <value>.). The second half of the server kernel’s generic parameter validation — unlike -1043332470, the parameter was supplied but its value is unusable (empty string, disallowed value).
Job-specific manifestation: for adm.ServerEventsEnumJobs the requested server-event type is not bound to a job — only job-bound OS events (KernelBeforeJob, KernelAfterJob, JobBeforeObject, JobAfterObject) can be queried. Global / per-session events (OnObjectHistoryEntry, OnSessionLogin) return this error.

adm.ServerEventsEnumJobs (non-job-bound event), krn.VerifyPassword (empty Password) (verified)

-1043332815

Unsupported parameter value in the krn.* namespace (info number not supported). Large, HRESULT-style value (see Parameter Errors by Namespace).

krn.GetServerInfo

4. Object / Resource Not Found

Code Meaning Jobs

Code	Meaning	Jobs
`-3`	Specified cabinet unknown.
`-5`	Specified register type unknown.
`-7`	Specified document type unknown. Server message: `The cabinet for object >…< could not be determined`.	dms.XMLImport (unknown object type) (verified)
`-13`	Required register identification is unknown.
`-14`	Required folder identification is unknown.
`-15`	Required document identification is unknown.
`-22`	The specified/required object is unknown. Server message: `…no object with identifier >…< could be found`.	dms.XMLUpdate, dms.XMLDelete, dms.XMLMove (`object_id` does not exist) (verified); dms.AddPortfolio (non-existent document in `PortfolioXML`)
`-23`	The ID of the specified register does not exist on the archive server.
`-32`	The specified/required file does not exist.
`-1001`	The specified value could not be found in the associated catalog. Server message: `Field >…< contains a catalog, but value >…< could not be found in this catalog`.	dms.XMLInsert (field value not in the assigned catalog) (verified)
`-1019`	The specified owner could not be determined.
`-1022`	The reference was not found.
`-1030`	An object type was not found on the DMS server. Server message: `DMS object >…< in cabinet >< could not be found`.	dms.GetResultList (unknown object type) (verified)
`-1031`	An object field was not found on the DMS server. Server message: `The DMS field >…< could not be found`. Note: dms.XMLImport returns `-24` for the same message.	dms.GetResultList (unknown field) (verified)
`-1044`	The parent variant of the document could not be determined.
`-1046`	The document variant could not be determined. Server message: `Document with ID … could not be found … not a version`.	dms.XMLImport (`variantparent_id` points to a non-version or non-existent document) (verified)
`-1049`	The query was not found. Server message: `Saved query with ID … was not found`.	dms.ExecuteStoredQuery, dms.GetStoredQuery, dms.RemoveStoredQuery (unknown query ID) (verified)
`-1052`	The cabinet name could not be read.
`-1053`	The document name could not be read.
`-1054`	The register name could not be read.
`-1062`	The location of the object could not be determined.
`-1073`	The object could not be located in the DMS.	dms.ModPortfolio (non-existent document in `PortfolioXML`)
`-1042218023`	The specified login name is unknown. Server message: `User name <…> is unknown.` Corresponds to the documented output value `Action` = `2` but is returned as an error code.	krn.CheckUserAccount (verified)
`-1040908085`	The specified user was not found. Server message: `User not found. Requested user name: <value>`. The job expects the username; a user GUID also leads to this error.	mng.GetUserAttributes (unknown username or GUID in `User`, measured on 12.0 and 10.10) (verified)
`-1042218742`	The specified registry entry does not exist.	krn.REGetRegValue (verified)
`-1042218753`	Error in the resource administration. Server message: `Error in the resource administration. Component: <component>, resource: <X>, error: <n>`. For lic.LicGetModuleInfo (component `GetASLicString`, with the comment `Please check the entries in the OS resources table.`) the module has no license entry or the label is unknown; on 12.0, `Flags` = `1` avoids the error (see Modules Without a License Entry).	lic.LicGetModuleInfo (verified); `adm.ResourceGetState` without `ResourceType` (component `ResourceLock`) (observed)
`-1043201745`	The given note does not exist. Server message: `Note (ID = 0x…) was not found.` Besides an unknown note ID this also happens when the note exists but its text lives in the database: the three std remark jobs only find note files (see storage of notes). Likewise for `dwObjectType` = `32767` instead of the object type of the DMS object.	std.GetRemark, std.DeleteRemark (verified)

-3

Specified cabinet unknown.

-5

Specified register type unknown.

-7

Specified document type unknown. Server message: The cabinet for object >…< could not be determined.

dms.XMLImport (unknown object type) (verified)

-13

Required register identification is unknown.

-14

Required folder identification is unknown.

-15

Required document identification is unknown.

-22

The specified/required object is unknown. Server message: …no object with identifier >…< could be found.

dms.XMLUpdate, dms.XMLDelete, dms.XMLMove (object_id does not exist) (verified); dms.AddPortfolio (non-existent document in PortfolioXML)

-23

The ID of the specified register does not exist on the archive server.

-32

The specified/required file does not exist.

-1001

The specified value could not be found in the associated catalog. Server message: Field >…< contains a catalog, but value >…< could not be found in this catalog.

dms.XMLInsert (field value not in the assigned catalog) (verified)

-1019

The specified owner could not be determined.

-1022

The reference was not found.

-1030

An object type was not found on the DMS server. Server message: DMS object >…< in cabinet >< could not be found.

dms.GetResultList (unknown object type) (verified)

-1031

An object field was not found on the DMS server. Server message: The DMS field >…< could not be found. Note: dms.XMLImport returns -24 for the same message.

dms.GetResultList (unknown field) (verified)

-1044

The parent variant of the document could not be determined.

-1046

The document variant could not be determined. Server message: Document with ID … could not be found … not a version.

dms.XMLImport (variantparent_id points to a non-version or non-existent document) (verified)

-1049

The query was not found. Server message: Saved query with ID … was not found.

dms.ExecuteStoredQuery, dms.GetStoredQuery, dms.RemoveStoredQuery (unknown query ID) (verified)

-1052

The cabinet name could not be read.

-1053

The document name could not be read.

-1054

The register name could not be read.

-1062

The location of the object could not be determined.

-1073

The object could not be located in the DMS.

dms.ModPortfolio (non-existent document in PortfolioXML)

-1042218023

The specified login name is unknown. Server message: User name <…> is unknown. Corresponds to the documented output value Action = 2 but is returned as an error code.

krn.CheckUserAccount (verified)

-1040908085

The specified user was not found. Server message: User not found. Requested user name: <value>. The job expects the username; a user GUID also leads to this error.

mng.GetUserAttributes (unknown username or GUID in User, measured on 12.0 and 10.10) (verified)

-1042218742

The specified registry entry does not exist.

krn.REGetRegValue (verified)

-1042218753

Error in the resource administration. Server message: Error in the resource administration. Component: <component>, resource: <X>, error: <n>. For lic.LicGetModuleInfo (component GetASLicString, with the comment Please check the entries in the OS resources table.) the module has no license entry or the label is unknown; on 12.0, Flags = 1 avoids the error (see Modules Without a License Entry).

lic.LicGetModuleInfo (verified); adm.ResourceGetState without ResourceType (component ResourceLock) (observed)

-1043201745

The given note does not exist. Server message: Note (ID = 0x…) was not found. Besides an unknown note ID this also happens when the note exists but its text lives in the database: the three std remark jobs only find note files (see storage of notes). Likewise for dwObjectType = 32767 instead of the object type of the DMS object.

std.GetRemark, std.DeleteRemark (verified)

5. Invalid State / Invalid Operation

Code Meaning Jobs

Code	Meaning	Jobs
`-8`	The specified register is not in the specified folder.
`-9`	The specified document type is not allowed in the specified cabinet.
`-21`	The document has already been archived.
`-51`	The document has no pages.
`-68`	Moving folders is not allowed. Server message: `This operation is not allowed for an object of main type >0<`.	dms.XMLMove (moving a folder not allowed) (verified)
`-89`	The relationship between document and register is not allowed. Server message: `The relationship between document and register is not allowed`; for dms.XMLMove `The parent folder >…< was not found…` / `maximum count … will be exceeded`.	dms.XMLImport (document at an invalid location); dms.XMLMove (target folder not found / target capacity exceeded) (verified)
`-90`	Reference documents cannot be moved without specifying a location.
`-94`	Document pages are not allowed.
`-1002`	The key field is not unique. Server message: `Combination >…< of key fields already exists…`.	dms.XMLImport (key field combination not unique) (verified)
`-1005`	The specified object is connected to a workflow process.
`-1009`	The object is in the recycle bin. Server message: `The object is in the recycle bin`.	dms.XMLDelete (object already in recycle bin) (verified)
`-1010`	The document is in a portfolio.
`-1011`	The recursion depth is too large, the action was aborted.
`-1012`	The target register is a child of the register to be moved.
`-1014`	Pages cannot be added to a reference document.
`-1015`	The document cannot reference another document because it has pages.
`-1020`	The object type is invalid for this operation.
`-1021`	Cascade deletion is not allowed, the object still has child objects. Server message: `Cascade deletion is not allowed…`.	dms.XMLDelete (object still has child objects) (verified)
`-1036`	Only documents may be checked in and out. Server message: `Only documents can be checked in and out…`.	dms.CheckOutDocument (target object is not a document) (verified)
`-1037`	The document has been checked in. Server message: `The document was not checked out…`.	dms.UndoCheckOutDocument (document was not checked out) (verified)
`-1038`	The document has been checked out.
`-1039`	The document has been checked out to another user.
`-1040`	The document has been checked out to another station.
`-1041`	The document cannot be checked out because it has no pages. Server message: `The requested document contains no pages…`.	dms.CheckOutDocument (document without pages) (verified)
`-1042`	The document is not in the workflow storage.
`-1043`	The document is in the workflow storage.
`-1045`	New variants may only be created for W-documents.
`-1048`	A concurrent update of an object failed (outdated `concurrency_timestamp` / `OBJECT_MODIFYTIME`). Server message: `A concurrent update of an object failed`.	dms.XMLUpdate (verified)
`-1050`	The copy of the object already exists at the specified location.
`-1059`	The new variant was created but could not be set to 'Active'.
`-1061`	Moving or linking objects is locked system-wide.
`-1063`	The document already exists at the location.
`-1064`	Copying objects with key fields is not allowed.
`-1070`	'Error' was specified as the action for the hit count.	dms.XMLImport (source comment)
`-1040906168`	The user profile cannot be removed. Server message: `Unable to delete the profile, because it is still used by users or groups. Operation canceled.` Triggered by writing a user who has their own profile (`profil` = `0`) with `geaendert="0"` — the server reads that combination as "drop the profile". The whole job is cancelled, nothing is changed.	mng.SetUserAttributes (verified)
`-1042611991`	The given page number of a multi-field is outside the permitted range. Server message: `During insertion of a value into multi-field <Name>, the given page number was found to be out of the allowed range.` Permitted is `1` to the file count of the object (see `<MultiFields>`).	dms.XMLInsert, dms.XMLUpdate (verified)
`-1042610069`	Index data were specified for a document to be inserted without a type. Server message: `The document should be sent to the DMS without type, but index data have been specified for the document.` With `TYPELESS=1` the body must not contain a `<Fields>` element.	dms.XMLInsert (verified)
`-1042611918`	The main type is missing on a typeless insert. Server message: `The document should be added without type to the workflow or user tray, but no main type was specified.` `maintype` has to be on the `<Object>`, not on the `<ObjectType>`.	dms.XMLInsert (verified)
`-1042610059`	The object type cannot be determined. Server message: `There is not enough information to identify the object type. If the object should be typeless, it must be set as such.` For a typeless object `TYPELESS=1` has to be set.	dms.XMLDelete (verified)
`-1042609917`	A note link with text was rejected. Server message: `There are object links with text specified in the notes, but according to the server settings, only object links without text can be imported.` Depends on a server setting; the same link without text content is accepted.	dms.XMLInsert, dms.XMLUpdate (verified)
`-1042609859`	The XML job parameter was passed as a string instead of binary. Server message: `The job parameter XML contains XML and may not be a string in unicode systems - it should be given as a binary parameter.` The job aborts, no result document is delivered.	dms.GetResultList and every job with an XML parameter (verified)
`-1042609854`	A value of a text type was requested with `OutputUnicode` = `0`. Server message: `Under Unicode systems the job 'GetUserData' is not allowed anymore for text values, use the job 'GetUserDataAsString' for text values instead`. dms.GetUserData returns `-1` in this case; for dms.GetConfValues the message names a job `GetConfValuesAsString`. For dms.GetConfValues the type decides, not the content: `2` and `3` are blocked, also for an empty value, and a call with a blocked type in `ConfTypes` fails entirely. Pass `OutputUnicode` = `1` or use dms.GetUserDataAsString or `dms.GetConfValuesAsString`.	dms.GetUserData, dms.GetConfValues (types `2` and `3`, including the AS.INI) (verified)
`-1042612061`	A field named in the query does not exist on the object type. Triggered by an unknown `internal_name` in `<Fields>` as well as by `sortpos` on an unknown field. The job aborts.	dms.GetResultList (verified)
`-1042611967`	The maximum field length was exceeded. Server message: `The maximum field length (8000) of field >MEMO< is exceeded by value (…).` Appears in the error stack of `-1028` when a note text longer than 8000 characters is to be written under database note storage. The server does not truncate, it aborts.	dms.XMLInsert, dms.XMLUpdate (verified)
`-1042609876`	The OS event already exists. Server message: `Os event already exists. Event code: <code>; Class name: <class>; Parameters: ><params><`. A cause code in the error stack, not a return value: the job itself returns `-1`, and the error stack only adds `1104151584` without diagnostic value. The combination of `EventCode`, `OsClassName` and `OsEventParams` must be unique.	dms.CreateOsEvent (return value `-1`) (verified)

-8

The specified register is not in the specified folder.

-9

The specified document type is not allowed in the specified cabinet.

-21

The document has already been archived.

-51

The document has no pages.

-68

Moving folders is not allowed. Server message: This operation is not allowed for an object of main type >0<.

dms.XMLMove (moving a folder not allowed) (verified)

-89

The relationship between document and register is not allowed. Server message: The relationship between document and register is not allowed; for dms.XMLMove The parent folder >…< was not found… / maximum count … will be exceeded.

dms.XMLImport (document at an invalid location); dms.XMLMove (target folder not found / target capacity exceeded) (verified)

-90

Reference documents cannot be moved without specifying a location.

-94

Document pages are not allowed.

-1002

The key field is not unique. Server message: Combination >…< of key fields already exists….

dms.XMLImport (key field combination not unique) (verified)

-1005

The specified object is connected to a workflow process.

-1009

The object is in the recycle bin. Server message: The object is in the recycle bin.

dms.XMLDelete (object already in recycle bin) (verified)

-1010

The document is in a portfolio.

-1011

The recursion depth is too large, the action was aborted.

-1012

The target register is a child of the register to be moved.

-1014

Pages cannot be added to a reference document.

-1015

The document cannot reference another document because it has pages.

-1020

The object type is invalid for this operation.

-1021

Cascade deletion is not allowed, the object still has child objects. Server message: Cascade deletion is not allowed….

dms.XMLDelete (object still has child objects) (verified)

-1036

Only documents may be checked in and out. Server message: Only documents can be checked in and out….

dms.CheckOutDocument (target object is not a document) (verified)

-1037

The document has been checked in. Server message: The document was not checked out….

dms.UndoCheckOutDocument (document was not checked out) (verified)

-1038

The document has been checked out.

-1039

The document has been checked out to another user.

-1040

The document has been checked out to another station.

-1041

The document cannot be checked out because it has no pages. Server message: The requested document contains no pages….

dms.CheckOutDocument (document without pages) (verified)

-1042

The document is not in the workflow storage.

-1043

The document is in the workflow storage.

-1045

New variants may only be created for W-documents.

-1048

A concurrent update of an object failed (outdated concurrency_timestamp / OBJECT_MODIFYTIME). Server message: A concurrent update of an object failed.

dms.XMLUpdate (verified)

-1050

The copy of the object already exists at the specified location.

-1059

The new variant was created but could not be set to 'Active'.

-1061

Moving or linking objects is locked system-wide.

-1063

The document already exists at the location.

-1064

Copying objects with key fields is not allowed.

-1070

'Error' was specified as the action for the hit count.

dms.XMLImport (source comment)

-1040906168

The user profile cannot be removed. Server message: Unable to delete the profile, because it is still used by users or groups. Operation canceled. Triggered by writing a user who has their own profile (profil = 0) with geaendert="0" — the server reads that combination as "drop the profile". The whole job is cancelled, nothing is changed.

mng.SetUserAttributes (verified)

-1042611991

The given page number of a multi-field is outside the permitted range. Server message: During insertion of a value into multi-field <Name>, the given page number was found to be out of the allowed range. Permitted is 1 to the file count of the object (see <MultiFields>).

dms.XMLInsert, dms.XMLUpdate (verified)

-1042610069

Index data were specified for a document to be inserted without a type. Server message: The document should be sent to the DMS without type, but index data have been specified for the document. With TYPELESS=1 the body must not contain a <Fields> element.

dms.XMLInsert (verified)

-1042611918

The main type is missing on a typeless insert. Server message: The document should be added without type to the workflow or user tray, but no main type was specified. maintype has to be on the <Object>, not on the <ObjectType>.

dms.XMLInsert (verified)

-1042610059

The object type cannot be determined. Server message: There is not enough information to identify the object type. If the object should be typeless, it must be set as such. For a typeless object TYPELESS=1 has to be set.

dms.XMLDelete (verified)

-1042609917

A note link with text was rejected. Server message: There are object links with text specified in the notes, but according to the server settings, only object links without text can be imported. Depends on a server setting; the same link without text content is accepted.

dms.XMLInsert, dms.XMLUpdate (verified)

-1042609859

The XML job parameter was passed as a string instead of binary. Server message: The job parameter XML contains XML and may not be a string in unicode systems - it should be given as a binary parameter. The job aborts, no result document is delivered.

dms.GetResultList and every job with an XML parameter (verified)

-1042609854

A value of a text type was requested with OutputUnicode = 0. Server message: Under Unicode systems the job 'GetUserData' is not allowed anymore for text values, use the job 'GetUserDataAsString' for text values instead. dms.GetUserData returns -1 in this case; for dms.GetConfValues the message names a job GetConfValuesAsString. For dms.GetConfValues the type decides, not the content: 2 and 3 are blocked, also for an empty value, and a call with a blocked type in ConfTypes fails entirely. Pass OutputUnicode = 1 or use dms.GetUserDataAsString or dms.GetConfValuesAsString.

dms.GetUserData, dms.GetConfValues (types 2 and 3, including the AS.INI) (verified)

-1042612061

A field named in the query does not exist on the object type. Triggered by an unknown internal_name in <Fields> as well as by sortpos on an unknown field. The job aborts.

dms.GetResultList (verified)

-1042611967

The maximum field length was exceeded. Server message: The maximum field length (8000) of field >MEMO< is exceeded by value (…). Appears in the error stack of -1028 when a note text longer than 8000 characters is to be written under database note storage. The server does not truncate, it aborts.

dms.XMLInsert, dms.XMLUpdate (verified)

-1042609876

The OS event already exists. Server message: Os event already exists. Event code: <code>; Class name: <class>; Parameters: ><params><. A cause code in the error stack, not a return value: the job itself returns -1, and the error stack only adds 1104151584 without diagnostic value. The combination of EventCode, OsClassName and OsEventParams must be unique.

dms.CreateOsEvent (return value -1) (verified)

6. Access Denied

Code Meaning Jobs

Code	Meaning	Jobs
`-47`	The user does not have the required rights on the archive server.	dms.ModPortfolio (non-existent folder in `PortfolioXML`; the rights check precedes the existence check)
`-1003`	An attempt was made to set a read-only field.
`-1008`	A requested file could not be accessed.
`-1023`	The specified system field cannot be changed by the user.
`-1026`	It is not possible for the user to disable the rights check.
`-1065`	The specified password is incorrect. Server message: `The password entered by user >…< does not match…`.	krn.SessionChangePassword (wrong old password) (verified)
`-1042218021`	The supplied password is invalid. Server message: `Invalid password`. Occurs both for a wrong password and for a wrongly encoded one (plaintext instead of an encoded value). Corresponds to the documented output value `Action` = `4` but is returned as an error code.	krn.CheckUserAccount (verified)
`-1042218019`	The user account is locked. Server message: `Your user account is blocked. Please contact your system administrator.` Returned for a manually locked account as well as for one locked by failed logins — also with a correct password; the two cases are not distinguishable from the response. Corresponds to the documented output values `Action` = `3` / `5` but is returned as an error code. The two cases are distinguishable through the user attribute `locked` (`1` = manual, `2` = by failed logins; see Lockout Behaviour) and through the error stack of a context switch: a manual lock returns `-1042218150` with the same message there, whereas a lock caused by failed logins returns `-1042218334` or `-1042218331` (see Cause Codes in the Error Stack).	krn.CheckUserAccount (verified)
`-1042218022`	The calling user lacks system role `72` (Server: Switch job context, `R_SRV_SWITCH_CONTEXT`). Message: `The system role R_SRV_SWITCH_CONTEXT is not present.` The role is necessary and sufficient and independent of every other role.	krn.CheckUserAccount (verified); job calls using `$$$SwitchContextUser*$$$` (see Switching the User Context)
`-1066`	The new and old passwords are identical.
`-1069`	Access to a system resource was denied.	dms.GetObjectDetails (rights check before ID check) (observed)
`-1042674726`	The LIS license is missing although OSFTS is used with `intrafind`.	vtx.OpenObjectQuery
`-1040906164`	The calling user lacks system role `4` (Administrator: Configure security system). Message: `User {username} does not have permission to configure the security system. Please contact your administrator.` With an active context switch the role is checked on the target user, not on the logged-in account.	Modifying mng jobs for users and groups (e.g. mng.CreateUser); mng.GetUserRoles with the `UserGUID` of another user (verified)
`31523546`	The calling user lacks system role `109` (Server: Execute script, `R_SRV_SCRIPT_JOB`). Message: `Job <krn.RunScript> can only be executed by a user who owns the system roles [R_SRV_SCRIPT_JOB(109)]`. The value is HRESULT-style encoded (`0x1E102DA`); the low word `0x2DA` (`730`) carries the actual error.	krn.RunScript (verified)

-47

The user does not have the required rights on the archive server.

dms.ModPortfolio (non-existent folder in PortfolioXML; the rights check precedes the existence check)

-1003

An attempt was made to set a read-only field.

-1008

A requested file could not be accessed.

-1023

The specified system field cannot be changed by the user.

-1026

It is not possible for the user to disable the rights check.

-1065

The specified password is incorrect. Server message: The password entered by user >…< does not match….

krn.SessionChangePassword (wrong old password) (verified)

-1042218021

The supplied password is invalid. Server message: Invalid password. Occurs both for a wrong password and for a wrongly encoded one (plaintext instead of an encoded value). Corresponds to the documented output value Action = 4 but is returned as an error code.

krn.CheckUserAccount (verified)

-1042218019

The user account is locked. Server message: Your user account is blocked. Please contact your system administrator. Returned for a manually locked account as well as for one locked by failed logins — also with a correct password; the two cases are not distinguishable from the response. Corresponds to the documented output values Action = 3 / 5 but is returned as an error code.
The two cases are distinguishable through the user attribute locked (1 = manual, 2 = by failed logins; see Lockout Behaviour) and through the error stack of a context switch: a manual lock returns -1042218150 with the same message there, whereas a lock caused by failed logins returns -1042218334 or -1042218331 (see Cause Codes in the Error Stack).

krn.CheckUserAccount (verified)

-1042218022

The calling user lacks system role 72 (Server: Switch job context, R_SRV_SWITCH_CONTEXT). Message: The system role R_SRV_SWITCH_CONTEXT is not present. The role is necessary and sufficient and independent of every other role.

krn.CheckUserAccount (verified); job calls using $$$SwitchContextUser*$$$ (see Switching the User Context)

-1066

The new and old passwords are identical.

-1069

Access to a system resource was denied.

dms.GetObjectDetails (rights check before ID check) (observed)

-1042674726

The LIS license is missing although OSFTS is used with intrafind.

vtx.OpenObjectQuery

-1040906164

The calling user lacks system role 4 (Administrator: Configure security system). Message: User {username} does not have permission to configure the security system. Please contact your administrator.
With an active context switch the role is checked on the target user, not on the logged-in account.

Modifying mng jobs for users and groups (e.g. mng.CreateUser); mng.GetUserRoles with the UserGUID of another user (verified)

31523546

The calling user lacks system role 109 (Server: Execute script, R_SRV_SCRIPT_JOB). Message: Job <krn.RunScript> can only be executed by a user who owns the system roles [R_SRV_SCRIPT_JOB(109)]. The value is HRESULT-style encoded (0x1E102DA); the low word 0x2DA (730) carries the actual error.

krn.RunScript (verified)

7. Collective Codes with the Cause in the Error Stack

Two operations check a user account without naming the reason for the rejection in the return value: the context switch via $$$SwitchContextUserName$$$ or $$$SwitchContextUserGUID$$$ (see Switching the User Context) and the login with krn.SessionLogin. Both return a collective code; why access failed is available in the error stack only.

Code Meaning Jobs

Code	Meaning	Jobs
`-1043332467`	Collective code: the context switch is not possible. The code originates solely from resolving the `$$$SwitchContext…$$$` parameters and is identical for all causes — it does not distinguish a deleted target user from a blocked or expired one. The cause is in the error stack (see Cause Codes in the Error Stack). The code does not relate to a job’s functional user parameters (such as `UserGUID` of mng.GetUserRoles).	Arbitrary jobs with a context switch — verified among others with mng.GetUserRoles, mng.GetUserList, krn.GetServerInfo and krn.VerifyPassword (verified)
`1105265282`	Collective code: the session login was refused. Server message: `Login for user <name> (session <guid>) could not be executed, error: <inner code>`. The value is positive and HRESULT-style encoded. It is identical for a wrong password, a manually locked account and one locked by failed logins — the cause is in the error stack (see Cause Codes in the Error Stack).	krn.SessionLogin (verified)

-1043332467

Collective code: the context switch is not possible. The code originates solely from resolving the $$$SwitchContext…$$$ parameters and is identical for all causes — it does not distinguish a deleted target user from a blocked or expired one. The cause is in the error stack (see Cause Codes in the Error Stack).
The code does not relate to a job’s functional user parameters (such as UserGUID of mng.GetUserRoles).

Arbitrary jobs with a context switch — verified among others with mng.GetUserRoles, mng.GetUserList, krn.GetServerInfo and krn.VerifyPassword (verified)

1105265282

Collective code: the session login was refused. Server message: Login for user <name> (session <guid>) could not be executed, error: <inner code>. The value is positive and HRESULT-style encoded. It is identical for a wrong password, a manually locked account and one locked by failed logins — the cause is in the error stack (see Cause Codes in the Error Stack).

krn.SessionLogin (verified)

7.1. Cause Codes in the Error Stack

The actual cause is carried by the first evaluable entry of the error stack (on the error stack see Introduction); entries without diagnostic value are listed under Entries Without Diagnostic Value and are to be skipped when evaluating.

Code Server Message State of the User

Code	Server Message	State of the User
`1105265591`	`User GUID <X> is unknown. Context switch is not possible.`	Does not exist or has been deleted (verified)
`-1042218150`	`Your user account is blocked. Please contact your system administrator.`	Blocked (`locked`) (verified)
`-1042218334`	`User account <name> locked. Login is not possible.` — the name reads `?` where the job cannot resolve it	Locked by failed logins; the `locked` attribute still carries the marker `2` (see Lockout Behaviour) (verified)
`-1042218331`	`Login failed three times.`	Locked by failed logins, after a write with mng.SetUserAttributes has replaced the marker `locked` = `2` with `0` (verified)
`-1042218315`	`Login for user <X> valid up to <point in time>.`	Validity expired (`validto` in the past) (verified)
`-1042218317`	`Login for user <X> is valid from <point in time>.`	Not yet valid (`validfrom` in the future) (verified)

1105265591

User GUID <X> is unknown. Context switch is not possible.

Does not exist or has been deleted (verified)

-1042218150

Your user account is blocked. Please contact your system administrator.

Blocked (locked) (verified)

-1042218334

User account <name> locked. Login is not possible. — the name reads ? where the job cannot resolve it

Locked by failed logins; the locked attribute still carries the marker 2 (see Lockout Behaviour) (verified)

-1042218331

Login failed three times.

Locked by failed logins, after a write with mng.SetUserAttributes has replaced the marker locked = 2 with 0 (verified)

-1042218315

Login for user <X> valid up to <point in time>.

Validity expired (validto in the past) (verified)

-1042218317

Login for user <X> is valid from <point in time>.

Not yet valid (validfrom in the future) (verified)

The server message always says "User GUID", even when switching by user name:

with $$$SwitchContextUserName$$$ the name appears in place of the GUID (User GUID NOPE_XYZ is unknown),
with $$$SwitchContextUserGUID$$$ the server does not echo the GUID at all — the message then reads User GUID is unknown with an empty spot.

The message is therefore unsuitable for recovering the addressed user.

7.2. Entries Without Diagnostic Value

Every rejected response additionally contains entries that carry no indication of the cause. An evaluation of the error stack should skip them and treat the first remaining entry as the cause.

Code Content

Code	Content
`-1043333107`	`SEH exception thrown at 0x…: 0xC0000005, access violation` including a stack trace. Part of the server-side error path, not an indication of its own (verified)
`1104151584`	Empty message (verified)
`30408714`	Memory statistics of the server process (`VirtualBytes=…`) (verified)

-1043333107

SEH exception thrown at 0x…: 0xC0000005, access violation including a stack trace. Part of the server-side error path, not an indication of its own (verified)

1104151584

Empty message (verified)

30408714

Memory statistics of the server process (VirtualBytes=…) (verified)

The order of the entries in the error stack was stable across all measurements but is not guaranteed. An evaluation should search the error stack for the known cause codes instead of relying on a fixed position.

8. Diagnostic Entries with Return Value `0`

Some jobs return 0 and still put entries into the error stack that explain a functionally negative finding or warn about a condition. These codes are not job failures; error handling that only checks the return value does not see them.

Code Meaning Jobs

Code	Meaning	Jobs
`1105265534`	The module has no license entry. Server message: `The module <X> is not licensed.` Followed by `1105265061`.	lic.CheckLicense (`Result` = `602`) (verified)
`1105265171`	Unknown module label: the label is missing from the module catalog (osresources, `resourcetype` = `0`). Server message: `Requested resource <X> is unknown.`	lic.CheckLicense (`Result` = `602`), lic.LicCheckThreshold (verified)
`1105265196`	The license (type `N` or `U`) is not shared for the calling station. Server message: `The named license <X> is not shared for station <station>.` The message says "named license" for licenses of type `U` as well. Followed by `1105265061`.	lic.CheckLicense (`Result` = `602`) (verified)
`1105265061`	Follow-up entry without information of its own. Server message: `The queried resource is not available for the client.` Follows `1105265534` and `1105265196`.	lic.CheckLicense (verified)
`-2115959887`	Warning: the usage of a module has reached the warning threshold. Server message: `Threshold of 90% reached for module <X>, current count <n>, max count <m>.`	lic.LicCheckThreshold (verified)
`-2115960338`	Warning: notifying the administrator by e-mail is switched off in the configuration. Server message: `No e-mail can be sent to the administrator, because this feature is switched off in the configuration.` Follows `-2115959887`.	lic.LicCheckThreshold (verified)

1105265534

The module has no license entry. Server message: The module <X> is not licensed. Followed by 1105265061.

lic.CheckLicense (Result = 602) (verified)

1105265171

Unknown module label: the label is missing from the module catalog (osresources, resourcetype = 0). Server message: Requested resource <X> is unknown.

lic.CheckLicense (Result = 602), lic.LicCheckThreshold (verified)

1105265196

The license (type N or U) is not shared for the calling station. Server message: The named license <X> is not shared for station <station>. The message says "named license" for licenses of type U as well. Followed by 1105265061.

lic.CheckLicense (Result = 602) (verified)

1105265061

Follow-up entry without information of its own. Server message: The queried resource is not available for the client. Follows 1105265534 and 1105265196.

lic.CheckLicense (verified)

-2115959887

Warning: the usage of a module has reached the warning threshold. Server message: Threshold of 90% reached for module <X>, current count <n>, max count <m>.

lic.LicCheckThreshold (verified)

-2115960338

Warning: notifying the administrator by e-mail is switched off in the configuration. Server message: No e-mail can be sent to the administrator, because this feature is switched off in the configuration. Follows -2115959887.

lic.LicCheckThreshold (verified)

Error Codes

1. Job-Dependent Specifics

2. Parameter Errors by Namespace

3. General Errors

4. Object / Resource Not Found

5. Invalid State / Invalid Operation

6. Access Denied

7. Collective Codes with the Cause in the Error Stack

7.1. Cause Codes in the Error Stack

7.2. Entries Without Diagnostic Value

8. Diagnostic Entries with Return Value 0

8. Diagnostic Entries with Return Value `0`