Sun Cluster 3.1 Data Services Developer's Guide

Resource Group Functions

You can access information about or restart a resource group with these functions.

scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA), and scha_resourcegroup_close(3HA)

Together these functions access information on a resource group managed by the RGM. The scha_resourcegroup_open function initializes access to a resource group and returns a handle for scha_resourcegroup_get, which accesses the resource group information. The scha_resourcegroup_close function invalidates the handle and frees memory allocated for scha_resourcegroup_get return values.

A resource group can change, through cluster reconfiguration or administrative action, after scha_resourcegroup_open returns the resource group's handle, in which case the information scha_resourcegroup_get obtains through the handle could be inaccurate. In cases of cluster reconfiguration or administrative action on a resource group, the RGM returns the scha_err_seqid error code to scha_resourcegroup_get to indicate information about the resource group might have changed. This is a non-fatal error message; the function returns successfully. You can choose to ignore the message and accept the returned information, or you can close the current handle and open a new handle to access information about the resource group.

A single man page describes these three functions. You can access this man page through any of the individual functions, scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA), or scha_resourcegroup_close(3HA)

scha_control(3HA)

Requests the restart of a resource group under the control of the RGM or its relocation to a different node.