FC_SetWarning

Descripción general

Tipo:

Función

Disponible desde:

V1.1.0.0

G-SE-0065034.1.gif-high.gif

 

 

Descripción funcional

La función FC_SetWarning es una función auxiliar que permite escribir mensajes informativos en la etiqueta de administración adecuada y también eliminarlos de la etiqueta. Cada mensaje informativo se identifica de manera exclusiva mediante su identificador exclusivo y el valor asociado. El identificador y su valor se especifican mediante el parámetro de entrada o salida iq_stSetWarning, que se corresponde con el parámetro de entrada o salida iq_astWarnings[#].

Esta función no se puede utilizar simultáneamente en varias tareas.

Mediante la entrada iq_stSetWarning, puede transmitirse a la función un mensaje informativo específico de la máquina.

La etiqueta de administración Admin.Warning[#] debe transmitirse a la función a través del parámetro de entrada o salida iq_astWarnings. Representa la lista de mensajes informativos activos de la unidad en orden cronológico empezando por el mensaje informativo generado en primer lugar que permanece activo.

Si se ejecuta la función con la entrada i_xSetWarning = TRUE, esta comprueba si el mensaje informativo especificado ya se encuentra en la lista de mensajes informativos activos. En caso contrario, la función obtiene el RTC del controlador y lo escribe junto con el mensaje informativo especificado en la lista de mensajes informativos activos. Si se alcanza el número máximo de mensajes de la lista, los nuevos mensajes no se añadirán.

Si se ejecuta la función con i_xSetWarning = FALSE, el mensaje informativo especificado se eliminará de la lista de mensajes informativos activos.

Si se ejecuta la función con las entradas i_xAckWarning y i_xSetWarning = TRUE, esta obtendrá el RTC del controlador y actualizará el parámetro (etiqueta) AckDateTime correspon­diente al mensaje informativo especificado en la lista de mensajes informativos activos. Si ya se ha emitido un acuse de recibo para un mensaje informativo, las nuevas peticiones de acuse de recibo no tendrán efecto.

El valor de retorno de la función indica TRUE si el mensaje informativo especificado se ha escrito en la lista, se ha eliminado de ella o se ha configurado para el envío de un acuse de recibo. Si la función devuelve FALSE, significa que no se ha solicitado ninguna acción o bien que se ha alcanzado el número máximo de mensajes de la lista.

Interfaz

Entrada

Tipo de datos

Descripción

i_xSetWarning

BOOL

Petición para escribir (TRUE) el mensaje especificado en la lista vinculada a iq_astWarnings o eliminarlo (FALSE) de ella.

i_xWarningAck

BOOL

Petición para enviar un acuse de recibo de un mensaje informativo activo.

Entrada/Salida

Tipo de datos

Descripción

iq_stSetWarning

ST_InitAlarm

Especifica el mensaje informativo que tratará la función.

iq_astWarnings        

ARRAY [1..Gc_uiMaxNumberOfWarnings] OF ST_Alarm

La etiqueta de administración Admin.Warning[#] debe vincularse a esta entrada/salida.

iq_diNumberOfActiveWarnings

DINT

Indica el número de mensajes informativos de la lista.