General Purpose Functions

The functions in this section provide a broad range of functionality. These functions enable you to perform the following operations:

• Initialize the DSDL environment

• Retrieve resource, resource type, and resource group names, and extension property values

• Failover and restart a resource group and restart a resource

• Convert error strings to error messages

• Execute a command under a timeout

The following functions initialize the calling method:

• scds_initialize(3HA) – allocate resources and initialize the DSDL environment.

• scds_close(3HA) – free resources allocated by scds_initialize.

The following functions retrieve information about resources, resource types, resource groups, and extension properties:

• scds_get_resource_name(3HA) – retrieve the name of the resource for the calling program.

• scds_get_resource_type_name(3HA) – retrieve the name of the resource type for the calling program.

• scds_get_resource_group_name(3HA) – retrieve the name of the resource group for the calling program.

• scds_get_ext_property(3HA) – retrieve the value of the specified extension property.

• scds_free_ext_property(3HA) – free the memory allocated by scds_get_ext_property.

The following function retrieves status information about the SUNW.HAStoragePlus resources that are used by a resource:

• scds_hasp_check(3HA) – retrieves status information about SUNW.HAStoragePlus(5) resources that are used by a resource. This information is obtained from the state (online or otherwise) of all SUNW.HAStoragePlus resources on which the resource depends by using the Resource_dependencies or Resource_dependencies_weak system properties that are defined for the resource.

The following functions fail over or restart a resource or resource group:

• scds_failover_rg(3HA) – fail over a resource group.

• scds_restart_rg(3HA) – restart a resource group.

• scds_restart_resource(3HA) – restart a resource.

The following functions execute a command under a timeout and convert an error code to an error message:

• scds_timerun(3HA) – execute a command under a timeout value.

• scds_error_string(3HA) – translate an error code to an error string.