Error Handling
Error Codes
OpenAPI generates the following error codes.
E_AP0001_CONNECTION_ABORTED
The connection between the application and the server has been severed. A server error message also may be available.
E_AP0002_TRANSACTION_ABORTED
The server aborted the current transaction. A server error message also may be available.
E_AP0003_ACTIVE_TRANSACTIONS
The application requested an operation that can be performed only when no transactions are active on the connection.
E_AP0004_ACTIVE_QUERIES
The application requested an operation that can be performed only when no queries are active on the connection.
E_AP0005_ACTIVE_EVENTS
The application requested an operation that can be performed only when no database event requests are active on the connection.
E_AP0006_INVALID_SEQUENCE
The application invoked a function that violated the OpenAPI order of processing.
E_AP0007_INCOMPLETE_QUERY
The application attempted to close a query that had not yet completed processing. The application should cancel the query instead.
E_AP0008_QUERY_DONE
The application attempted to cancel a query that had completed processing. The application should close the query instead.
E_AP0009_QUERY_CANCELLED
The query was cancelled by a call to IIapi_cancel().
E_AP000A_QUERY_INTERRUPTED
Copy statement processing interrupted by the server.
E_AP000B_COMMIT_FAILED
The server was unable to commit the transaction.
E_AP000C_2PC_REFUSED
The server was unable to prepare the distributed transaction to be committed. The transaction should be rolled back.
E_AP000D_PARAMETERS_REQUIRED
The specified query type requires parameters, but the application indicated that no parameters would be provided.
E_AP000E_INVALID_CONNECT_PARM
The server rejected a connection parameter or value.
E_AP000F_NO_CONNECT_PARMS
IIapi_modifyConnect() was called with no prior calls to IIapi_setConnectParam().
E_AP0010_INVALID_COLUMN_COUNT
The number of parameter or column values being sent or retrieved did not match what the OpenAPI expected.
E_AP0011_INVALID_PARAM_VALUE
A parameter value was not within the permissible range of values.
E_AP0012_INVALID_DESCR_INFO
The ds_dataType or ds_columnType of at least one of the descriptor entries was invalid.
E_AP0013_INVALID_POINTER
A required pointer parameter was NULL.
E_AP0014_INVALID_REPEAT_ID
The repeat query being executed was no longer available to the server. The application should define and re-execute the repeat query.
E_AP0015_INVALID_TRANS_STMT
The application attempted a transaction commit or rollback by using IIapi_query(). Use IIapi_commit() or IIapi_rollback() to manage transactions.
E_AP0016_ROW_DISCARDED
A cursor pre-fetch result row was received, but all OpenAPI buffers were filled with unread result rows. The row was discarded.
E_AP0017_SEGMENT_DISCARDED
The column and row count parameters for IIapi_getColumns() only permitted the first segment of a BLOB column to be returned.
E_AP0018_INVALID_DISCONNECT
A disconnect request was made while the connection was already in the process of disconnecting.
E_AP0019_TUPLE_TRUNCATED
Server failed to send all expected data.
E_AP001F_BATCH_UNSUPPORTED
Server does not support batch operations.
E_AP0020_BYREF_UNSUPPORTED
BYREF procedure parameters are not supported at connection level IIAPI_LEVEL_0.
E_AP0021_GTT_UNSUPPORTED
Global Temporary Table procedure parameters are not supported at connection level IIAPI_LEVEL_0.
E_AP0023_INVALID_NULL_DATA
A data value was marked as NULL (dv_null set to TRUE) when the associated descriptor indicated non-nullable (ds_nullable set to FALSE).
E_AP0024_INVALID_DATA_SIZE
The ds_length of at least one of the descriptor entries was invalid.
E_AP0025_SVC_DATA_TYPE
The ds_dataType of at least one of the descriptor entries, whose ds_columntType was IIAPI_COL_SVCPARM, was invalid.
E_AP0028_LVL1_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_1.
E_AP0029_LVL2_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_2.
E_AP002A_LVL3_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_3.
E_AP002B_LVL4_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_4.
E_AP002C_LVL5_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_5.
E_AP002D_LVL6_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_6.
E_AP002E_LVL7_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_7.
E_AP002F_LVL8_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_8.
E_AP0030_LVL9_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_9.
E_AP0031_LVL10_DATA_TYPE
The ds_dataType of at least one of the descriptor entries specified a type that is not supported below connection level IIAPI_LEVEL_10.