Registration of callback routines

Topics
	Mandatory callback routines
	The callback routines that must be implemented by the user.
	Optional callback routines
	The callback routines that can be used to enhance the solution algorithm.

Detailed Description

Registration methods for callback routines to interact with the CONOPT solution algorithm.

Same as for the initialisation methods, all routines are integer functions with names starting with coidef_ or COIDEF_. The registration methods will return an error code with the following interpretation:

• 0: No error was detected
• 1: The Control Vector has been corrupted (or it has not been initialized using coiCreate())
• 2: The argument is out of range, i.e. has an illegal value such as a negative number for the number of variables.

All registration of callback routines must occur before CONOPT is started.

The callback routines cover aspects of the solution algorithm including, reading the matrix, function and derivative evaluations, message handling, options and status reporting. The callback routines are separated into mandatory and optional callback routines. The mandatory routines must be provided by the user for CONOPT to be able to run. The optional routines can be provided to enhance the solution algorithm.