_alert_hdl

Kurzzeichen-Pattern für Summenmeldung.

Ermöglicht Meldungen nach ihrem Prioritätenkürzel auszuwählen. Werden mehrere Zeichen angegeben, wird jede Meldung, die eines dieser Zeichen als Kürzel besitzt, berücksichtigt ("AW" erfasst alle Meldungen der Prioritäten "A" und "W").

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

"Quittieren löscht" summenmelden? Die berücksichtigten Einzelmeldungen werden auf solche bestimmter Quittierungsarten eingeschränkt. Siehe Kapitel _alert_class (Meldeklasse) - Quittierungsart.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

Reihenfolge der Quittierzustände für Summenmeldungen.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

Quittierart einer Meldung:

Die Abfrage gibt zurück, wie die Meldung (KAM/GING), die zur angegebenen Zeit aktiv ist, quittiert wurde. Um die Meldung zu quittieren, muss alertSet() verwendet werden. Dabei muss die Zeit von der Meldung bekannt sein.

Für das Attribut sind die Konstanten DPATTR_ACKTYPE_SINGLE oder DPATTR_ACKTYPE_MULTIPLE möglich.

Siehe auch Meldebehandlung_"_alert_hdl.<i>._ack_state".

_ack_type

Quittierungsart:

Konstanten:

//Quittieren löscht

ACKNOWLEDGEMENT_DELETES = 0,

// nicht quittierbar

ACKNOWLEDGEMENT_NONE = 1,

// kam ist quittierbar

ACKNOWLEDGEMENT_CAME = 2,

// Meldungspaar ist quittierungspflichtig

ACKNOWLEDGEMENT_PAIR = 3,

// kam und ging sind quittierungspflichtig

ACKNOWLEDGEMENT_CAMEANDGONE = 4,

//Quittierungsart für Summenmeldungen, entspricht "nicht quittierbar"

ACKNOWLEDGEMENT_SUMALERT = 5

Priorität des aktuellen Bereichs.

Nicht relevant für Multiinstanzalarme.

Aktueller Bereich.

Nicht relevant für Multiinstanzalarme.

Quittierungszustand der höchsten anstehenden Meldung. Mit diesem Attribut kann der aktuelle Meldezustand der höchsten anstehenden Meldung abgefragt werden.

1 = KAM unquittiert

2 = KAM quittiert

3 = GING unquittiert

4 = KAM/GING unquittiert

0 = Gutbereich (keine Meldung).

Für mögliche Konstanten siehe auch Abschnitt Meldebehandlung_"_alert_hdl.<i>._act_state

Nicht relevant für Multiinstanzalarme.

Hintergrund-Farbstring der höchsten anstehenden Meldung.

Die _act_state_color funktioniert auch mit mehreren Alarmen mit Multi-Instanz-Alarmen. Sie gibt den Wert des letzten Alarms zurück. Wenn die Alert-Klasse für eine Alarm-Instanz nicht festgelegt ist, gibt _act_state_color eine leere Zeichenfolge zurück.

Vordergrund-Farbstring der höchsten anstehenden Meldung.

Nicht relevant für Multiinstanzalarme.

X

Schriftart der höchsten anstehenden Meldung.

Nicht relevant für Multiinstanzalarme.

X

Priorität der höchsten anstehenden Meldung.

Nicht relevant für Multiinstanzalarme.

X

Bereich der höchsten anstehenden Meldung.

Bei einer Meldung mit den Bereichen OK/HI/URGENT. Ein Wert löst einen Alarm aus und führt zu URGENT und danach zu HI. Solange URGENT nicht quittiert wird und ansteht, ist _act_state_range 3 (URGENT steht an und hat die höchste Priorität). act_range ist 2 (die letzte Wertänderung führe zum Bereich HI). Wird URGENT quittiert, ist auch _act_state_range 2 (HI ist jetzt die höchste anstehende Meldung).

Nicht relevant für Multiinstanzalarme.

X

Text der höchsten anstehenden Meldung.

Nicht relevant für Multiinstanzalarme.

X

Text des aktuellen Bereichs. (Bereichstext des aktuellen Wertes).

Nicht relevant für Multiinstanzalarme.

_alert_hdl.<detail>._alerts

Liefert alle Alarmpaare (KAM-Zeit und GING-Zeit), die der Event für dieses Detail kennt. Das gilt auch für Alarme, die noch zum Löschen anstehen.

Ist <detail> 0, werden die Alarme von allen Details geliefert.

"beide sind quittierungspflichtig" summenmelden? Die berücksichtigten Einzelmeldungen werden auf solche bestimmter Quittierungsarten eingeschränkt. Siehe Kapitel _alert_class (Meldeklasse) - Quittierungsart.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

_class

Verweis auf die Meldeklasse des Bereiches.

Die Meldeklasse wird intern auf einen DpIdentifier umgewandelt.

Hinweis: Bei Multiinstanzalarmen ist es nicht zulässig, die Meldeklasse einer Alarminstanz zu eskalieren und gleichzeitig eine Meldeaktion (_event) auszulösen.

Hinweis: _class muss nicht direkt nach _event:DPATTR_ALERTEVENT_CAME kommen, um als Alarmklasse verwendet zu werden.

_delete

15/31

Gibt an, ob ein Alarmpaar das gelöscht werden kann (wenn es obsolet und unsichtbar ist) gelöscht oder ausgelagert wird. Wird auf beiden Seiten (Bit 15 und 31) gesetzt.

In der Meldeklasse kann eingestellt werden, ob archivierte Meldungen nach Ablauf der Archivierungsdauer gelöscht oder ausgelagert werden sollen. Das Bit hat nur dann eine Bedeutung, wenn ARCHIVE_ALERT_BIT_ATTR = 1 ist. Anhand dieses Bits entscheidet der Daten-Manager, ob die Meldung gelöscht (Bit = 1) oder ausgelagert (Bit = 0) wird.

Das Attribut wird über das Config _alert_class (Meldeklasse) in der Registerkarte "Argumente" parametriert.

Handelt es sich um eine Meldebehandlung diskreter Werte?

_discrete_states wird beim Hinzufügen eines Alarmbereichs vom _type DPDETAIL_RANGETYPE_MATCH oder DPDETAIL_RANGETYPE_SET implizit gesetzt.

Hinweis: Das Attribut wird beim ASCII Export nicht berücksichtigt, da es nur zur Laufzeit verwendet und nicht in der Datenbank gesichert wird.

DP-Liste für Summenmeldung. Es kann entweder eine _dp_list oder ein _dp_pattern gesetzt werden. Beide können nicht gleichzeitig gesetzt sein.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

DP-Pattern für Summenmeldung.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

X

Löst/Liest eine Meldeaktion aus. Multiinstanzalarme können nur mithilfe dieses Attributs ausgelöst/aktualisiert/quittiert werden. Für mögliche Konstanten siehe Meldebehandlung_"_alert_hdl.<i>._event".

Wenn das Attribut auf TRUE gesetzt wird, verhält sich WinCC OA als ob der Grenzwert erreicht wurde (_filter_active gibt TRUE zurück). Siehe Automatische Filterung von Alarmen.

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

Das _hyst_time-Attribut (genannt Verzögerung in der alert_hdl-Konfiguration ) legt die Mindestzeit in Sekunden fest, wie lange ein Alarm in einem schlechten Bereich vorhanden sein muss, damit er ausgelöst wird. Wenn der Alarm wieder in einem guten Bereich ist, wird er sofort gelöscht. Für eine Alarm-Instanz kann die _alert_hdl.<detail>._hyst_time verwendet werden, um die, für eine Alarminstanz verwendeten, Werte zu erhalten. Die Konfiguration gilt pro Alarmbereich. Für mehr Information, siehe Kapitel Verzögerte Alarme.

_last

Repräsentiert den Status des letzten Alarmpaars das gekommen oder gegangen ist. Bei Erstellen eines Alarmpaars (KAM) wird _last (Bit 2) gesetzt. Sobald der Alarm geht (GING), wird _last (Bit 18) gesetzt. Ist ein Alarmpaar noch im KAM-Zustand, wird durch einen GING-Impuls Bit 2 auf FALSE gesetzt, Bit 18 ändert sich aber nicht. Das Attribut wird entweder auf KAM- oder auf GING-Seite gesetzt. Sobald das Alarmpaar obsolet wird, werden beide Seiten auf FALSE gesetzt.

Hat ein Messwert mehr als einen Schlechtbereich, dann kann es vorkommen, dass der Messwert von "gut" in einen Bereich springt, der nicht der angrenzende Bereich von "gut" ist. In WinCC OA liegen dann auch alle Bereiche zwischen "gut" und dem aktuellen Schlechtbereich an (z.B.: mit einem Alarm liegt auch gleichzeitig eine Warnung an). Beim aktuellen Schlechtbereich wird das Flag "_last" gesetzt, die anderen dazwischenliegenden Bereiche stehen zwar auch an, haben aber dieses Flag nicht aktiviert.

_last_of_all

bool

3/19

Wenn ein Messwert mehrfach in einen Schlechtbereich geht und diesen wieder verlässt OHNE das dazwischen quittiert wurde, liegen eine Menge von noch unquittierten Meldungen an. Die erste (=älteste) Meldung wird mit dem Flag "_last_of_all" markiert. Diese Meldung ist auch zuerst zu quittieren. Im Beispiel von _last hat die Meldung dann nicht nur das Flag "_last", sondern auch das Flag "_last_of_all" gesetzt.

"_last_of_all"-Flag wird vom aktuellen Meldeereignis eines Messwertes auf das nächste Meldeereignis dieses Messwertes weitergereicht. Das Flag "_last" ist nur dann interessant, wenn man mehr als einen Schlechtbereich hat. "_last" kann in einem Stapel von nicht quittierten Meldungen eines Messwertes auch bei mehreren Melde-Ereignissen gesetzt sein.

Pattern das definiert, wann der Bereich eine Meldung auslösen soll. Die Pattern hängen vom Datentyp des DPEs ab:

Bit32: 01X…

1 .. Pattern übereinstimmend, wenn Bit32 an der Stelle eine 1 hat

0 .. Pattern übereinstimmend, wenn Bit32 an der Stelle eine 0 hat

X .. Pattern übereinstimmend, wenn Bit32 an der stelle eine 0 oder ein 1 hat

z.B.

11111111111111111111111111111111

10101010101010101010101010101010

XXXXXXXXXXXXXXXX1111111111111111

INT, FLOAT: Bereiche z.B. 0-10 oder 6.3-20.8 (als Komma wird in allen Sprachen . (Punkt) verwendet).

TEXT: Wildcards mit * und ?

Ein * kann immer für alle Datentypen verwendet werden und führt immer zu einer Übereinstimmung.

Dieses Attribut wird für diskrete Alarme verwendet.

Mindestpriorität (zum Unterdrücken von Meldungen).

Alarme unterhalb dieser Mindestpriorität gelten nicht für den Summenalarm, für den dieses Attribut gesetzt wurde.

Anzahl der Bereiche.

Die Bereiche legen Sie mit _alert_hdl.<rangeNo>._type an.

X

_oldest_ack

9/25

Reihenfolge der Meldungen für Summenmeldungen.

Konstanten:

ORDER_PRIO_STATE = 0,

// Priorität vor Meldezustand

ORDER_SIGN_STATE = 1,

// Kurzzeichen vor Meldezustand

ORDER_STATE_PRIO = 2,

// Meldezustand vor Priorität

ORDER_STATE_SIGN = 3

// Meldezustand vor Kurzzeichen

Dieses Attribut kann nur bei Summenmeldungen verwendet werden.

Meldungsindex des Partners einer Meldung.

Um Alarme, die gleichzeitig auftreten eindeutig zu machen gibt es in der Alarmzeit einen Zähler. Das Attribut _partn_idx ist dieser Zähler für das Attribut _partner vom Typ time.

_partner

Meldungszeit des Partners einer Meldung.

Ein Alarm besteht aus 2 Meldungen - KAM und GING. Der Partner von KAM ist GING und der Partner von GING ist KAM. _partner der KAM-Meldung liefert deswegen die GING-Zeit oder 1.1.1970 (wenn der Alarm noch nicht gegangen ist). _partner der GING-Meldung liefert die KAM-Zeit zurück.

Wird auf KAM- und/oder GING-Seite (Bit 7 oder 23) gesetzt, wenn eine Einzelquittierung erfolgt.

Einzelquittierungspflichtig. Das Attribut wird über das Config _alert_class (Meldeklasse) -> Registerkarte "Argumente" parametriert.

Das Attribut alert_hdl.._state fasst die Statusbits (_obsolete, _ackable. etc) in einem Bit32 zusammen.

_state eines KAM-Ereignisses gibt in den ersten 16 Bits die Statusbits für die KAM-Meldung zurück.

_state eines GING-Ereignisses gibt in den ersten 16 Bits die Statusbits für die GING-Meldung zurück.

Das Bit 0 von _direction kann verwendet werden, um zu identifizieren, ob es sich um einen GING- oder einen KAM-Meldung handelt.

Der _state32 enthält Bits für eingehende und ausgehende Alarme. Die Bits 0 - 15 sind für "KAM" und die Bits 16 - 31 für "GING" reserviert.

Um sowohl KAM- als auch GING-Ereignisse abzufragen, verwenden Sie den _state32 wie folgt:

main()
{  
   dyn_anytype res;  
   dyn_atime aTime;    

   dpGet("test1.:_alert_hdl.._alerts", aTime);  
   alertGet(aTime[1], getACount(aTime[1]), "test1.:_alert_hdl.3._state32", res);  
  
  DebugTN(res);
}

Filtert Bits heraus, welche bei einer Statusänderung eine Meldung auslösen. Ändern sich die angegebenen Statusbits des Pattern, wird eine Meldung ausgelöst.

Das Attribut gilt nur für diskrete Meldebehandlung.

Filtert Bits heraus, welche bei einer Statusänderung in einem bestimmten Bereich eine Meldung auslösen. Ändern sich die angegebenen Statusbits der Übereinstimmung, wird eine Meldung ausgelöst.

Das Attribut gilt nur für diskrete Meldebehandlung.

Aktuelle Systemzeit.

Die Alarmzeit wird anhand der Zeit der Wertänderung oder der beim _event-Attribut angegebenen Zeit gesetzt. Das kann bei einer Peripherie, die z.B. nicht immer online ist, unterschiedlich zur aktuellen Zeit sein. _system_time ist die Zeit zu der WinCC OA den Alarm angelegt hat.

Zum Beispiel:

Eine SPS ist durch eine Einwahlverbindung an ein WinCC OA System angebunden. Um 12:00 bricht ein Feuer aus. Die SPS versucht eine Verbindung zu einer Zentrale aufzubauen. Dies gelingt 20 Min. lang nicht, weil es Probleme mit der Telefonleitung gibt.

Wenn der Alarm um 12:20 gemeldet wird, besitzt der Alarm die Alarmzeit 12:00. Falls später die Frage "warum die Leitwarte 20 Min. brauchte bevor sie die Feuerwehr alarmierte", auftaucht, kann sie durch _system_time beweisen, dass es 20 min gedauert hat, bis der Alarm angekommen ist.

Das Attribut _type wird zum Anlegen einer Meldebehandlung und zum Einfügen von Alarmbereichen bei einem DPCONFIG_ALERT_NONBINARY_SIGNAL verwendet.

Meldebehandlung legen Sie wie folgt an: _alert_hdl.._type =

DPCONFIG_ALERT_BINARYSIGNAL = 12,

DPCONFIG_ALERT_NONBINARYSIGNAL = 13,

DPCONFIG_SUM_ALERT = 59

Alarmbereiche legen Sie wie folgt an:

_alert_hdl.<rangeNo>._type =

DPDETAIL_RANGETYPE_MIN=6,

DPDETAIL_RANGETYPE_MAX=7,

DPDETAIL_RANGETYPE_MINMAX=4,

DPDETAIL_RANGETYPE_MATCH=5,

DPDETAIL_RANGETYPE_SET=3

_visible

4/20

Der Alarmschirm zeigt nur Alarme mit dem Wert _visible = TRUE an.

Ein Alarm wird unsichtbar wenn er in den Status "kein Alarm" übergegangen ist, oder ein neuer Alarm ansteht und die Option "alte Alarme quittieren" nicht in der Alarmklasse definiert ist.