Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_save_set_create() function creates a save set on the current connection.

MI_SAVE_SET *mi_save_set_create(conn)

MI_CONNECTION *conn;

conn	is a pointer to the connection descriptor 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_save_set_create() function is a constructor function for a save set. A save set is an area of memory used to store rows fetched from a DataBlade API function. It provides a mechanism for manipulating multiple database rows in memory. Rows stored in a save set can be traversed with the DataBlade API functions mi_save_set_get_first(), mi_save_set_get_next(), and mi_save_set_get_previous().

The mi_save_set_create() function allocates a new save-set structure in the PER_STATEMENT memory duration.

When the DataBlade API module no longer requires the save set, free the save-set resources with mi_save_set_destroy(). A save set is freed when the connection on which it was created is closed.

See the descriptions of the following functions: mi_save_set_delete(), mi_save_set_get_first(), mi_save_set_get_last(), mi_save_set_get_next(), mi_save_set_get_previous(), and mi_save_set_insert().