mi_integer am_open(MI_AM_TABLE_DESC *tableDesc)

tableDesc

points to the index descriptor.

As part of the initialization, am_open:

• Determines the reason, or mode, for the open, as described in mi_tab_mode()
• Allocates PER_STATEMENT memory for a user-data structure as described in Persistent User Data
• Opens a database connection with the DataBlade API mi_open() function

  To enable subsequent purpose functions to use the database, am_open can copy the connection handle that mi_open() returns into the user-data structure.

• Registers callback functions to handle exceptions, as described in Handling the Unexpected
• Calls the appropriate DataBlade API functions to obtain a file handle for an extspace or an LO handle for a smart large object
• Calls mi_setniorows() to set the number of entries for which the database server should allocate memory

  For more information, refer to Building New Indexes Efficiently.

MI_OK indicates success. MI_ERROR indicates failure.

See the descriptions of:

• Purpose function am_close
• Memory allocation, callback functions, and the functions to open files or smart large objects in the IBM Informix: DataBlade API Programmer's Guide
• mi_tab_mode() and mi_tab_setniorows() in Descriptor Function Reference
• Starting and Ending Processing