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_resourcegrooup_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.