Purpose
Initializes the Optimizer library. This must be called before any other library routines.
Synopsis
int XPRS_CC XPRSinit(const char *xpress);
Argument
|
xpress
|
The directory where the FICO Xpress password file is located. Users should employ a value of
NULL unless otherwise advised, allowing the standard initialization directories to be checked.
|
Example
The following is the usual way of calling
XPRSinit :
if(XPRSinit(NULL)) printf("Problem with XPRSinit\n");
Further information
1. Whilst
error checking should always be used on all library function calls, it is especially important to do so with the initialization functions, since a majority of errors encountered by users are caused at the initialization stage. Any nonzero return code indicates that no license could be found. In such circumstances the application should be made to exit. A return code of
32, however, indicates that a student license has been found and the software will work, but with restricted functionality and problem capacity. It is possible to retrieve a message describing the error by calling
XPRSgetlicerrmsg.
2. In multi-threaded applications where all threads are equal,
XPRSinit may be called by each thread prior to using the library. Whilst the process of initialization will be carried out only once, this guarantees that the library functions will be available to each thread as necessary. In applications with a clear master thread, spawning other Optimizer threads, initialization need only be called by the master thread.
Related topics
© 2001-2020 Fair Isaac Corporation. All rights reserved. This documentation is the
property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not
convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except
solely for internal evaluation purposes to determine whether to purchase a license to the software
described in this documentation, or as otherwise set forth in a written software license agreement
between you and FICO (or a FICO affiliate). Use of this documentation and the software described in
it must conform strictly to the foregoing permitted uses, and no other use is permitted.
