Download

Stand: Version 41 vom 23-Dez-2011

	Dateibereich/HitBatch.jar Dateibereich/HitUpros.jar    - nur die Programme ohne alles weitere
	Dateibereich/HitBatch.zip Dateibereich/HitUpros.zip  - die Programme mit Beispiele und Aufrufdateien
	Dateibereich/HitBatchSources.zip Dateibereich/HitUprosSources.zip  - die Quellen der Programme

Ab sofort unterstützt der HitBatch nur noch Java-Versionen >= 1.5.

Allgemeine Hinweise

	Seit Version 22 wurde der komplette Batch-Client auf Packages mit JAR-Files umgestellt. Es müssen damit keine CLASS-Files sondern nur noch die beiden Archive auf HitBatch.jar und HitUpros.jar ausgeliefert und im CLASSPATH aufgenommen werden. Der Aufruf selbst erfolgt nicht mehr über "java.exe ... HitBatch" sondern "java.exe ... HitBatch.HitBatchMain" (siehe auch Installation)
	Von beiden Packages sind auch die Sourcen verfügbar: HitUprosSources.zip und HitBatchSources.zip
	Hier gibt es Hinweise zu Firewall und Proxy auf Client-Seite.
	Beachten Sie die Betriebsnummern und PINs für die Testzugänge, siehe Test-Login
	Wichtiger Hinweis für Nutzer des HitBatch-Clients: Im Archiv HitBatch.zip befindet sicht außer dem Batch-Client HitBatchMain.class mit dem zugehörigen Parameterdatei HitBatch.ini und Datenbeispielen Daten\GEBURT.CSV noch ein Testprogramm HitTest.class mit Parameterdatei HitTest.ini und Datenbeispielen Daten\test.....CSV mit dem Befehle des HIT-Protokolls direkt abgeschickt und getestet werden können. Die Dateien für den HitTest haben den Aufbau "*n:<Aktion>:<Objekt>:<Daten>". Die echten Inputdateien für den HitBatch sind viel einfacher aufgebaut und haben nur eine Überschriftszeile und mehrere Datenzeilen. In der nächsten Version werden die Inputdateien der beiden Programme in getrennten Unterverzeichnissen gespeichert.

Die jeweils aktuellen Informationen zu HI-Tier Internet-Adressen und Ports siehe IP-Adressen.

Installation

1. JRE (=Java Runtime Environment) oder JDK (=Java Development Kit) bzw SDK (=Software Development Kit), welches ein JRE beinhaltet, installieren

   z.B. Java5 Download SDK bzw JRE , z.B. von Sun http://java.sun.com/ Installieren im vorgeschlagenen Verzeichnisbaum (z.B. C:\Programme\Java\jdk1.5.0_22 oder unter eigenem Verzeichnis) Die Pfadangaben PATH und CLASSPATH werden dabei selbsttätig gesetzt; es sind keine weiteren Änderungen nötig. Wichtig ist nur, daß eventuell während der Installation geöffnete Eingabeaufforderungen (= DOS-Box, CLI, ...) die neuen Pfadangaben nicht kennen, da diese nur beim Start dieser übernommen werden.

2. Allgemeine Unterprogramme im Package HitUpros laden und installieren
   1. Archiv HitUpros.zip herunter laden und in geeignetes Verzeichnis entpacken, z.B: C:\Projekt\HIT
   2. Sie sollten nach dem Entpacken im Verzeichnis C:\Projekt\HIT ein Verzeichnis mit dem Namen HitUpros haben
   3. eine Variable CLASSPATH wird i.d.R. direkt beim Aufruf von Java angegeben, z.B.: java -classpath C:\Projekt\HIT\HitUpros\HitUpros.jar
3. HitBatch-Client laden, anpassen und starten
   1. Archiv HitBatch.zip herunter laden und in geeignetes Verzeichnis entpacken, z.B: C:\Projekt\HIT
   2. Sie sollten nach dem Entpacken im Verzeichnis C:\Projekt\HIT u.a. ein Verzeichnis mit dem Namen HitBatch haben
   3. Steuerdatei HitBatch.ini im Verzeichnis HitBatch anpassen
   4. Datenmuster im Verzeichnis Daten im Verzeichnis HitBatch anpassen bzw. geeignet erzeugen
   5. Startdatei-Muster HitBatch.cmd im Verzeichnis HitBatch anpassen

      	Die Variable BASEDIR auf Ihren Pfad setzen, z.B. auf C:\Projekt\HIT, also: SET BASEDIR=C:\Projekt\HIT
      	Umgebungsvariable CLASSPATH ist im Script bereits unter der Verwendung der Variable BASEDIR korrekt gesetzt

   6. Internetverbindung aufbauen und Startdatei ausführen

Sollten Sie den HitBatch (und auch HitUpros) in einem anderen Verzeichnis als in dem hier genannten C:\Projekt\HIT installiert haben, ersetzen Sie einfach in der obigen Beschreibung jedes C:\Projekt\HIT durch Ihren Verzeichnispfad. Es müssen die beiden Verzeichnisse HitUpros und HitBatch in diesem Verzeichnis vorhanden sein!

Unter Linux und anderen Betriebssystemen verläuft die Installation ähnlich: ggf. Installation der JRE, dann Installation der Pakete HitUpros und HitBatch in ein gewünschtes Verzeichnis (z.B. ~/projekt/hit unter Linux). Dann wie unter Punkt 2 weiter verfahren.

WICHTIG: Achten Sie bitte unbedingt auf die korrekte Groß-/Kleinschreibung der Java-Dateien; gleiches gilt (vorsichtshalber) auch für Verzeichnispfade!!!

Hinweise zur Installation

	Zum Entpacken empfehlen wir 7-Zip,  InfoZip, das kostenpflichtige WinZip oder andere Entpacker. Bei manchen Entpackern werden teilweise die Dateinamen auf das alte 8.3-System gekürzt, was Java nichts nützt, da es die vollen Klassennamen benötigt.
	Findet Java gewünschte Klassen nicht (z.B. wegen einer NoClassDefFoundError Exception), überprüfen Sie, ob Java in der Umgebungsvariable CLASSPATH auch wirklich folgende Pfade in dieser Reihenfolge enthält: . (der Punkt steht für: aktuelles Verzeichnis) C:\Projekt\HIT\HitUpros\HitUpros.jar (wenn Sie die Hit-Klassen in C:\Projekt\HIT installiert haben) C:\Projekt\HIT\HitBatch\HitBatch.jar (wenn Sie die Hit-Klassen in C:\Projekt\HIT installiert haben) Weitere Angaben im CLASSPATH können vorhanden sein, da sie für den HitBatch keine Rolle spielen. Ob Sie diese Pfade direkt in den Systemeinstellungen einstellen oder sie per Script bei jedem Java-Aufruf angeben, ist hierbei ohne Bedeutung. Weiters ist zu prüfen, ob der Aufruf des HitBatch über die Klasse HitBatch.HitBatchMain gestartet wird ("HitBatch" alleine stimmt nicht mehr). Auf die Groß-/Kleinschreibung unbedingt achten! Siehe Hinweise.
	Ergänzen Sie am besten noch die Umgebungsvariable PATH um den Eintrag C:\Projekt\HIT\HitBatch, dann können Sie von jedem Verzeichnis aus das Hilfsscript HitBatch.cmd aufrufen, z.B. so: hitbatch.cmd bestreg.ini
	Erhalten Sie keine Verbindung zum HitServer, dann können Sie folgende Tests durchführen: Versuchen Sie einen Ping auf den HitServer abzusetzen. Schreiben Sie im DOS-Fenster: ping hitserver.hi-tier.de oder ping 212.18.9.50. Erhalten Sie eine Fehlermeldung statt eine Auflistung der erfolgreichen Pingmeldungen, dann können Sie beispielsweise wegen einer Firewall zwischen Ihrem Rechner und dem Internet nicht zu uns gelangen. Versuchen Sie auch den Backup-Server zu erreichen, für den Fall, daß der Hauptserver außer Betrieb sein sollte: ping hitbackup.hi-tier.de oder ping 194.94.221.1. Gelingt dies, dann versuchen Sie eine telnet-Verbindung direkt zum HitServer aufzubauen. Dazu schreiben Sie im DOS-Fenster: telnet hitserver.hi-tier.de 2222 oder telnet 212.18.9.50 2222 beziehungsweise bei Hauptserverausfall telnet hitbackup.hi-tier.de 2222 oder telnet 194.94.221.1 2222. Erhalten Sie hier eine Meldung vom HitServer, daß er bereit sei, dann können Sie auch mit dem HitBatch darauf zugreifen. Lösungsansätze: Benutzen Sie T-Online mit Modem-Einwahl als Internetdienst, dann sollten Sie Ihre Internetanbindung anders konfigurieren. Auf der Seite von Albert Rommel finden Sie Informationen, wie Sie eine DFÜ-Verbindung zu T-Online einrichten können. Melden Sie sich dann über diese DFÜ-Verbindung an und testen erneut, ob Sie eine Verbindung zu uns erhalten. Für Firmen gibt es eventuell noch den Sonderfall, dass Sie mit einem Ping bestätigt bekommen, daß unser Server am Netz hängt, Sie jedoch per telnet keine Verbindung aufbauen können. In dem Fall sollten Sie Ihren Systemadministrator kontaktieren, ob die Firewall der Firma überhaupt Daten über den Port 2222 durchlässt und bitten Sie ihn ggf. diesen frei zu schalten.