mi_integer mi_command_is_finished(conn)
   MI_CONNECTION *conn;

conn

is a pointer to a connection descriptor established by a previous call to mi_open( ), mi_server_connect( ), or mi_server_reconnect( ).

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 terminated the statement abnormally.

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.

0

indicates that the current statement active on the current connection has not completed.

1

indicates that the current statement active on the current connection has completed.

MI_ERROR

indicates that the function was not successful.

See also the descriptions of mi_get_result( ), mi_open( ), mi_query_finish( ), mi_server_connect( ), and mi_server_reconnect( ).