mi_integer mi_qual_funcid(MI_AM_QUAL_DESC *qualDesc);

qualDesc

points to the qualification descriptor.

To execute a registered UDR or an internal function with DataBlade API Fastpath facility, the access method needs a valid routine identifier. The mi_qual_funcid() function provides a routine identifier, if available, for the strategy function.

If mi_qual_funcid() returns a positive number, the routine identifier exists in the sysprocedures system catalog table, and the database server can execute the function. A negative return value from the mi_qual_funcid() function can indicate a valid function if the database server loads an internal function in shared memory but does not describe the function in sysprocedures.

A positive integer is the routine identifier by which the database server recognizes a function.

A negative return value indicates that the sysprocedures system catalog table does not have a routine identifier for the function.

In this book, see the descriptions of:

• Accessor function mi_qual_funcname()
• Using the Routine Identifier
• Using FastPath

In the IBM Informix: DataBlade API Programmer's Guide, see the descriptions of:

• The function descriptor (MI_FUNC_DESC data structure) and its accessor functions
• Fastpath function execution, including DataBlade API functions mi_func_desc_by_typeid() and mi_routine_exec()