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 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.
EXECUTE FUNCTION sysbldprepare('map.*','create');
'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( ).