Class NodeLinkSup
Version 1.0
Modified 15-JAN-2025 13:23:37.00
Övervakar en länk med en annan nod.

En NodeLinkSup lägger upp en prenumeration på an annan node $Node objekt,
och kontrollerar mottagandet av det prenumererade värdet. Om ett nytt
värde inte har anlänt inom timout tiden skickas ett larm-meddelande.

NodeLinkSup objekt hanteras av server processen rt_linksup.


RtBody attributes pwr_sClass_NodeLinkSup
Objid Node   $Node objektet på den övervakade noden. Specificera nodobjektet med volume
och path, t ex 'RemoteVolume:Nodes-PlcNode'.

Obs! Om noden är monterad är det lätt att förväxla monterings-objektet med
$Node objektet. Se till att ange $Node-objektet.
UInt32 TimeoutTime   Timeout tid i sekunder.
Om prenumerationsvärdet inte har anlänt inom timout tiden, skickas ett
larm-meddelande.
Float32 SubscriptionInterval   Uppdateringsperioden för prenumerationen i sekunder.
Boolean LinkUp   Indikerar att länken är uppe.
LinkUp är sann om länken är uppe, falsk om länken är nere.
Time UpTime   Tid när länken senast upprättades.
Time DownTime   Tid när länken senast förlorades.
UInt32 UpCount   Antal gånger länken har upprättats.
RefId SubId   SubId för prenumerationen.
Boolean Control con Anger om övervakningen är aktiv.
Vid sann är övervakningen aktiv, vid falsk ej aktiv.
Boolean Action act Anger den övervakade storhetens tillstånd. FALSE innebär normaltillstånd och
TRUE larmtillstånd.

Utsignalen kan t.ex. användas för att aktivera åtgärdspaket vid larmtillstånd.
Boolean Acked ack Anger om larmtillståndet kvitterats eller ej. FALSE betyder att okvitterat larm
finns. Utsignalen sätts initialt TRUE då DSup-objektet skapas i rtdb och när
larmtillstånd kvitteras.
Boolean Blocked blk Anger om övervakningsobjektet är blockerat eller ej. Med blockering avses
övervakningsobjektets förmåga att initiera meddelanden. Blockering påverkar
inte objektets act-utgång.

FALSE innebär att ASup-objektet inte är blockerat och TRUE att det är
blockerat. Vid blockering av övervakningsobjekt som befinner sig i larmläge
tas existerande meddelanden för det aktuella objektet bort.

Blockering /deblockering görs med hjälp av larmblockeringsformuläret i
Operator Window.
String80 Description   Fri text för att beskriva objektet. Används i bilden 'Larmgränser'.
Boolean DetectOn   Anger om den åtgärd som vid larmtillstånd består i att skicka DetectText ska
blockeras eller ej. FALSE betyder att inget meddelandet skickas vid
larmtillstånd; TRUE betyder att meddelandet DetectText skickas vid
larmtillstånd.
String80 DetectText   Fri text som ingår i meddelandet vid larmtillstånd. Texten skrivs ut vid
larmtillstånd om DetectOn är TRUE.
String80 ReturnText   Fri text som ingår i meddelandet vid återgång till normaltillstånd. Meddelandet
skrivs i händelselistan.
UInt32 EventType   Anger vilken typ av meddelande (= DetectText ) som ska skickas vid
larmtillstånd.
64 -- ALARM Meddelandet kräver kvittering och skickas till
larmfönstret, larmlistan och händelselistan.
32 -- INFO Om meddelandet kräver kvittering skickas det till
larmfönstrets informationsdel och händelselistan annars
enbart till händelselistan.
UInt32 EventPriority   Prioritet. Gäller enbart ALARM-meddelanden.

67 = A-larm; högst prioritet. (= 43Hex)
66 = B-larm (= 42Hex)
65 = C-larm (= 41Hex)
64 = D-larm ; lägst prioritet. (= 40Hex)
UInt32 EventFlags   Bitmask. En kombination av flaggor används också för att specificera
meddelandet. Följande värden (flaggor) finns:

1 = Om denna flagga finns ska ett returmeddelande med ReturnText
skickas till utenheternas händelselistor, annars inte.

2 = Om denna flagga finns ska ett kvittensmeddelande skickas till
utenheternas händelselistor, annars inte.

4 = Om den enskilda utenheten har akustisk signal (pip-funktion)
ska den aktiveras då meddelandet tas emot.

8 = Meddelandet ska tas emot av varje utenhet oberoende av vad det
står i urvalslistorna.

16 = Om meddelandet är av typen INFO placeras det förutom i
händelselistan också i larmfönstrets info-del. Kvittens- resp
returmeddelande som för t ex. A-larm.
AttrRef Sound   Reference to a sound object, that defines the sound at the operator
place when the alarm is active. If no sound object is supplied, an
ordinary beep is used. The sound object should be of class Sound
or SoundSequence
Text256 MoreText   Optional text supplying more information about the event.
The more text can for example contain actions to be made when an alarm is detected.
String40 Recipient   Recipient for epost and mms alarms.
The recipient is a user defined in the user database in the
current system group.
Recipient can also be a list of users separated by comma, eg
'dennis, jimmy'. Also symbols defined in the Symbol table in
the PostConfig object can be used. Symbols should be referenced
with a $ sign before the symbol name, eg '$on_duty'.

The users should be defined in the current system group or in a
subgroup to this, If a subgroup is used, the subgroup should
be specified in the recipient name, eg 'sms.dennis'.
AttrRef Attribute   Anger komplett namn på övervakat attribut. Om ingången 'in' lämnas öppen
ska vid konfigureringen Attribute fyllas i. Knyts ingången till annat objekt
ifylls attributet vid kompileringen av ProviewR.
UInt32 AlarmStatus   Aktuellt statusvärde. Bitmask bestående av 16 bitar där de 8 minst signifikanta
bitarna anger tillståndet och de 8 mest signifikanta prioriteten .

Tillståndet är en kombination av följande:

0 -- Normaltillstånd
1 -- Larmtillstånd
2 -- Okvitterat larmtillstånd

Prioriteten är en av prioriteterna EventPriority .

Följande värde på AlarmStatus kan förekomma:

EventPrority + 1 => Prioritet + larmtillstånd
EventPrority + 3 => Prioritet + okvitterat larm och rådande larmtillstånd
EventPrority + 2 => Prioritet + okvitterat larm och normaltillstånd
Boolean AlarmCheck   Används internt vid händelse detektering.
Boolean DetectCheck   Anger om larmtillstånd ska detekteras eller ej. FALSE betyder att larmtillstånd
inte ska detekteras; TRUE att larmtillstånd ska detekteras.
Boolean DetectSend   Anger om meddelande sänts iväg till utenheter (eller mer precis till
meddelande hanteraren) eller ej; TRUE betyder att meddelande har sänts.
Time DetectTime   Datum och klockslag för senast detekterade larmtillstånd.
Boolean ReturnCheck   Anger om objektet återgått till normaltillstånd eller ej. TRUE betyder att
objektet återgått till normaltillstånd.
Boolean ReturnSend   Anger om ett returmeddelande med ReturnText sänts till utenheterna eller ej.
TRUE betyder att returmeddelande sänts.
Time ReturnTime   Datum och klockslag för senast detekterade retur till normaltillstånd.
Time AckTime   Datum och klockslag för senast detekterade kvittens.
Objid AckOutunit   Identitet på utenhet (operatör) varifrån kvittering skett.
Boolean TimerFlag   Markerar aktiv timer.
Pointer to Boolean TimerNext   Pekar på nästa element i timerkön.
UInt32 TimerCount   Antal återstående ticks. ( 1 tick = PLC-jobbets bascykeltid.)
Pointer to Boolean TimerDO   Pekar på ett Do eller Dv objekt eller, om sådant objekt inte används, på
TimerDoDum . Efter tiden TimerTime nollställs den av TimerDo angivna
signalen.
Float32 TimerTime   Fördröjning i sekunder. Anger när, efter det att larmtillstånd inträtt,
meddelandet ska skickas. Om larmtillståndet försvinner innan tiden gått ut
genereras inget meddelande.

TimerTime = PLC-jobbets bascykeltid.
Boolean TimerDODum   Dummy. Om TimerDoDum inte pekar på ett Do eller Dv objekt pekar det hit.
Objid TimerObjDId   Identity of this object is set at load file creation.
Used by the run time system.
Int32 TimerAcc   Ej implementerad funktion. Anger operatörens behörighet att ändra värde på
TimerTime . Följande behörigheter är möjliga:

0 -- Ingen ändring tillåten
? 0 -- ändring tillåten.
Float32 TimerMin   Anger tillåtet intervall för TimerTime vid operatörs inmatning.

TimerMin <= TimerTime <= TimerMax
Float32 TimerMax   Anger tillåtet intervall för TimerTime vid operatörs inmatning.

TimerMin <= TimerTime <= TimerMax
Status SystemStatus   Contains the system status of the supervised node.
If the link is down, the status is PWR__NETTIMEOUT.


Template Object
TimeoutTime 20
SubscriptionInterval 1.0
Control 1
EventType 64
EventPriority 67
EventFlags 7
DetectOn 1
DetectText Lost contact with node XXX
ReturnText Established contact with node XXX


Attributes detail


Node Attribute
Klass Attribute
Typ Objid
Flags
Kropp RtBody
$Node objektet på den övervakade noden. Specificera nodobjektet med volume
och path, t ex 'RemoteVolume:Nodes-PlcNode'.

Obs! Om noden är monterad är det lätt att förväxla monterings-objektet med
$Node objektet. Se till att ange $Node-objektet.

TimeoutTime Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody
Timeout tid i sekunder.
Om prenumerationsvärdet inte har anlänt inom timout tiden, skickas ett
larm-meddelande.

SubscriptionInterval Attribute
Klass Attribute
Typ Float32
Flags
Kropp RtBody
Uppdateringsperioden för prenumerationen i sekunder.

LinkUp Attribute
Klass Attribute
Typ Boolean
Flags STATE | NOEDIT
Kropp RtBody
Indikerar att länken är uppe.
LinkUp är sann om länken är uppe, falsk om länken är nere.

UpTime Attribute
Klass Attribute
Typ Time
Flags STATE | INVISIBLE
Kropp RtBody
Tid när länken senast upprättades.

DownTime Attribute
Klass Attribute
Typ Time
Flags STATE | INVISIBLE
Kropp RtBody
Tid när länken senast förlorades.

UpCount Attribute
Klass Attribute
Typ UInt32
Flags STATE | INVISIBLE
Kropp RtBody
Antal gånger länken har upprättats.

SubId Attribute
Klass Attribute
Typ RefId
Flags STATE | INVISIBLE
Kropp RtBody
SubId för prenumerationen.

Control Input
Klass Input
Typ Boolean
Flags STATE | INVISIBLE
GraphName con
Kropp RtBody
Anger om övervakningen är aktiv.
Vid sann är övervakningen aktiv, vid falsk ej aktiv.

Action Output
Klass Output
Typ Boolean
Flags STATE | NOEDIT
GraphName act
Kropp RtBody
Anger den övervakade storhetens tillstånd. FALSE innebär normaltillstånd och 
TRUE larmtillstånd. 

Utsignalen kan t.ex. användas för att aktivera åtgärdspaket vid larmtillstånd. 

Acked Output
Klass Output
Typ Boolean
Flags STATE | NOEDIT
GraphName ack
Kropp RtBody
Anger om larmtillståndet kvitterats eller ej. FALSE betyder att okvitterat larm 
finns. Utsignalen sätts initialt TRUE då DSup-objektet skapas i rtdb och när 
larmtillstånd kvitteras. 

Blocked Output
Klass Output
Typ Boolean
Flags STATE | NOEDIT
GraphName blk
Kropp RtBody
Anger om övervakningsobjektet är blockerat eller ej. Med blockering avses 
övervakningsobjektets förmåga att initiera meddelanden. Blockering påverkar 
inte objektets act-utgång. 

FALSE innebär att ASup-objektet inte är blockerat och TRUE att det är 
blockerat. Vid blockering av övervakningsobjekt som befinner sig i larmläge 
tas existerande meddelanden för det aktuella objektet bort. 

Blockering /deblockering görs med hjälp av larmblockeringsformuläret i 
Operator Window. 

Description Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody
Fri text för att beskriva objektet. Används i bilden 'Larmgränser'. 

DetectOn Attribute
Klass Attribute
Typ Boolean
Flags
Kropp RtBody
Anger om den åtgärd som vid larmtillstånd består i att skicka DetectText ska 
blockeras eller ej. FALSE betyder att inget meddelandet skickas vid 
larmtillstånd; TRUE betyder att meddelandet DetectText skickas vid 
larmtillstånd. 

DetectText Intern
Klass Intern
Typ String80
Flags
Kropp RtBody
Fri text som ingår i meddelandet vid larmtillstånd. Texten skrivs ut vid 
larmtillstånd om DetectOn är TRUE. 

ReturnText Attribute
Klass Attribute
Typ String80
Flags
Kropp RtBody
Fri text som ingår i meddelandet vid återgång till normaltillstånd. Meddelandet 
skrivs i händelselistan. 

EventType Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody
Anger vilken typ av meddelande (= DetectText ) som ska skickas vid 
larmtillstånd.
64 -- ALARM Meddelandet kräver kvittering och skickas till
larmfönstret, larmlistan och händelselistan.
32 -- INFO Om meddelandet kräver kvittering skickas det till
larmfönstrets informationsdel och händelselistan annars
enbart till händelselistan. 

EventPriority Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody
Prioritet. Gäller enbart ALARM-meddelanden. 

67 = A-larm; högst prioritet. (= 43Hex)
66 = B-larm (= 42Hex)
65 = C-larm (= 41Hex)
64 = D-larm ; lägst prioritet. (= 40Hex) 

EventFlags Attribute
Klass Attribute
Typ UInt32
Flags
Kropp RtBody
Bitmask. En kombination av flaggor används också för att specificera 
meddelandet. Följande värden (flaggor) finns: 

1 = Om denna flagga finns ska ett returmeddelande med ReturnText
skickas till utenheternas händelselistor, annars inte.

2 = Om denna flagga finns ska ett kvittensmeddelande skickas till
utenheternas händelselistor, annars inte.

4 = Om den enskilda utenheten har akustisk signal (pip-funktion)
ska den aktiveras då meddelandet tas emot.

8 = Meddelandet ska tas emot av varje utenhet oberoende av vad det
står i urvalslistorna.

16 = Om meddelandet är av typen INFO placeras det förutom i
händelselistan också i larmfönstrets info-del. Kvittens- resp
returmeddelande som för t ex. A-larm.

Sound Attribute
Klass Attribute
Typ AttrRef
Flags
Kropp RtBody
 Reference to a sound object, that defines the sound at the operator
 place when the alarm is active. If no sound object is supplied, an
 ordinary beep is used. The sound object should be of class Sound
 or SoundSequence

MoreText Attribute
Klass Attribute
Typ Text256
Flags
Kropp RtBody
 Optional text supplying more information about the event.
 The more text can for example contain actions to be made when an alarm is detected.

Recipient Attribute
Klass Attribute
Typ String40
Flags
Kropp RtBody
 Recipient for epost and mms alarms.
 The recipient is a user defined in the user database in the
 current system group.
 Recipient can also be a list of users separated by comma, eg
 'dennis, jimmy'. Also symbols defined in the Symbol table in
 the PostConfig object can be used. Symbols should be referenced
 with a $ sign before the symbol name, eg '$on_duty'.

 The users should be defined in the current system group or in a
 subgroup to this, If a subgroup is used, the subgroup should
 be specified in the recipient name, eg 'sms.dennis'.

Attribute Attribute
Klass Attribute
Typ AttrRef
Flags INVISIBLE
Kropp RtBody
Anger komplett namn på övervakat attribut. Om ingången 'in' lämnas öppen 
ska vid konfigureringen Attribute fyllas i. Knyts ingången till annat objekt 
ifylls attributet vid kompileringen av ProviewR. 

AlarmStatus Attribute
Klass Attribute
Typ UInt32
Flags STATE | INVISIBLE
Kropp RtBody
Aktuellt statusvärde. Bitmask bestående av 16 bitar där de 8 minst signifikanta 
bitarna anger tillståndet och de 8 mest signifikanta prioriteten . 

Tillståndet är en kombination av följande: 

0 -- Normaltillstånd
1 -- Larmtillstånd
2 -- Okvitterat larmtillstånd 

Prioriteten är en av prioriteterna EventPriority . 

Följande värde på AlarmStatus kan förekomma: 

EventPrority + 1 => Prioritet + larmtillstånd
EventPrority + 3 => Prioritet + okvitterat larm och rådande larmtillstånd
EventPrority + 2 => Prioritet + okvitterat larm och normaltillstånd 

AlarmCheck Attribute
Klass Attribute
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Används internt vid händelse detektering. 

DetectCheck Attribute
Klass Attribute
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Anger om larmtillstånd ska detekteras eller ej. FALSE betyder att larmtillstånd 
inte ska detekteras; TRUE att larmtillstånd ska detekteras. 

DetectSend Attribute
Klass Attribute
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Anger om meddelande sänts iväg till utenheter (eller mer precis till 
meddelande hanteraren) eller ej; TRUE betyder att meddelande har sänts. 

DetectTime Attribute
Klass Attribute
Typ Time
Flags STATE | INVISIBLE
Kropp RtBody
Datum och klockslag för senast detekterade larmtillstånd. 

ReturnCheck Attribute
Klass Attribute
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Anger om objektet återgått till normaltillstånd eller ej. TRUE betyder att 
objektet återgått till normaltillstånd. 

ReturnSend Attribute
Klass Attribute
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Anger om ett returmeddelande med ReturnText sänts till utenheterna eller ej. 
TRUE betyder att returmeddelande sänts. 

ReturnTime Attribute
Klass Attribute
Typ Time
Flags STATE | INVISIBLE
Kropp RtBody
Datum och klockslag för senast detekterade retur till normaltillstånd. 

AckTime Attribute
Klass Attribute
Typ Time
Flags STATE | INVISIBLE
Kropp RtBody
Datum och klockslag för senast detekterade kvittens. 

AckOutunit Attribute
Klass Attribute
Typ Objid
Flags STATE | INVISIBLE
Kropp RtBody
Identitet på utenhet (operatör) varifrån kvittering skett. 

TimerFlag Intern
Klass Intern
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Markerar aktiv timer. 

TimerNext Intern
Klass Intern
Typ Pointer to Boolean
Flags POINTER | STATE | INVISIBLE | PRIVATE
Kropp RtBody
Pekar på nästa element i timerkön. 

TimerCount Intern
Klass Intern
Typ UInt32
Flags STATE | INVISIBLE
Kropp RtBody
Antal återstående ticks. ( 1 tick = PLC-jobbets bascykeltid.) 

TimerDO Intern
Klass Intern
Typ Pointer to Boolean
Flags POINTER | STATE | INVISIBLE | PRIVATE
Kropp RtBody
Pekar på ett Do eller Dv objekt eller, om sådant objekt inte används, på 
TimerDoDum . Efter tiden TimerTime nollställs den av TimerDo angivna 
signalen. 

TimerTime Intern
Klass Intern
Typ Float32
Flags
Kropp RtBody
Fördröjning i sekunder. Anger när, efter det att larmtillstånd inträtt, 
meddelandet ska skickas. Om larmtillståndet försvinner innan tiden gått ut 
genereras inget meddelande. 

TimerTime = PLC-jobbets bascykeltid. 

TimerDODum Intern
Klass Intern
Typ Boolean
Flags STATE | INVISIBLE
Kropp RtBody
Dummy. Om TimerDoDum inte pekar på ett Do eller Dv objekt pekar det hit. 

TimerObjDId Intern
Klass Intern
Typ Objid
Flags INVISIBLE
Kropp RtBody
 Identity of this object is set at load file creation.
 Used by the run time system.

TimerAcc Intern
Klass Intern
Typ Int32
Flags INVISIBLE
Kropp RtBody
Ej implementerad funktion. Anger operatörens behörighet att ändra värde på 
TimerTime . Följande behörigheter är möjliga: 

0 -- Ingen ändring tillåten
? 0 -- ändring tillåten. 

TimerMin Intern
Klass Intern
Typ Float32
Flags INVISIBLE
Kropp RtBody
Anger tillåtet intervall för TimerTime vid operatörs inmatning. 

TimerMin <= TimerTime <= TimerMax 

TimerMax Intern
Klass Intern
Typ Float32
Flags INVISIBLE
Kropp RtBody
Anger tillåtet intervall för TimerTime vid operatörs inmatning. 

TimerMin <= TimerTime <= TimerMax 

SystemStatus Intern
Klass Intern
Typ Status
Flags NOEDIT | STATE
Kropp RtBody
Contains the system status of the supervised node.
If the link is down, the status is PWR__NETTIMEOUT.