ILOG CPLEX 11.0 User's Manual > Advanced Programming Techniques > Using Goals > Special Goals in Branch & Cut > Fail Goal

A Fail goal creates a goal that causes ILOG CPLEX to prune the current node. In other words, it discontinues the search at the node where the goal is executed. ILOG CPLEX will continue with another active node from the tree, if one is available.

In the C++ API, a Fail goal is returned by IloCplex::GoalI::FailGoal

In the Java API, a Fail goal is returned by the method IloCplex.failGoal.

In the .NET API, a Fail goal is returned by the method Cplex.FailGoal.