通用函数

本节中介绍的函数具有很多功能。 使用这些函数，您可以：

• 初始化 DSDL 环境

• 检索资源、资源类型和资源组名称以及扩展特性值

• 进行故障切换并重启资源组以及重启资源

• 将错误字符串转换成错误消息

• 在超时值定义的时间之内执行命令

以下函数用来初始化调用方法。

• scds_initialize — 用来分配资源和初始化 DSDL 环境。

• scds_close — 用来释放通过 scds_initialize 分配的资源。

以下函数用来检索有关资源、资源类型、资源组和扩展特性的信息。

• scds_get_resource_name — 用来检索调用程序的资源的名称。

• scds_get_resource_type_name — 用来检索调用程序的资源类型的名称。

• scds_get_resource_group_name — 用来检索调用程序的资源组的名称。

• scds_get_ext_property — 用来检索指定扩展特性的值。

• scds_free_ext_property — 用来释放通过 scds_get_ext_property 分配的内存。

以下函数检索某资源所使用的 SUNW.HAStoragePlus 资源的状态信息。

• scds_hasp_check — 用来检索某资源所使用的 SUNW.HAStoragePlus 资源的状态信息。 使用为该资源定义的 Resource_dependencies 或 Resource_dependencies_weak 系统特性，从资源依赖的所有 SUNW.HAStoragePlus 资源的状态（联机或其它）中获取此信息。

  有关 SUNW.HAStoragePlus 的详细信息，请参阅 SUNW.HAStoragePlus(5)。

以下函数用来进行故障切换或重启资源或资源组。

• scds_failover_rg — 用来故障切换资源组。

• scds_restart_rg — 用来重启资源组。

• scds_restart_resource — 用来重启资源。

以下两个函数用来在超时值定义的时间之内执行命令，并将错误代码转换成错误消息。

• scds_timerun — 用来在超时值定义的时间之内执行命令。

• scds_error_string — 用来将错误代码转换成错误字符串。