|
<< Clique para Mostrar o Sumário >>
ReportFailure |
ReportFailure(FailureName, FailureDescription, FailureWeight)
Este método permite que uma aplicação reporte falhas para o Servidor, que podem ser visualizadas clicando com o botão direito do mouse no ícone do E3 na Área de Notificações do Windows. Quando este método é usado, o ícone do E3 na Área de Notificações do Windows começa a piscar em vermelho, indicando a ocorrência da falha. As falhas reportadas são normalmente condições que impedem que a aplicação funcione parcialmente (problema de comunicação em uma porta serial, link de rede inativo, banco de dados sem conexão, etc.), e que normalmente não podem ser detectadas pelo Servidor. Este método tem duas finalidades:
•Avisar o operador do sistema a respeito de problemas em um servidor
•Auxiliar o gerenciador automático de Hot-Standby a decidir qual servidor está mais apto para executar a aplicação
NOTA |
O método ReportFailure só está disponível no Servidor. |
O método ReportFailure possui os parâmetros descritos na tabela a seguir.
Parâmetros do método ReportFailure
Nome |
Descrição |
|---|---|
FailureName |
Contém o nome da falha (definido pelo usuário). Este mesmo parâmetro deve ser passado para o método ClearFailure quando a aplicação detectar que a falha não está mais ativa. Por exemplo, "Falha COM1" |
FailureDescription |
Descrição textual da falha (definida pelo usuário). Por exemplo, "Falha de comunicação na porta COM1" |
FailureWeight |
Define a severidade (ou peso) da falha. O valor 0 (zero) indica um aviso (sem gravidade). Valores maiores que zero indicam falhas. Quanto maior o valor, mais grave é a falha |
Exemplo:
Sub TagEstadoSerial_OnValueChanged()
If Value then
' O valor do Tag é True, indica que está em falha
Application.ReportFailure "FALHA_COM1", "Falha de "_
& "comunicação na COM1", 100
Else
' O valor do Tag é False, limpa a falha
' (indica que está OK)
Application.ClearFailure "FALHA_COM1"
End If
End Sub