Register a DataBlade module

To register a DataBlade module, run the SYSBldPrepare( ) function with the DataBlade module reference and the 'create' arguments.

For the complete calling syntax and the signature of the SYSBldPrepare( ) function, see its description in the IBM® Informix® Guide to SQL: Syntax.

The DataBlade module reference is the installed name and version number of the DataBlade module, which you can see in the $INFORMIXDIR/extend directory. The version string that follows the DataBlade module name can be replaced by or truncated with the asterisk (*) wildcard, which instructs SYSBldPrepare( ) to register the highest installed version of the specified module.

The following call to the SYSBldPrepare( ) function instructs the database server to register the highest installed version of a DataBlade module named Map:

EXECUTE FUNCTION sysbldprepare('map.*','create');

Successful invocation of the SYSBldPrepare( ) function with 'create' as its second argument also registers any DataBlade modules on which the module specified in the first argument is dependent. For example, suppose you create a WorldView DataBlade module that is dependent on the Map DataBlade module. The following SPL statement registers the specified version of the WorldView DataBlade module and implicitly registers the highest installed version of the Map DataBlade module on which it has a dependency:

LET y = sysbldprepare('worldview.1.0.TC1','create');

Here the LET statement assigns to the variable y the returned status code from the call to SYSBldPrepare( ). If y = 0, the registration succeeded.

If the dependency Map DataBlade module is already registered, no action to register it is taken, even if the currently registered version is not the highest installed version.

Calls to the SYSBldPrepare( ) function can return error messages. For information about these error messages, see Exceptions in calls to SYSBldPrepare( ).