Detaillierte Informationen über den Scheduler

Scheduler Alarmklasse

Der Scheduler verwendet die Alarmklasse scAlarm für das Senden von Erinnerungsalarmen.

Scheduler Datenpunkttypen

Die internen Scheduler Datenpunkttypen _Sc und _ScCom werden vom Scheduler verwendet. Der _Sc Datenpunkttyp stellt die Zeitprogramme dar und die _ScCom ist verantwortlich für das Erstellen der Verbindung zwischen dem Laufzeit-Skript und anderen Sektionen des Schedulers. Der _Sc-Datenpunkttyp besteht aus den allgemeinen Einstellungen, Aktionsparametern und der Scheduler-Bedingung.

Datenpunkttyp _Sc

(Allgemeine Einstellungen)


Element	Datentyp	Beschreibung
name	langString	Name des Programms
type	String	Typ des Programms
result	bool	Programm freigegeben oder gesperrt
specDayList	langString	Ausgewählte Liste der Sondertage
logEntry	bool	Eintrag in der LOG-Datei oder nicht
specDayMode	int	Selektion des Modus der Sondertage "An Sondertagen nicht ausführen", "Nur an Sondertagen ausführen"
command	int	Löst die jeweiligen Aktionen aus: ON= 1 OFF= 2 Single= 3.
mode	bool	Aktueller Status (freigegeben (TRUE), gesperrt (FALSE))

_Sc-

actions-dpeList


Element	Datentyp	Beschreibung
dpes	dyn_string	Liste der zu setzenden Datenpunktelemente
dpeValuesON	dyn_string	Liste der EIN-Werte von den zu setzenden Datenpunktelemente. Gelten nur im ON/OFF Betrieb.
dpeValuesOFF	dyn_string	Liste der AUS-Werte der zu setzenden Datenpunktelemente. Gelten nur im ON/OFF Betrieb.
dpeValues	dyn_string	Liste der Werte der zu setzenden Datenpunktelemente. Gelten nur wenn nicht im ON/OFF Betrieb.
active	bool	Aktion "Datenpunktliste" gewählt, Ja oder Nein.

_Sc-

Actions-recipe


Element	Datentyp	Beschreibung
active	bool	Aktion "Rezepte" gewählt, Ja oder Nein.
recipeTypeOn	string	Rezepttyp für das EIN-Ereignis. Gilt nur im ON/OFF Betrieb.
recipeNameOn	string	Rezeptname für das EIN-Ereignis. Gilt nur im ON/OFF Betrieb.
recipeTypeOff	string	Rezepttyp für das AUS-Ereignis. Gilt nur im ON/OFF Betrieb.
recipeNameOff	string	Rezepttyp für das AUS-Ereignis. Gilt nur im ON/OFF Betrieb.
recipeType	string	Rezepttyp für das Ereignis. Gilt nur, wenn nicht im ON/OFF Betrieb.
recipeName	string	Rezepttyp für das Ereignis. Gilt nur, wenn nicht im EIN/AUS-Betrieb.

_Sc-

Actions-popUp


Element	Datentyp	Beschreibung
Text	langString	Parametrierter Nachrichtentext
uiNums	dyn_string	Liste der zu Benachrichtigenden UIs.
users	dyn_string	Liste der zu Benachrichtigenden Benutzer.
active	bool	Aktion "Pop-Up" gewählt, Ja oder Nein.

_Sc-

Actions-reminderAlarm


Element	Datentyp	Beschreibung
text	langString	Alarmtext
active	bool	Aktion "Reminder Alarm" gewählt, Ja oder Nein.
alarmS	bool	DPE mit Alarmbehandlung für Einzelereignis.
alarmD	int	DPE mit Alarmbehandlung für EIN/AUS-Ereignis

_Sc-

Actions-script


Element	Datentyp	Beschreibung
path	string	Pfad des aufzurufenden Skriptes. Gilt nur, wenn nicht im ON/OFF Betrieb.
active	bool	Aktion "Skript" gewählt, Ja oder Nein.
pathOn	string	Pfad des aufzurufenden EIN-Skriptes. Gilt nur im ON/OFF Betrieb.
pathOff	string	Pfad des aufzurufenden AUS-Skriptes. Gilt nur im ON/OFF Betrieb.

_Sc-

Time


Element	Datentyp	Beschreibung
vcDpeString	string	Zusätzliche Wertbedingung &endash" DPE-String
vcValue	string	Zusätzliche Wertbedingung &endash" Wert
vcRelOp	int	Zusätzliche Wertbedingung &endash" Vergleichsoperator
timesWeekTable		Enthält die Zeiten der Wochentage. Gilt nur für den Typ "Week" (Wochenprogramm).
timesFreeScheduler	dyn_time	Enthält Zeiten mit der die timedFunc() gefüllt wird. Gilt nur für den Typ "Free" (Freies Programm) und wird bei periodischen Ereignissen nicht verwendet.
conditionType	int	Enthält den Bedingungstypen die in "Free" (Freies Programm) möglich sind: CT_SINGLE = 0 CT_PERIODIC = 1 CT_TIMELIST = 2 CT_ADVANCED = 3 CT_ONOFF_LIST = 4
vcActive	bool	Zusätzliche Wertbedingung gewählt, Ja oder Nein.
linkAVC	bool	Enthält ein Config, welches die mathematischen Verknüpfungen mit anderen Datenpunktelementen ermöglicht. Darin wird die zusätzliche Wertbedingung parametriert.

_Sc-

Reaction


Element	Datentyp	Beschreibung
dpe	string	DPE-String für den Datenpunkt, für den die Vergleichsbedingungen gelten.
valTyp	int	DPE-String für den jenen Datenpunkt für den die Vergleichsbedingungen gelten.
value	string	Wert für die Vergleichsbedingung "Single Value", value oder dpe2 können gewählt werden.
relOp	int	Das ist die logische Verknüpfung der Wertbedingungen im Reaktionsprogramm. Gilt nur im "Single Value" Betrieb.
valueON	string	Wert für die ON Vergleichsbedingung der Auswahl "Value Range".
relOpON	int	Vergleichsoperator für die ON Vergleichsbedingung der Auswahl "Value Range".
valueOFF	string	Wert für die OFF Vergleichsbedingung der Auswahl "Value Range".
relOpOFF	int	Vergleichsoperator für die OFF Vergleichsbedingung der Auswahl "Value Range".
dpe2	string	Vergleichsdatenpunkt für die Auswahl "Single Value".
link	bool	Link für die Auswahl "Single Value". Die Links werden bei der Initialisierung und bei Änderungen in den Plänen erstellt. D.h. die Reaktionsbedingung wird als dp_func, die TRUE oder FALSE liefert, parametriert (immer wenn der (oder beide) Datenpunkt(e) sich ändern.
linkON	bool	Link für die Auswahl "Value Range" (ON-Bedingung).
linkOFF	bool	Link für die Auswahl "Value Range" (OFF-Bedingung).

Datenpunkttyp _ScCom-

Allgemeine Einstellungen


Element	Datentyp	Beschreibung
transfer	string	Zuletzt erstellte bzw. geänderte Zeitprogramme werden in diesem Datenpunktelement notiert. Auf diese Weise kann das Control-Skript entsprechend auf die Änderung reagieren.
actionLog	dyn_string	Enthält die letzten 100 Aktionen
mainState	string	Hilft den Ladestatus der Haupttabellen zu darstellen.
msgNo	unsigned	Enthält die aktuelle PopUp-Nummer
action	string	Die aktivierteste Aktion wird hier notiert.

_ScCom-

specDays Liste


Element	Datentyp	Beschreibung
DayNames	dyn_langString	Enthält die Namensliste der Sondertage.
DayDates	dyn_time	Enthält die Datumsliste der Sondertage

_ScCom-

specDays Konfigurationen


Element	Datentyp	Beschreibung
ConfigNames	dyn_langString	Enthält die Namen der Spezialtagslisten.
ConfigDayCodes	dyn_String	Enthält die Tagescodes der Spezialtage. Derzeit nicht in Gebrauch.
ConfigDayDates	dyn_string	Enthält die Datumslisten der Spezialtagslisten.

Control-Funktionen


Funktion + Syntax	Beschreibung
int sc_readProgram(string dp)	Liest das Programm. Panel-globale Variablen werden in dieser Funktion verwendet. Siehe wincc_oa_path /scripts/libs/sched.ctl für detaillierte Information.
int sc_writeProgram(string dp)	Schreibt auf einen Datenpunkt. Panel-globale Variablen werden in dieser Funktion verwendet. Siehe wincc_oa_path /scripts/libs/sched.ctl für detaillierte Information.
int sc_copyProgram(string &dp)	Kopiert ein Zeitprogramm.
int sc_activateProgram(string dp)	Aktiviert ein Programm.
void sc_activateAllPrograms(int &iErr)	Aktiviert alle Programme.
int sc_deactivateProgram(string dp)	Deaktiviert ein Programm.
void sc_deactivateAllPrograms(int &iErr)	Deaktiviert alle Programme.
void sc_deleteProgram(string dp, int &iErr)	Löscht ein Programm.
int sc_deleteAllPrograms()	Löscht alle Programme (_Sc Datenpunkte).
void sc_createNewProgramName(string &dp, int &iErr)	Erstellt einen neuen Namen für ein Zeitprogramm. Dieser darf maximal 64 Zeichen lang sein.
void sc_getAllPrograms(dyn_string &dsAllProgs)	Holt alle Programme
int sc_deleteSpecialDay(time dayDate)	Löscht einen spezifischen Sondertag.
int sc_deleteAllSpecialDays(string dataPoint)	Löscht alle Sondertage.
int sc_readAllSpecialDays(dyn_time &dayDates, dyn_langString &dayNames)	Liest alle Sondertage.
int sc_writeSpecialDay(string dataPoint, langString paraDayName, time paraDayDateReal, bool editOrNew = TRUE, time dateRealEdit = makeTime(1970,1,1,1))	Erstellt einen Sondertag.
int sc_deleteSpecialDayList(string dataPoint, langString paraConfigName)	Löscht eine Konfiguration der Sondertage-Liste.
int sc_writeSpecialDayList(string dataPoint, langString paraConfigName, string paraConfigDayDates, string paraConfigDayCodes = "")	Speichert oder ändert eine Konfiguration der Sondertage-Liste.
int sc_readSpecialDayList(string dataPoint, string configName, dyn_langString &dn, dyn_string &dd, dyn_int &dc)	Liest die Konfigurationsdaten der Sondertage_Liste.