20.1.38 ead_get_original_master_node() (acquires information about the original source EADS server)

(1) Description

This function acquires information about the original source EADS server that stores a specified key (or group).

By original source EADS server is meant the EADS server that stores the master copy (source data) of a specified key (or group) when all EADS servers making up the cluster can be connected successfully. This EADS server might be different from the current source EADS server.

If there have been no changes to the cluster configuration, information about the same EADS server will always be acquired, regardless of whether the EADS server can be connected.

To Page Top

(2) Format

#include <eads.h>
ead_node ead_get_original_master_node
(
  const EAD_CACHE_MANAGER     *cmp,          /* In */
  const char                  *key,          /* In */
  int                         *error_code    /* Out */
);

To Page Top

(3) Arguments

cmp

Specifies a handle (pointer) to the cache manager that manages the cache.

Specify a handle obtained from ead_init_client() or ead_init_client_n().

key

Specifies a key (or a group).

For details about the data types that can be specified, see 15.2.2(1) Data types that can be specified as keys.

error_code

Specifies the pointer from which to retrieve the error code.

For details about error codes, see 20.2 Error codes in the client library (C).

To Page Top

(4) Return value

This function returns information about the original source EADS server that stores the specified key (or group).

If the function terminates abnormally, it sets 0 in each member of the ead_node structure.

To Page Top

(5) Notes

• Execution of this function does not establish communication with the EADS server. Therefore, the returned information about the connection-target EADS server might not be the most recent information.

• If you plan to use the acquired EADS server as a connection target, use the is_enable member of the ead_node structure to check whether a connection can be established with that EADS server. For details about the is_enable member of the ead_node structure, see 20.1.50(2) Descriptions of members.

To Page Top