Register a module
To register a module,
run the SYSBldPrepare( ) function with the 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 module reference is the installed name and version number of the module, which you can see in the $INFORMIXDIR/extend directory. The version string that follows the 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 module reference is the installed name and version number of the module, which you can see in the $INFORMIXDIR/extend directory. The version string that follows the 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 modules
on which the module specified in the first argument is dependent.
For example, suppose you create a WorldView module
that is dependent on the Map module.
The following SPL statement registers the specified version of the
WorldView module
and implicitly registers the highest installed version of the Map 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 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( ).