DLM API Error Codes
DLM API functions use a unified set of error codes defined in
dlmdef.h. All error codes have negative values.
If unsuccessful, most API functions return a negative error code indicating
the reason for the failure. The auxiliary function, dlm_ErrorMessage(),
translates error return codes into human-readable strings.
As negative return values indicate failure, non-negative return values indicate success.
A few DLM API functions return values other than the negative error codes for failure
or the non-negative values for success. For instance, the functions
return the current state as defined in dlmdef.h.
Alphabetical Listing of Error Codes
- The monitor authentication failed.
- There was a failure on the established connection.
- The attempted connection has not completed.
- The file's normal end of file was found.
- The connection attempt failed.
- The module failed to initialize.
- A failure occurred when trying to open the file.
- A failure occurred when trying to read from the file.
- A failure occurred when trying to write to the file.
- The file could not be found.
- The DLM command is not valid for the state of the API.
- The file was invalid.
- The id value was NULL.
- The line id is greater than the number of valid sessions.
- The parameters input are invalid for the function requested.
- The monitor authentication failed due to an invalid password.
- The requested operation cannot be performed because the memory
could not be allocated.
- The module is not in the proper state to perform the desired event or
the protocol version is incorrect.