MySQL :: MySQL Cluster API Developer Guide :: 3.2.4.10 ndb_mgm_set_connectstring()

Skip navigation links

MySQL Cluster API Developer Guide :: 3 The MGM API :: 3.2 MGM C API Function Listing :: 3.2.4 Management Server Connection Functions :: 3.2.4.10 ndb_mgm_set_connectstring()

« 3.2.4.9 ndb_mgm_set_bindaddress()

3.2.4.11 ndb_mgm_set_configuration_nodeid() »

Section Navigation [Toggle]

3.2.4.10. `ndb_mgm_set_connectstring()`

Description. This function is used to set the connectstring for a management server connection to a node.

Signature.

int ndb_mgm_set_connectstring
    (
      NdbMgmHandle handle,
      const char*  connectstring
    )

Parameters. ndb_mgm_set_connectstring() takes two parameters:

A management server handle.
A connectstring whose format is shown here:
```
connectstring :=
    [nodeid-specification,]host-specification[,host-specification]
```
ndb_mgm_get_connectstring() also uses this format for connectstrings.

It is possible to establish connections with multiple management servers using a single connectstring.
```
nodeid-specification := nodeid=id
host-specification := host[:port]
```
id, port, and host are defined as follows:
- id: An integer greater than 0 identifying a node in config.ini.
- port: An integer referring to a standard Unix port.
- host: A string containing a valid network host address.

Return value. This function returns -1 in the event of failure.

Top / Previous / Next / Up / Table of Contents

© 2012, Oracle Corporation and/or its affiliates