Funciones de C

Las funciones de C se deben usar en las implementaciones del programa de C de los métodos de rellamada para los tipos de recursos que representan servicios controlados por RGM del clúster. Puede utilizar estas funciones para:

• Acceder a información sobre recursos, tipos de recursos, grupos de recursos y clústers

• Utilizarlos con un supervisor para establecer las propiedades Status y Status_msg de un recurso

• Solicitar el reinicio o la reubicación de un grupo de recursos

• Convertir un código de error en un mensaje de error adecuado

Esta sección proporciona descripciones breves de las funciones de C; las páginas de comando man individuales de (3HA) sirven de referencia definitiva para las funciones de C. Cada función tiene una página de comando man del mismo nombre, salvo que se indique lo contrario. Consulte la página de comando man de scha_calls(3HA) para obtener información sobre los argumentos de salida y códigos de retorno de las funciones de C.

Funciones de los recursos

Estas funciones permiten acceder a información sobre un recurso gestionado por RGM o indicar el estado del recurso, como lo percibe el supervisor.

scha_resource_open(), scha_resource_get () y scha_resource_close()

Estas funciones, juntas, permiten acceder a información sobre un recurso gestionado por RGM. La función scha_resource_open() inicializa el acceso a un recurso y devuelve un manejador para scha_resource_get(), que accede a la información del recurso. La función scha_resource_close() anula el manejador y libera la memoria asignada para los valores de retorno de scha_resource_get().

Un recurso puede cambiar, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resource_open() devuelva el manejador del recurso, en cuyo caso la información que obtiene scha_resource_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_resource_get() para indicar que la información acerca del recurso puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorarlo y aceptar la información devuelta o cerrar el manejador actual y abrir uno nuevo para acceder a la información del recurso.

Una sola página de comando man describe estas tres funciones; es accesible a través de cualquiera de ellas, scha_resource_open(3HA), scha_resource_get(3HA) o scha_resource_close(3HA).

scha_resource_setstatus()

Establece las propiedades Status y Status_msg de un recurso controlado por RGM. El supervisor del recurso utiliza esta función para indicar el estado del recurso.

---

Nota –

scha_resource_setstatus() es especialmente útil para un supervisor de recursos, cualquier programa puede invocarlo.

---

Funciones del tipo de recurso

Estas funciones, juntas, permiten acceder a información sobre un tipo de recurso registrado con RGM.

scha_resourcetype_open(), scha_resourcetype_get(), scha_resourcetype_close()

La función scha_resourcetype_open() inicializa el acceso a un recurso y devuelve un manejador para scha_resourcetype_get() que accede a la información de tipo de recurso. La función scha_resourcetype_close() invalida el manejador y libera la memoria asignada para los valores de retorno de scha_resourcetype_get().

Un tipo de recurso puede cambiar, mediante una reconfiguración de clúster o un acción administrativa, después de que scha_resourcetype_open() devuelva el manejador del tipo de recurso, en cuyo caso la información que obtiene scha_resourcetype_get () a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un tipo de recurso, RGM devuelve el código de error scha_err_seqid a scha_resourcetype_get() para indicar que la información acerca del tipo de recurso puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del tipo de recurso.

Una sola página de comando man describe estas tres funciones; es accesible a través de cualquiera de ellas, scha_resourcetype_open(3HA), scha_resourcetype_get(3HA) o scha_resourcetype_close(3HA).

Funciones del grupo de recursos

Estas funciones permiten acceder a información acerca del grupo de recursos o reiniciarlo.

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

Estas funciones, juntas, permiten acceder a información sobre un grupo de recursos gestionado por RGM. La función scha_resourcegroup_open() inicializa el acceso a un grupo de recursos y devuelve un manejador para scha_resourcegroup_get(), que accede a la información del grupo de recursos. La función scha_resourcegroup_close() invalida el manejador y libera la memoria asignada para los valores de retorno de scha_resourcegroup_get().

Un grupo de recursos puede cambiar, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resourcegroup_open() devuelva el manejador del grupo de recursos, en cuyo caso la información que obtiene scha_resourcegroup_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_resourcegroup_get() para indicar que la información acerca del grupo de recursos puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del grupo de recursos.

scha_control( 3HA)

Solicita el reinicio de un grupo de recursos controlado por RGM o su reubicación en un nodo diferente.

Funciones del clúster

Estas funciones permiten acceder a información sobre un clúster o la devuelven.

scha_cluster_open(3HA), scha_cluster_get(3HA), scha_cluster_close(3HA)

Estas funciones, juntas, permiten acceder a información sobre un clúster, como los nombres de nodos, ID, estados, nombre del clúster, grupos de recursos, etc.

Un clúster puede cambiar, mediante una reconfiguración o una acción administrativa, después de que scha_cluster_open() devuelva el manejador del clúster, en cuyo caso la información que obtiene scha_cluster_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_cluster_get() para indicar que la información acerca del clúster puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del clúster.

scha_cluster_getlogfacility(3HA)

Devuelve el número del recurso de registro del sistema que se está usando como registro del clúster. Utiliza el valor devuelto con la función syslog() de Solaris para registrar mensajes de estado y eventos en el registro del clúster.

scha_cluster_getnodename(3HA)

Devuelve el nombre del nodo del clúster en el que se invoca la función.

Función de utilidad

Esta función convierte un código de error en un mensaje de error.

scha_strerror(3HA)

Traduce un código de error, devuelto por una de las funciones scha_, al mensaje de error adecuado. Utilice esta función con logger para introducir los mensajes en el registro del sistema (syslog).