FB_ExceptionHandler - RegisterLoggerPoint (Methode)

Übersicht

Typ	Methode
Verfügbar ab	1.3.0.0

Aufgabe

Methode zum Anmelden des internen Loggerpunkts am Application Logger

Beschreibung

Im Funktionsbaustein ist ein Loggerpunkt für den Application Logger implementiert. Nach einem erfolgreichen Aufruf dieser Methode sendet der Funktionsbaustein Nachrichten an den Application Logger. Die Methode entspricht dem Aufruf der Methode RegisterLoggerPoint am APL.FB_LoggerPoint.

Nach der Registrierung:

oDer Funktionsbaustein sendet automatisch Nachrichten an den Application Logger.

oDie Aufzählung APL.ET_LogLevel (Protokollebene) beschreibt den Typ und die Wichtigkeit einer Meldung.

oJe nach Funktionsbaustein werden verschiedene Informationen innerhalb einer Meldung weitergeleitet (z. B. eine Liste mit Diagnoseausgängen).

Schnittstelle

Eingang	Datentyp	Beschreibung
i_ifParent	APL.IF_LoggerPoint	Der übergeordnete Loggerpunkt, unter dem der Loggerpunkt des Funktionsbausteins registriert werden soll. Die globale Variable G_ifApplicationLogger ist auch ein Loggerpunkt.
i_sName	STRING[80]	Der Name für den Loggerpunkt des Funktionsbausteins, der im Application Logger angezeigt werden soll, muss hier definiert werden.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Fehlermeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer Ausgang des Diagnosegeräts. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Fehlermeldung

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Fehlermeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer Ausgang des Diagnosegeräts.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Fehlermeldung

Diagnosemeldungen

q_etDiag	q_etDiagExt	Aufzählungswert	Beschreibung
OK	Ok	0	OK
InputParameterInvalid	MaxNumberOfLoggerPointsExeeded	161	Die maximale Anzahl an Loggerpunkten wurde überschritten.
InputParameterInvalid	ParentInvalid	159	Das übergeordnete Objekt ist ungültig.
InputParameterInvalid	ParentNotRegistered	160	Das übergeordnete Objekt ist nicht registriert.
UnexpectedProgramBehavior	UnexpectedDiagExt	147	Es ist ein unerwarteter Fehler während der Ausführung aufgetreten.

MaxNumberOfLoggerPointsExeeded

Aufzählungsname:	MaxNumberOfLoggerPointsExeeded
Aufzählungswert:	161
Beschreibung:	Die maximale Anzahl an Loggerpunkten wurde überschritten.

Problem	Ursache	Lösung
-	Es wurde versucht, mehr als APL.Gc_udiMaxNumberOfLoggerPoints Loggerpunkte am Application Logger zu registrieren.	Der globale Parameter APL.Gc_udiMaxNumberOfLoggerPoints muss erhöht werden.

Aufzählungsname:	Ok
Aufzählungswert:	0
Beschreibung:	OK

Der Loggerpunkt wurde erfolgreich am Application Logger registriert.

ParentInvalid

Aufzählungsname:	ParentInvalid
Aufzählungswert:	159
Beschreibung:	Das übergeordnete Objekt ist ungültig.

Problem	Ursache	Lösung
-	Am Eingang i_ifParent wurde ein ungültiges Objekt übergeben.	Dem Eingang i_ifParent muss ein Objekt vom Typ APL.FB_LoggerPoint oder APL.IF_ApplicationLogger übergeben werden.

ParentNotRegistered

Aufzählungsname:	ParentNotRegistered
Aufzählungswert:	160
Beschreibung:	Das übergeordnete Objekt ist nicht registriert.

Problem	Ursache	Lösung
-	Der am Eingang i_ifParent übergebene Loggerpunkt ist nicht am Application Logger registriert.	Der am Eingang i_ifParent übergebene Loggerpunkt muss zuvor am Application Logger registriert werden.

UnexpectedDiagExt

Aufzählungsname:	UnexpectedDiagExt
Aufzählungswert:	147
Beschreibung:	Es ist ein unerwarteter Fehler während der Ausführung aufgetreten.

Problem	Ursache	Lösung
-	Es ist ein Fehler in der internen Abarbeitung aufgetreten.	Bitte informieren Sie das Supportteam über diesen Fehler.