Initializing help system before first use

XPRSaddcbmsjobend

Purpose
Add a user callback to be called every time a new multistart job finishes. Can be used to overwrite the default solution ranking function
Topic areas
Callback, Multistart
Synopsis
int XPRS_CC XPRSaddcbmsjobend(XPRSprob prob, int (XPRS_CC *msjobend)(XPRSprob cbprob, void *cbdata, void *jobdata, const char *jobdesc, int *p_status), void *data, int priority);
Arguments
prob 
The current problem.
msjobend 
The function to be called when a multistart job finishes
cbprob 
The problem passed to the callback function.
cbdata 
The user-defined object passed as data to XPRSaddcbmsjobend.
jobdata 
Job specific user-defined object, as specified by the multistart job creating API functions.
jobdesc 
The description of the problem as specified by the multistart job creating API functions.
p_status 

User return status variable:

0 - use the default evaluation of the finished job

1 - disregard the result and continue

2 - stop the multistart search
data 
User data passed to the callback function.
priority 
An integer that determines the order in which callbacks of this type will be invoked. The callback added with a higher priority will be called before a callback with a lower priority. Set to 0 if not required.
Further information
The multistart pool is dynamic, and this callback can be used to load new multistart jobs using the normal API functions.
Related topics
XPRSaddcbmsjobstart, XPRSaddcbmswinner XPRSremovecbmsjobend

Parent Topic Library functions

© 2001-2025 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.