ILOG CPLEX 11.0 User's Manual

◆ CPX_TUNE_TILIM specifies that tuning reached a time limit specified as a parameter inthe environment.Tuning will set any parameters which have been chosen even if there is an early termination.Callbacks for TuningA tuning callback is a user-written function that ILOG CPLEX calls before each trial runduring a tuning session. A tuning callback allows you to follow the progress of tuning. Itreports information that enables you to estimate how much more time tuning needs toachieve results useful in your model.To use a tuning callback in a tuning session, you must first write the callback function, andthen pass it to ILOG CPLEX. ILOG CPLEX will then execute your tuning callback before itbegins a trial run.◆◆In Concert Technology, you must implement your user-written function as an instance ofthe tuning callback class.●●IloCplex::TuningCallbackI in the C++ APIIloCplex.TuningCallback in the Java API● Cplex.TuningCallback in the .NET APIFor details about writing your tuning callback, see Using Optimization Callbacks onpage 445, especially Implementing Callbacks in ILOG CPLEX with Concert Technologyon page 454In the Callable Library (C API), use the routine CPXsettuningcallbackfunc. Formore about how to write a callback, see also Implementing Callbacks in the CallableLibrary on page 460.Terminating a Tuning SessionTo terminate a tuning session, you can use one of the following means:◆◆In the C++ API, pass an instance of the class IloCplex::Aborter to an instance ofIloCplex. Then call the method IloCplex::Aborter::abort to terminate thetuning session.In the Java API, pass an instance of the class IloCplex.Aborter to an instance ofIloCplex. Then call the method IloCplex.Aborter.abort to terminate the tuningsession.ILOG CPLEX 11.0 — USER’ S MANUAL 167