Procedure GMP::Instance::SetCallbackStatusChange(GMP, callback)

GMP::Instance::SetCallbackStatusChange

The procedure GMP::Instance::SetCallbackStatusChange installs a callback procedure that is called every time the status changes during the solution process.

GMP::Instance::SetCallbackStatusChange(
     GMP,            ! (input) a generated mathematical program
     callback        ! (input) an AIMMS procedure
     )

Arguments

GMP

An element in AllGeneratedMathematicalPrograms.

callback

A reference to a procedure in the set AllIdentifiers.

Return Value

The procedure returns 1 on success, or 0 otherwise.

Note

  • The callback procedure should have exactly one argument; a scalar input element parameter into the set AllSolverSessions.

  • The CallbackStatusChange callback procedure should have a return value of

    • 0, if you want the solution process to stop, or

    • 1, if you want the solution process to continue.

  • To remove the callback the empty element should be used as the callback argument.

  • This procedure is not supported by COPT.

See also

The routines GMP::Instance::Generate, GMP::Instance::SetCallbackAddCut, GMP::Instance::SetCallbackAddLazyConstraint, GMP::Instance::SetCallbackBranch, GMP::Instance::SetCallbackCandidate, GMP::Instance::SetCallbackHeuristic, GMP::Instance::SetCallbackIncumbent, GMP::Instance::SetCallbackIterations and GMP::Instance::SetCallbackTime.