Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_file_allocate() function ensures that a specified number of files are available to be opened.

mi_integer mi_file_allocate(num_files)

mi_integer num_files;

num_files

specifies how many file descriptors to allocate.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_file_allocate() function allocates num_files number of file descriptors for use with operating-system calls such as UNIX open() or fopen().

Tip: Informix provides the mi_file_allocate() function for backward compatibility only. This function is no longer required for file access in DataBlade API modules. In new code, use DataBlade API file-access functions such as mi_file_open() and mi_file_close().

This function does not perform any tasks when called within a user-defined routine.

The mi_file_allocate() function does not throw an MI_Exception event when it encounters a runtime error. Therefore, it does not cause callbacks to be invoked.

See the description of the mi_file_open() function.