The function ilcpo_fail_stop_here is useful when you are running a CP Optimizer program from a debugger, such as dbx: you can stop the execution on failures. You can set a breakpoint for the function ilcpo_fail_stop_here to stop the program after each failure. You do that like this:

 (dbx) stop in ilcpo_fail_stop_here

On some platforms, you may need to prefix an underscore to the name of the function, like this: _ilcpo_fail_stop_here.

For more information, see the concept Failure in CP Optimizer.