NO FRAMES

CPXgetcallbacknodestat

int CPXPUBLIC CPXgetcallbacknodestat(CPXCENVptr env, void * cbdata, int wherefrom, int * nodestat_p)
Definition file: cplex.h
Include files: cplex.h
Note

This is an advanced routine. Advanced routines typically demand a profound understanding of the algorithms used by ILOG CPLEX. Thus they incur a higher risk of incorrect behavior in your application, behavior that can be difficult to debug. Therefore, ILOG encourages you to consider carefully whether you can accomplish the same task by means of other Callable Library routines instead.

The routine CPXgetcallbacknodestat is used to get the optimization status of the subproblem at the current node from within a user-written callback during MIP optimization.

The optimization status will be either optimal or unbounded. An unbounded status can occur when some of the constraints are being treated as lazy constraints. When the node status is unbounded, then the function CPXgetcallbacknodex returns a ray that can be used to decide which lazy constraints need to be added to the subproblem.

This routine may be called only when the value of the wherefrom argument is CPX_CALLBACK_MIP_CUT.

Example

 status = CPXgetcallbacknodestat (env, cbdata, wherefrom,
                                  &nodestatus);

Parameters:

env

A pointer to the CPLEX environment, as returned by CPXopenCPLEX.

cbdata

The pointer passed to the user-written callback. This parameter must be the value of cbdata passed to the user-written callback.

wherefrom

An integer value indicating from where the user-written callback was called. The parameter must be the value of wherefrom passed to the user-written callback.

nodestat_p

A pointer to an integer where the node subproblem optimization status is to be returned. The values of *nodestat_p may be CPX_STAT_OPTIMAL or CPX_STAT_UNBOUNDED.

Returns:

The routine returns zero on success and nonzero if an error occurs.