FB_HomeIn - RegisterLoggerPoint (Methode)

Übersicht

Typ	Methode
Verfügbar ab	1.4.0.0

Aufgabe

Die Methode registriert den internen Logger-Punkt im Anwendungslogger.

Beschreibung

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

Nach der Registrierung:

oDer Funktionsbaustein sendet automatisch Nachrichten an den Anwendungslogger.

oDie Enumeration 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 Logger-Punkt, unter dem der Logger-Punkt des Funktionsbausteins registriert werden soll. Die globale Variable G_ifApplicationLogger ist auch ein Logger-Punkt.
i_sName	STRING[80]	Der Name für den Logger-Punkt des Funktionsbausteins, der im Anwendungslogger 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 Diagnosemeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer, diagnosebezogener Ausgang. 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 Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer, diagnosebezogener Ausgang.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Fehlermeldung

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	Ok	0	OK
InputParameterInvalid	MaxNumberOfLoggerPointsExeeded	318	Die maximale Anzahl von Logger-Punkten wurde überschritten.
InputParameterInvalid	ParentInvalid	316	Das übergeordnete Objekt ist ungültig.
InputParameterInvalid	ParentNotRegistered	317	Das übergeordnete Objekt ist nicht registriert.
UnexpectedProgramBehavior	UnexpectedDiagExt	17	DiagExt ist unbeabsichtigt.

MaxNumberOfLoggerPointsExeeded

Enumerationsname:	MaxNumberOfLoggerPointsExeeded
Enumerationswert:	318
Beschreibung:	Die maximale Anzahl von Logger-Punkten wurde überschritten.

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

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	OK

Der Logger-Punkt wurde erfolgreich im Anwendungslogger registriert.

ParentInvalid

Enumerationsname:	ParentInvalid
Enumerationswert:	316
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

Enumerationsname:	ParentNotRegistered
Enumerationswert:	317
Beschreibung:	Das übergeordnete Objekt ist nicht registriert.

Problem	Ursache	Lösung
-	Der am Eingang i_ifParent übergebene Logger-Punkt ist nicht im Anwendungslogger registriert.	Der an den Eingang i_ifParent übergebene Logger-Punkt muss zuerst im Anwendungslogger registriert werden.

UnexpectedDiagExt

Enumerationsname:	UnexpectedDiagExt
Enumerationswert:	17
Beschreibung:	DiagExt ist unbeabsichtigt.

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