ReportFailure

<< 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 Elipse Power na Área de Notificações do Windows. Quando este método é usado, o ícone do Elipse Power 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

Esta página foi útil?