simcron-Befehl: plan

option und args bestimmen das exakte Verhalten des Befehls. Über die allgemeinen Objektbefehle hinaus sind folgende Befehle für Zeitplan-Objekte definiert:

OBJEKTPARAMETER

planCmd length

Gibt die Anzahl der vorgesehenen Schichtpläne (Länge der Planliste) des Zeitplanes zurück.

planCmd rest

Abfrage der Restzeit bis zum nächsten Schaltereignis des Zeitplanobjektes. Die Restzeit eines Zeitplanobjektes kann zwischen 0 und Inf liegen und wird nur durch die einzelnen Schichtpläne bestimmt. Voreinstellung ist Inf.

planCmd power

Abfrage des Schaltzustands des Zeitplanobjektes. Die Schaltzustand kann "Ein" (1) oder "Aus" (0) sein und wird nur durch die einzelnen Schichtpläne und den Scheduler bestimmt. Voreinstellung ist 1.

OBJEKTVERKNÜPFUNGEN

planCmd append shiftCmd

Hängt den Schichtplan shiftCmd an den Zeitplan an. Dieser kann anschließend durch das shift-Kommando abgefragt werden.

planCmd insert index shiftCmd

Fügt den Schichtplan shiftCmd vor den Schichtplan index (= 1, 2, ..., length) ein. Dieser kann anschließend durch das shift-Kommando abgefragt werden.

planCmd remove index

Entfernt den Schichtplan index (= 1, 2, ..., length) aus dem Zeitplan. Der Schichtplan selbst wird jedoch nicht gelöscht.

planCmd clear

Entfernt alle Schichtpläne aus dem Zeitplan, so dass anschließend length = 0 gilt. Die Schichtpläne werden dabei nicht gelöscht.

planCmd shift ?index1? ?index2?

Abfrage des/der verknüpften Schichtplanes eines Zeitplanes. Ohne die Parameter index1 und index2 wird eine Liste aller Schichtpläne zurückgegeben. Bei Angabe von index1 wird nur der Schichtplan index1 zurückgegeben. Bei Angabe von index1 und index2 wird die Liste aller Schichtpläne von index1 bis index2 zurückgegeben. Liegen index1 bis index2 außerhalb der zulässigen Bereiche, wird ein Fehler gemeldet.

planCmd begin ?index? ?date?

Abfrage oder Modifikation des Beginns des Gültigkeitszeitraums des Schichtplanes mit dem Index index eines Zeitplanes. Ohne die Parameter index und date wird eine Liste des Beginns der Gültigkeitszeiträume aller Schichtpläne zurückgegeben. Bei Angabe von index allein wird nur der Beginn des Gültigkeitszeitraums des Schichtplans mit dem Index index zurückgegeben. Bei Angabe von index und date wird der Beginn des Gültigkeitszeitraums des Schichtplans mit dem Index index auf date gesetzt.
begin kann nicht nach end liegen. Voreinstellung ist 0.

planCmd end ?index? ?date?

Abfrage oder Modifikation des Endes des Gültigkeitszeitraums des Schichtplanes mit dem Index index eines Zeitplanes. Ohne die Parameter index und date wird eine Liste des Endes der Gültigkeitszeiträume aller Schichtpläne zurückgegeben. Bei Angabe von index allein wird nur das Ende des Gültigkeitszeitraums des Schichtplans mit dem Index index zurückgegeben. Bei Angabe von index und date wird das Ende des Gültigkeitszeitraums des Schichtplans mit dem Index index auf date gesetzt.
end kann nicht vor begin liegen. Voreinstellung ist Inf.

planCmd period ?index? ?days?

Abfrage oder setzen der Periode für einen Schichtplan innerhalb des Zeitplans. Die Periode wird in Tagen angegeben und bestimmt alle wieviel Tage, beginnend mit planCmd begin index, der Schichtplan für 24h angeschaltet werden soll. Ohne Parameter wird eine Liste der hinterlegten Perioden zurückgegeben. Bei Angabe von index wird die Periode des index-ten Schichtplans zurückgegeben. Bei Angabe von index und days wird die Periode des index-ten Schichtplans auf days gesetzt.