4.2.6. Error Handling - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English

Almost all functions in the AOCL-DA C API return a da_status enumerated type. If the function exited successfully then this will take the value da_status_success, otherwise the value will indicate the type of error that was encountered.

Functions which take a da_handle or da_datastore as their first argument will store further information about any errors that have been encountered. This information can be extracted using da_handle_print_error_message() or da_datastore_print_error_message(). Error messages prepended with “DA_WARN” indicate that a problem was encountered but the computation was able to continue. The returned result is potentially useful but the user should check the output. Error messages prepended with “DA_ERROR” indicate that the computation was unable to complete and no useful result is returned.