HOBLink J-Term Eclipse Plugin HOB GmbH & Co. KG Schwadermühlstraße 3 90556 Cadolzburg Deutschland E-Mail: support@hob.de Internet: www.hob.de Seite 1 von 7
1. Übersicht: Eclipse und HOBLink J-Term Eclipse ist ein Framework zur Entwicklung von Software nahezu aller Art. Die bekannteste Verwendung ist die Nutzung als Entwicklungsumgebung (IDE) für die Programmiersprache Java. Eclipse wird aufgrund seiner offenen plugin-basierten Struktur mittlerweile für sehr unterschiedliche Entwicklungsaufgaben eingesetzt. HOB bietet mit dem J-Term Eclipse Plugin eine Software, die als Plugin in Eclipse eingesetzt werden kann. Es dient dazu, HOBLink J-Term auch in Eclipse nutzbar zu machen. HOBLink J-Term ist eine leistungsfähige Software-Lösung für die effiziente und kostensparende Anbindung aller Client-Plattformen an zentrale Daten und Applikationen. HOBLink J-Term bietet eine benutzerfreundliche Terminalemulation von 3270-, 5250-, VT-, HP700-, SINIX 97801- und 9750-Terminals 2. Installation Das J-Term Eclipse Plugin wird in Form einer komprimierten Datei im ZIP-Format geliefert. Um das Plugin auszuführen, muss auf dem Rechner Eclipse ab 3.2 installiert sein. Für die Installation genügt es, die Software mit einem beliebigen Komprimierungsprogramm (z.b. 7-Zip oder WinZip) zu entpacken und den Inhalt in den Plugin-Ordner von Eclipse zu kopieren, z.b. C:\eclipse\plugins Dabei ist zu beachten, dass die vorhandene Ordnerstruktur beim Dekomprimieren beibehalten wird. Es entsteht im Plugin-Ordner also das Unterverzeichnis C:\eclipse\plugins\de.hob.jterm_1.0.0 Seite 2 von 7
3. Installation der Online-Hilfe Die Online-Hilfe zum J-Term Eclipse Plugin wird mitgeliefert als zip-datei JTermEclipsePluginHelp.zip. Die Online-Hilfe kann bei Bedarf separat installiert werden. Dazu gibt es zwei Möglichkeiten: 1. Lokale Installation Dazu extrahieren Sie die Dateien aus der Datei JTermEclipsePluginHelp.zip in das Verzeichnis \www\help innerhalb des Installationsverzeichnisses, also beispielsweise in C:\eclipse\plugins\de.hob.jterm_1.0.0\www\help 2. Installation auf einem Web-Server Die Online-Hilfe kann auf einem beliebigen Webserver kopiert werden. In diesem Fall ist eine Änderung im mitgelieferten Source-Code der Klasse HOBView (Datei HOBView.java) notwendig. Ändern Sie dazu in der Funktion createpartcontrol die Zeile HobContext.setFeature(K.FEATURE_HELPSERVER,"http://hobrd.hob.de/EA2/"); indem Sie die URL (http://hobrd.hob.de./ea2/)durch die URL Ihres Servers ersetzen. Kopieren Sie anschließend die Dateien aus der zip-datei JTermEclipsePluginHelp.zip in das Verzeichnis /www/help auf dem Webserver innerhalb dieser URL. 4. Sessions vorkonfigurieren durch den Administrator Der Administrator kann für den Benutzer zwei Sessions vorkonfigurieren. Um die Sessions für den Benutzer vorzukonfigurieren, startet der Administrator die mitgelieferte Datei jterm.exe: C:\eclipse\plugins\de.hob.jterm_1.0.0\jterm.exe Bitte beachten Sie: Damit diese Exe-Datei ausgeführt werden kann, muss die Environment-Variable java_home auf ein Verzeichnis gesetzt sein, das die Datei java.exe enthält. Die Datei jterm.exe startet den HOB EA Session Manager. Mit dessen Hilfe kann der Administrator zwei Sessions erstellen, die vom J-Term Eclipse Plugin verwendet werden. Diese Sessions müssen die Bezeichnungen HOST1 und HOST2 tragen. Seite 3 von 7
5. Produktschlüssel eingeben Beim Starten des J-Term Eclipse Plugin erscheint folgende Meldung: Wenn Sie keinen Produktschlüssel besitzen, können Sie nur einen bestimmten Zeitraum testen, danach lässt sich die Software nicht mehr starten. Wenn Sie nach Ablauf dieser Frist noch weiter testen möchten, klicken Sie auf den Button "Test verlängern". Falls Sie eine Vollversion besitzen, haben Sie zusammen mit der Software einen Produktschlüssel erhalten. In diesem Fall starten Sie das Programm ProductKey.exe, das sich im Installationsverzeichnis von J-Term Eclipse Plugin befindet, also z.b. C:\eclipse\plugins\de.hob.jterm_1.0.0\ProductKey.exe Geben Sie dort Ihren Produktschlüssel ein sowie das Installationsverzeichnis des J-Term Eclipse Plugin, z.b. C:\eclipse\plugins\de.hob.jterm_1.0.0\ Seite 4 von 7
6. J-Term Plugin starten Um das J-Term Eclipse Plugin anzuzeigen, starten Sie Eclipse und wählen Sie den Menüpunkt Windows/Show View/other... Es öffnet sich das Fenster "Show View", das die installierten Plugins anzeigt. Das J-Term Eclipse Plugin finden Sie unter dem Knoten "HOB View". Wenn Sie diesen Knoten öffnen, erscheinen die beiden vorkonfigurierten Sessions "HOST1" und "HOST2". Mit einem Doppelklick auf eine der beiden Konfigurationen öffnen Sie das Terminalfenster, das die Verbindung zum jeweiligen remote Host herstellt. Seite 5 von 7
7. Verbindungen konfigurieren Der Benutzer erhält die vorkonfigurierten Sessions des Administrators. Um eine Session selbst zu konfigurieren, verwendet der Benutzer den HOBLink J-Term Session Editor. Dazu klicken Sie in der Symbolleiste auf das Symbol "Einstellungen". Information zur Konfiguration der Sessions finden Sie in der Online-Hilfe des Session Editors. Sessions, die vom Administrator erstellt werden, werden in einem Unterverzeichnis des J- Term Eclipse Plugins gespeichert, z.b: C:\eclipse\plugins\de.hob.jterm_1.0.0\configuration Sessions, die der Benutzer geändert hat, werden in einem Ordner innerhalb des User- Verzeichnisses gespeichert, z.b. C:\Dokumente und Einstellungen\Username\Anwendungsdaten\hob\ea Bitte beachten Sie: Die Konfigurationsdateien von J-Term Eclipse Plugin und von HOBLink Terminal Edition werden beide in denselben Verzeichnissen gespeichert, d.h. wenn der Benutzer beide Produkte gleichzeitig einsetzt, besteht die Gefahr, dass sich die Einstellungen gegenseitig überschreiben. Der Benutzer sollte daher nicht mit beiden Programmen gleichzeitig Konfigurationen bearbeiten. Seite 6 von 7
HOB Software und Dokumentation 2007 Telefon: +49-9103/715-161 Fax: +49-9103/715-299 Alle Informationen in diesem Dokument gehören HOB und dürfen ohne unsere Einwilligung nicht verändert werden. Sie stellen keine Verpflichtungen von Seiten der Firma HOB dar. Alle Rechte sind vorbehalten. Die Wiedergabe des redaktionellen Inhalts oder von Grafiken und Bildern ist ohne ausdrückliche Erlaubnis von Seiten der Firma HOB verboten. Die Software und die Dokumentation wurden getestet und geprüft. HOB ist allerdings nicht für Verluste oder Beschädigungen verantwortlich, die aus dem Gebrauch irgendeiner Information, Einzelheiten, Fehlern oder Auslassung dieser Dokumentation entstehen. Alle verwendeten Produktnamen sind Warenzeichen oder eingetragene Warenzeichen ihrer jeweiligen Gesellschaften. Seite 7 von 7