INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_server_reconnect()

The mi_server_reconnect() function reestablishes a dropped connection.

Syntax

Usage

The mi_server_reconnect() function can be used by a callback that handles the MI_LIB_DROPCONN client library event.

If the dropped connection represented a login session to a particular database, mi_server_reconnect() logs into that database.

All resources that belonged to the connection when it failed, such as memory and save sets, are preserved and do not need to be rebuilt. However, any transactions that were in progress when the connection failed are no longer valid, so it is the responsibility of the application to purge invalid rows out of save sets.

Return Values

MI_OK

The function was successful.

MI_ERROR

The function was not successful. You cannot reconnect to a database server to which you are already connected.

Related Topics

For additional information, see the descriptions of the following functions: mi_open() and mi_server_connect().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.