Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

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


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 TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhcmd
Interface StabilityEvolving
MT-LevelMT-Safe
Cancel-SafetyDeferred-Cancel-Safe Asynchronous-Cancel-Unsafe

SEE ALSO

Intro(3CMM), cmm_member_setqualif(3CMM)


Netra HAS FS 2.1Go To TopLast Changed September 2004