Documentation Home
MySQL NDB Cluster API Developer Guide
Download this Manual ndb_mgm_stop3()

Description.  Like ndb_mgm_stop() and ndb_mgm_stop2(), this function stops one or more data nodes. Like ndb_mgm_stop2(), it offers the ability to specify whether the nodes should shut down gracefully. In addition, it provides for a way to check to see whether disconnection is required prior to stopping a node.


int ndb_mgm_stop3
      NdbMgmHandle handle,
      int          number,
      const int*   list,
      int          abort,
      int*         disconnect

Parameters.  ndb_mgm_stop3() takes 5 parameters:

  • An NdbMgmHandle.

  • The number of nodes to be stopped. Use 0 to stop all of the data nodes in the cluster.

  • A list of the node IDs of the nodes to be stopped.

  • The value of abort determines how the nodes will be shut down. 1 indicates the nodes will shut down immediately; 0 indicates that the nodes will stop gracefully.

  • If disconnect returns 1 (true), this means the you must disconnect before you can apply the command to stop. For example, disconnecting is required when stopping the management server to which the handle is connected.

Return value.  The number of nodes actually stopped; in the event of failure, -1 is returned.