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_member_seizequalif(3CMM)

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

## NAME

> cmm_member_seizequalif - requalify current master-eligible node

## SYNOPSIS

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

>     #include <cmm.h>

> `cmm_error_t cmm_member_seizequalif();`

## DESCRIPTION

> The cmm_member_seizequalif() function qualifies the current node as the master node when there is no master node.

> The cmm_member_seizequalif() function must be called from a node that is master-eligible and has the attribute `CMM_ELIGIBLE_MEMBER`. If there is no master in the cluster, cmm_member_setqualif() cannot be called. If a node already exists with the attribute `CMM_QUALIFIED_MEMBER`, this call returns `CMM_EPERM`.

## EXTENDED DESCRIPTION

> There are two outcomes of calling cmm_member_seizequalif() from a master-eligible node: either the node becomes master or it reverts to the qualification level it had prior to the cmm_member_seizequalif() function. This function returns a `CMM_EPERM` error if a master is already up and running or if the current node is not master-eligible. Note that if the node was previously `CMM_SYNCHRO_NEEDED` (flag S) it will not be elected as master if its former role was master.

> See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for further information on qualification levels.

> Necessary notifications are sent according to the impact of this call. See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on possible notifications.

## RETURN VALUES

> The cmm_member_seizequalif() 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_ECONN`

>   No `nhcmmd` is currently accessible to the local node.

> `CMM_ENOTSUP`

>   An unexpected service error occurred.

> `CMM_EPERM`

>   Permission denied. Either the function was not called from a master-eligible node, or a master is already running.

> `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), `cmm_member_setqualif`(3CMM)

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.