ILOG CPLEX 11.0 User's Manual > Programming Considerations > Tuning Tool > Tuning Models in the Callable Library (C API)

The routine CPXtuneparam tunes one existing model, and the routine CPXtuneparamprobset tunes a group of models, specified by an array of file names.

Both these routines are applicable to models of one of these types: LP, QP, QCP, and MIP. (Neither applies to networks.) Advanced bases in .sav files are ignored by these routines. Acceptable file formats for these routines are:

Parameter settings in the environment control the resources for the tuning tool; the parameter settings passed in the arguments of these routines are used by ILOG CPLEX as a starting point for tuning. You can specify parameters and corresponding values for ILOG CPLEX to use as a starting point. Bear in mind that the parameters you specify at nondefault settings will be fixed during the tuning. That is, the tuning tool will not attempt to modify them. In other words, when you set a parameter as a starting point, you eliminate it from consideration by the tuning tool.

Callbacks (except the tuning callback) are ignored by these tuning routines in the Callable Library (C API).

The tuning tool checks the termination signal (that is, the variable set by the routine CPXsetterminate) and terminates the tuning process in compliance with that termination signal. Tuning also respects time limits set in the environment.

The result of either tuning routine is an environment containing the parameter settings recommended by tuning. You can query these values or write them to a formatted PRM file with the usual routines.

After tuning, the return value of either routine specifies 0 (zero) when tuning completed successfully and nonzero when it has not done so. A tuning status is also returned as an argument to these routines. The possible nonzero values of the tuning status argument are these:

Tuning will set any parameters which have been chosen even if there is an early termination.