[Previous] [Next]

XPRBinit

Purpose

Initialize BCL.

Synopsis

int XPRBinit(void);  

Return value

0	function executed successfully:
1	an error has occurred:
32	BCL has been set running in Student mode.

Example

XPRBseterrctrl(0);
if(XPRBinit())
  printf("BCL has not been initialized correctly.
          Please check your Xpress-MP licenses.");

This switches to user error handling and initializes BCL (or performs license test).

Further information

1. This function explicitly initializes BCL, that is it tests whether a license for running this software is available. It is possible to run BCL with a student license; this mode implies restrictions to the available functionality and to the accepted problem size.

2. The initialization is also performed by function XPRBnewprob so that usually there is no need to call this explicit initialization. This function may be used if the embedding of BCL into some larger application requires a test of the license at an earlier stage, before even creating any model. Note that this function also initializes Xpress-Optimizer, so that it is usually not necessary to call XPRSinit separately (the latter is only required if one wishes to continue using the optimizer after terminating BCL).