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 HCL® 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 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( ).