FB_LoggerPoint - RegisterLoggerPoint (Methode)

Überblick

Typ	Methode
Verfügbar ab	V1.0.4.0

Aufgabe

Der Logger-Punkt wird durch Aufrufen dieser Methode im Application Logger registriert. Die Methode RegisterLoggerPoint des internen FB_LoggerPoint wird aufgerufen, um sich selbst im Application Logger zu registrieren.

Beschreibung

Der Logger-Punkt wird im globalen Application Logger registriert.

Der Maschinen- bzw. Programmteil, der Logger-Meldungen über diesen Logger-Punkt sendet, wird durch die Eingänge i_sName, i_sType und i_sSource definiert. Diese Information ist mit jeder Logger-Meldung, die über diesen Logger-Punkt versendet wird, verknüpft.

Der Eingang i_ifParent definiert, unter welchem anderen Logger-Punkt dieser Logger-Punkt registriert werden muss. Der globale Application Logger G_ifApplicationLogger ist auch ein Logger Punkt.

Aus diesem Grund können die Logger-Punkte in Form einer Baumstruktur registriert werden, die den Aufbau des Programms darstellt.

Nähere Informationen finden Sie unter Verwendung des Application Loggers.

Schnittstelle

Eingabe	Datentyp	Beschreibung
i_ifParent	IF_LoggerPoint	Der übergeordnete Logger-Punkt, unter dem der Logger-Punkt des Funktionsbausteins registriert werden muss. Der globale Application Logger G_ifApplicationLogger ist auch ein Logger Punkt.
i_sName	STRING[80]	Der Name des Logger-Punkts, der im Application Logger angezeigt wird, muss hier deklariert werden.
i_sType	STRING[80]	Um den Logger-Knoten festzulegen, muss ein Typ zugewiesen werden. Mit Hilfe dieses Typs können ähnliche Teile des Projekts bestimmt werden wie z. B. Modultyp, Funktionsbausteintyp. Die Funktionsbausteine der Schneider Electric-Bibliotheken legen den Namen des Funktionsbausteins fest, z. B FB_EndlessFeed.
i_sSource	STRING[40]	Die Quelle, zu der die Logger-Meldungen gehören. Die Schneider Electric-Bibliotheken legen den Namespace der Bibliothek fest.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Alle Werte außer GD.ET_Diag.Ok entsprechen einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer, diagnosebezogener Ausgang. q_etDiag = GD.ET_Diag.Ok -> Statusmeldung q_etDiag <> GD.ET_Diag.Ok -> Diagnosemeldung

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Alle Werte außer GD.ET_Diag.Ok entsprechen einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer, diagnosebezogener Ausgang.

q_etDiag = GD.ET_Diag.Ok -> Statusmeldung

q_etDiag <> GD.ET_Diag.Ok -> Diagnosemeldung

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	LoggerPointAlreadyRegistered	5	Der Logger-Punkt ist bereits registriert.
OK	Ok	0	Ok
ExecutionAborted	MaxNumberOfLoggerPointsExeeded	10	Die maximale Anzahl an Logger-Punkten wurde überschritten.
ExecutionAborted	ServiceNotRegistered	17	Der Service ist nicht registriert.
InputParameterInvalid	ParentInvalid	6	Das übergeordnete Objekt ist ungültig.
InputParameterInvalid	ParentNotRegistered	8	Das übergeordnete Objekt ist nicht registriert.
UnexpectedProgramBehavior	UnexpectedFeedback	3	Ein Rückgabewert war ungültig.

LoggerPointAlreadyRegistered

Aufzählungsname:	LoggerPointAlreadyRegistered
Aufzählungswert:	5
Beschreibung:	Der Logger-Punkt ist bereits registriert.

Der Logger-Punkt wurde zu einem früheren Zeitpunkt bereits registriert. Eine zusätzliche Protokollierung ist nicht notwendig.

MaxNumberOfLoggerPointsExeeded

Aufzählungsname:	MaxNumberOfLoggerPointsExeeded
Aufzählungswert:	10
Beschreibung:	Die maximale Anzahl an Logger-Punkten wurde überschritten.

Ursache	Lösung
Höchstzahl an Logger-Punkten überschritten. Der Application Logger selbst ist auch ein Logger-Punkt.	Der globale Parameter Gc_udiMaxNumberOfLoggerPoints muss auf einen Wert gesetzt werden, der den möglichen Logger-Punkten des Projekts entspricht.

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

Der Logger-Punkt wurde im Application Logger erfolgreich registriert.

ParentInvalid

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

Ursache	Lösung
Am Eingang i_ifParent wurde ein ungültiger Wert übergeben.	Am Eingang i_ifParent muss der übergeordnete Logger-Punkt, eine mit dem übergeordneten Logger-Punkt verbundene Schnittstelle oder die globale Schnittstelle G_ifApplicationLogger übergeben werden.

ParentNotRegistered

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

Ursache	Lösung
Der übergeordnete Logger-Punkt wurde bisher im Application Logger nicht registriert. Die Methode RegisterLoggerPoint des übergeordneten Logger-Punkts wurde zu einem früheren Zeitpunkt noch nicht aufgerufen.	Stellen Sie sicher, dass die Methode RegisterLoggerPoint des Logger-Punkts, die am Eingang i_ifParent zugewiesen wird, bereits erfolgreich aufgerufen wurde.

Ursache

Lösung

Der übergeordnete Logger-Punkt wurde bisher im Application Logger nicht registriert.

Die Methode RegisterLoggerPoint des übergeordneten Logger-Punkts wurde zu einem früheren Zeitpunkt noch nicht aufgerufen.

Stellen Sie sicher, dass die Methode RegisterLoggerPoint des Logger-Punkts, die am Eingang i_ifParent zugewiesen wird, bereits erfolgreich aufgerufen wurde.

ServiceNotRegistered

Aufzählungsname:	ServiceNotRegistered
Aufzählungswert:	17
Beschreibung:	Der Service ist nicht registriert.

Ursache	Lösung
Der Application Logger ist nicht registriert.	Die Methode G_ifApplicationlogger.RegisterCommunicationService muss einmalig erfolgreich aufgerufen werden, bevor eine Meldung im Application Logger hinzugefügt werden kann.

UnexpectedFeedback

Aufzählungsname:	UnexpectedFeedback
Aufzählungswert:	3
Beschreibung:	Ein Rückgabewert war ungültig.

Ursache	Lösung
Es ist ein Fehler in der internen Verarbeitung erkannt worden.	Wenden Sie sich an Ihren Ansprechpartner bei Schneider Electric.