Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_command_is_finished() function reports whether the current statement has finished executing.

mi_integer mi_command_is_finished(conn)

MI_CONNECTION *conn;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_command_is_finished() function determines whether execution has completed for the current statement on the connection that conn references. The current statement is the most recently executed SQL statement sent to the database server on that connection. The current statement is finished when either of the following conditions occurs:

• Successful completion

The database server has executed the statement and the DataBlade API module has retrieved the last row from any query.

• Unsuccessful completion

A database server exception has aborted the statement.

The current statement must be finished before the database server can process the next statement. Use the mi_query_finish() function to force a statement to finish processing.

See the descriptions of the following functions: mi_server_connect(), mi_get_result(), and mi_query_finish().