Resource Functions

These functions access information about a resource managed by the RGM or indicate the state of the resource as perceived by the monitor.

• scha_resource_open(3HA), scha_resource_get(3HA), and scha_resource_close(3HA) - Together these functions access information on a resource managed by the RGM. The scha_resource_open function initializes access to a resource and returns a handle for scha_resource_get, which accesses the resource information. The scha_resource_close function invalidates the handle and frees memory allocated for scha_resource_get return values.

  A resource can change--through cluster reconfiguration or administrative action--after scha_resource_open returns the resource's handle, in which case the information scha_resource_get obtains through the handle could be inaccurate. In cases of cluster reconfiguration or administrative action on a resource, the RGM returns the scha_err_seqid error code to scha_resource_get to indicate information about the resource 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.

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

• scha_resource_setstatus(3HA) - Sets the Status and Status_msg properties of a resource under the control of the RGM. The resource's monitor uses this function to indicate the resource's state.

  ---

  Note -

  Although scha_resource_setstatus is of particular use to a resource monitor, any program can call it.

  ---