sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Program Interface | cmm_membership_remove(3CMM)

- NAME
- SYNOPSIS
- DESCRIPTION
- RETURN VALUES
- ATTRIBUTES
- SEE ALSO

## NAME

> cmm_membership_remove - remove peer node

## SYNOPSIS

>     cc [ flag... ] file...  -lcgha_cmm  -lrt

>     #include <cmm.h>

> `cmm_error_t cmm_membership_remove( );`

## DESCRIPTION

> The cmm_membership_remove() function removes the node from which this function is called from the cluster. The node is still configured to be in the cluster, but its role has changed. The CMM API is always accessible for an `CMM_OUT_OF_CLUSTER` node.

> When the `nhcmmd` daemon detects that a node is no longer part of the cluster, it informs other applications or services that are registered to receive notification. See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on the notifications returned in different scenarios.

> To reintegrate a node into the cluster after the cmm_membership_remove() function has been called on the node, restart the node's `nhcmmd` daemon by rebooting the node.

> Note that after the cmm_membership_remove() call, a node is still to be configured to be in the cluster, but it has the `CMM_OUT_OF_CLUSTER` role. Because it is still configured to be in the cluster, it can access cluster information:

> - Functions that retrieve information on the cluster state can still be called by the node

> - Functions that modify the cluster state can no longer be called by the node

> This is different from a node not being configured for any cluster. If the node is not configured for any cluster, the `CMM_ENOCLUSTER` value is returned.

> Any program running on the node can call cmm_membership_remove(). There is no authentication carried out of the program making the call. Calling this function from the master leads to a failover (or `CMM_ECANCELED` if no vice-master can take the mastership role).

## RETURN VALUES

> The cmm_membership_remove() function returns one of the following values:

> `CMM_EBUSY`

>   The CMM API server is temporarily out of resources to respond to the requested operation. The recommended action is to wait a short time and retry the operation. The length of the waiting must be decided by the user, depending on the application's characteristics.

> `CMM_ECANCELED`

>   Operation canceled. The function was called on the master node but the vice-master node was not qualified to become master.

> `CMM_ECONN`

>   No `nhcmmd` is accessible to the current node.

> `CMM_ENOCLUSTER`

>   The calling node is not yet in a cluster.

> `CMM_ENOTSUP`

>   An unexpected service error occurred. The cluster might be in a critical state.

> `CMM_ETIMEDOUT`

>   The call timeout expired before the action was completed.

> `CMM_OK`

>   Operation succeeds.

## ATTRIBUTES

> See `attributes`(5) for descriptions of the following attributes:

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | SPARC
> Availability | SUNWnhcmd
> Interface Stability | Evolving
> MT-Level | MT-Safe
> Cancel-Safety | Deferred-Cancel-Safe Asynchronous-Cancel-Unsafe

## SEE ALSO

> `Intro`(3CMM), `nhcmmd`(1M)

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.