DBoxZeit 1.5

----------------

Anwendungszweck:
Die Batch aktualisiert ber Netzwerk die PC-Systemzeit mit der Zeit aus einer dbox2.

----------------------

Systemvoraussetzungen:
dbox2 mit Neutrino
Microsoft Windows 2000, XP, 2003, Vista oder Windows 7, deutsch
Die CMD-Erweiterungen mssen aktiviert sein, das sind sie per Default.
  Registy-Eintrag:
  [HKEY_CURRENT_USER\Software\Microsoft\Command Processor]
  "EnableExtensions"=dword:00000001

-------------

Installation:
DBoxZeit.zip auspacken und Dateien nach z.B. C:\Programme\DBoxZeit\ kopieren.

Mindestens:
 - dboxzeit.cmd
 - enter.txt
 - wget.exe
 - libeay32.dll
 - ssleay32.dll

------------

Zu Beachten:

In der Datei dboxzeit.cmd mssen die Zeilen 4 und 5 angepasst werden:

set box_ip=192.168.0.222
  Statt 192.168.0.222 ist die IP-Nummer der dbox2 anzugeben.

set tool_pfad=c:\programme\dboxzeit\
  Hier ist der vollstndige Pfad zu dboxzeit.cmd anzugeben.
  Den abschlieenden Backslash (\) nicht vergessen.
  Der tool_pfad darf keine Leerstellen enthalten.
  Um das zu gewhrleisten, auch wenn beispielsweise "C:\Program Files\" oder "C:\Program Files (x86)\" der korrekte Pfad wre, muss der zugehrige kurze Dateiname des Ordners verwendet werden.
  Das ist meist fr "C:\Program Files\" "c:\progra~1\" und fr "C:\Program Files (x86)\" "c:\progra~2\".
  Leider gibt es keine einfache Methode sich die kurzen Dateinamen anzeigen zu lassen, also einfach ausprobieren: progra~1, progra~2, progra~3 ... usw.
  Stimmt der Wert fr tool_pfad nicht, so gibt es nur eine einfache Fehlermeldung.


set zeitzonen_korrektur=0
  Hier kann eine ganze Zahl zwischen -23 und 23 angegeben werden. Die Zeit auf die der PC gestellt wird, wird um diesen Wert in Stunden von der Zeit, die von der dbox2 ermittelt wird, abweichen.
  
set sommerzeit_beachten=0
  Hier kann 0 oder 1 angegeben werden.
  Bei 0 passiert nichts.
  Bei 1 wird die Zeit, auf die der PC gestellt wird, innerhalb der Sommerzeitperiode um eine Stunde vorgestellt, in Bezug auf die Zeit die von der dbox2 ermittelt wird.

set bericht_zeigen=1
  Hier kann 0 oder 1 angegeben werden.
  Bei 0 wird lediglich ein Einzeiler als Meldung ausgegeben.
  Bei 1 wird ein ausfhrlicherer Bericht angezeigt.

Dieser Bericht ist bei Doppelklick auf die Batch nicht zu Lesen, da sich das Fenster sofort wieder schliet.
Man sieht ihn nur, wenn man die Batch aus der Kommandozeile heraus ausfhrt.
Allerdings erscheinen die Meldungen auch in der Ausgabe von JtG und deswegen gibt es diese Auswahl.

Hintergrund fr zeitzonen_korrektur und sommerzeit_beachten:
Die Zeit und das Datum wird vom Websever der dbox2 abgefragt, das muss nicht die Zeit und das Datum sein, dass im Display der dbox2 zu sehen ist. Das ist abhngig vom verwendeten Image.
Ob die Zeit, die von der dbox2 geliefert wird, automatisch auf Sommerzeit korrigiert wird, ist genauso ungewiss.
Falls die dbox2 Zeit nicht auf Sommerzeit korrigiert wird, sollte sommerzeit_beachten=1 sein.
Falls die dbox2 Zeit auch zur Winterzeit um ganze Stunden "falsch" geht, kann das mit der zeitzonen_korrektur angepasst werden.
Wenn whrend der Sommerzeitperiode die dbox2 Zeit eine Stunde nach geht, dann ist nicht klar, ob es an einer fehlenden Sommerzeitanpassung der dbox2 liegt, oder ob sie generell um eine Stunde abweicht.

--------------------------------

Bemerkungen und Einschrnkungen:

Ein wesentlicher Bestandteil der Funktionalitt von DBoxZeit ist durch WGET realisiert.
An der Entwicklung von "WGET" bin ich nicht beteiligt, auch habe ich keinerlei besonderen Rechte an dieser OpenSource-Software,
DBoxZeit bedient sich lediglich der Funktionalitt von WGET.
Zu WGET gehren diese 3 Dateien: wget.exe / libeay32.dll / ssleay32.dll
Die Quelle von WGET liegt hier: http://www.gnu.org/software/wget/wget.html

Microsoft, Windows, XP und Vista sind geschtzte Markennamen von Microsoft.

Batchdateien, wie DBoxZeit.cmd ja auch eine ist, sind potentiell in der Lage so ziemlich Alles mit einem Rechner anzustellen, was man sich ausdenken kann.
Ich habe DBoxZeit so geschrieben, dass es meines Erachtens nach kein Risiko fr einen Rechner darstellt, aber aus zuvor genanntem Grund bernehme ich keine Gewhrleistung fr irgendwas, also bitte vorsichtig testen und bewusst einsetzen.
Bei Fehlfunktion oder Fehlbedienung kann die Zeit des PC-Systems auf einen unkorrekten Wert verstellt werden, das kann zu Fehlfunktionen des PC fhren.

-----------------

Syntax Beispiele:
dboxzeit
(Liest Datum und Zeit aus der dbox2 und stellt die PC Zeit auf die gleiche Zeit.)
dboxzeit 20
(Liest Datum und Zeit aus der dbox2 und stellt die PC Zeit auf die gleiche Zeit +20 Sekunden)
dboxzeit -15
(Liest Datum und Zeit aus der dbox2 und stellt die PC Zeit auf die gleiche Zeit -15 Sekunden)

Der optionale Parameter muss eine ganze Zahle zwischen -60 und 60 sein.

Beim Testen ist es ntzlich die Systemuhr (per Doppelklick geffnet) mit Sekundenzeiger im Blick zu haben.
Beachte bitte, dass das zweimal hintereinander Ausfhren von dboxzeit 20, beim zweitenmal logischerweise keine nderung der PC-Zeit bedeutet,
da nach dem ersten Mal und auch nach dem zweiten Mal, die PC-Zeit 20 Sekunden vor der dbox2 Zeit liegt, das sind NICHT 20 + 20 = 40 Sekunden.

------------------

Testeinstellungen:

set pause_vor_loeschen=0 oder 1
  0 normaler Betrieb
  1 lsst das Skript anhalten, bevor alle Temp-Dateien und Variablen gelscht werden.
set nobox_test=0 oder 1
  0 normaler Betrieb, Datum und Uhrzeit wird von der dbox2 abgefragt.
  1 Testbetrieb, Datum und Uhrzeit wird nicht von der dbox2 abgefragt.
    Es werden die Werte von "nobox_testdatum" und "nobox_testzeit" verwendet.
set nobox_testdatum=07.03.2004
    Testdatum das bei nobox_test=1 benutzt wird.
set nobox_testzeit=18:15:00
    Testzeit die bei nobox_test=1 benutzt wird.

-------------

Die Logdatei:
 
  Bericht:
  ----------------------------------------
  DBox ist  : 07.04.2009 18:15:00
  Zeitzone  : +  1 Stunde
  Sommerzeit: +  1 Stunde
  Anpassung : + 20 Sekunden
  PC war    : 07.04.2009 16:23:45
  PC soll   : 07.04.2009 20:15:20
  PC ist    : 07.04.2009 20:15:20
  ----------------------------------------
  Sommerzeit in 2009 ist vom 29.03.-25.10.

Erklrung:
DBox ist  : Datum und Uhrzeit, wie sie vom WebServer der dbox2 gelesen wurden.
Zeitzone  : Wird angezeigt und benutzt, falls "zeitzonen_korrektur" nicht auf 0 gesetzt ist.
Sommerzeit: Wird angezeigt und benutzt, falls "sommerzeit_beachten" nicht auf 0 gesetzt ist und tatschlich auch Sommerzeit ist.
Anpassung : Wird angezeigt und benutzt, falls ein Parameter beim Aufruf benuzt wurde.
PC war    : Datum und Uhrzeit des PC vor der Korrektur.
PC soll   : Datum und Uhrzeit, auf die der PC gestellt werden soll. (Dbox-Zeit + Zeitzone + Sommerzeit + Anpassung)
PC ist    : Datum und Uhrzeit des PC nach der Korrektur. (Sollte identisch sein mit PC soll.)

--------

Quellen:
DBoxZeit
 Download   : http://www.pedant.de/tools/dboxzeit.zip
 Information: http://www.jackthegrabber.de
WGET:
 Information: http://www.gnu.org/software/wget/wget.html

Gru Pedant