Die Installation erfolgt in zwei Schritten die in zeitlicher Reihenfolge unabhängig voneinander ablaufen können. Wir empfehlen zunächst die Installation der IBM i, dann die Installation der PC-Software vorzunehmen.

Installation und Kennwortvergabe IBM i

Die Installation von dataxpress erfolgt entweder über die mitgelieferte DVD, oder über die von der Toolmaker Webseite herunterladbare Installationsdatei. Sämtliche Objekte und Dateien für dataxpress sind in der Bibliothek DATAXPRESS abgelegt.

Hinweis:

Das Installationsprogramm erstellt in Ihrem System IBM i eine Bibliothek mit dem Namen DATAXPRESS. Eigentümer dieser Bibliothek und der darin enthaltenen Objekte ist das Benutzerprofil QPGMR.

Update

Falls es sich um eine Update-Installation handelt, vergewissern Sie sich, dass niemand mit dem Programm arbeitet.

ACHTUNG

Die benutzerspezifischen Programme (Exit-Programme für entfernte Aufrufe) werden nur dann automatisch aus der Bibliothek DATAXPROLD in die Bibliothek DATAXPRESS kopiert wenn deren Name mit USR beginnt. Sollten Sie benutzerspezifische Programme mit anderen Namen verwendet haben, müssen Sie diese nach der Installation manuell aus der Bibliothek DATAXPROLD in die Bibliothek DATAXPRESS kopieren.

Automatische Installation von directweb

Mit der Installation von dataxpress wird automatisch directweb mit installiert. directweb ermöglicht die fortschrittliche browserunterstützte Bedienung von Teilen der Anwendung. Der hierfür benötigte HTTP-Server wird automatisch gestartet.
dirweb-Bibliotheken
Folgende Bibliotheken werden in Verbindung mit direcweb installiert: DIRWEB, DIRWEBCGI, DIRWEB-Sprachbibliotheken für deutsch, englisch, französisch, italienisch und polnisch, sowie die Bibliothek WOPIX, die Objekte für die Browser-basierten Routinen enthält.

Installation in iASP

Seit OS/400 V5R2 gibt es die Möglichkeit Anwendungen in independent Auxiliary Storage Pool (IASP) zu installieren. Wenn Sie dies vorhaben, installieren Sie die Software wie nachstehend beschriebenen:

1. Entpacken Sie die Installationsdatei dataxpress xx.xx deutsch.exe in einen beliebigen Ordner Ihres PCs.
2. Löschen Sie im Ordner in den Sie die Installationsdateien entpackt haben die Datei install.cmd und benennen die Datei install_iasp.cmd in install.cmd um.
3. Starten Sie per Doppelklick die Datei install.bat. Damit werden die Installationsprogramme auf Ihre IBM i System übertragen.
4. Melden Sie sich als Benutzer QSECOFR an und geben folgende Befehle ein:

SETASPGRP ASPGRP(Ihr iASP)
RSTOBJ OBJ(QINST* GETASPDEV*) SAVLIB(DATAXPRINS) DEV(*SAVF) SAVF(QGPL/TMSSAVF1) RSTLIB(QTEMP)
QTEMP/QINSTAPP
Damit wird dataexpress in den iASP installiert, den Sie mit dem Befehl SETASPGRP zugeordnet haben.
Wenn Sie die Anwendung im iASP installiert haben, wird zusätzlich zur Bibliothek DATAXPRESS im iASP eine weitere Bibliothek DATAXPRSYS in den System ASP installiert. Diese enthält die nicht im iASP lauffähigen Objekte. Sorgen Sie über einen Eintrag in die System- oder Benutzerbibliotheksliste dafür, dass diese Bibliothek im Zugriff ist.
Wenn Sie mit iASP arbeiten, fügen Sie bitte den Namen des von Ihnen verwendeten IASP in den Datenbereich DXPDTAARA an Stelle 210-219 ein, indem Sie z.B. folgenden Befehl eingeben:
CHGDTAARA DTAARA(DATAXPRESS/DXPDTAARA (210 10)) VALUE('IASP33')

Installation über CD-ROM-Laufwerk der IBM i

Mit der Lieferung von dataxpress erhalten Sie einen für Ihr IBM System IBM i geeigneten Datenträger, der sowohl die Server- als auch die PC- Software enthält.
Legen Sie die gelieferte DVD in das CD-ROM Laufwerk Ihrer IBM i ein.
Melden Sie sich am System IBM i mit einem Benutzerprofil an, das über die Sonderberechtigung *ALLOBJ verfügt (z. B. QSECOFR).
Geben Sie von einer beliebigen Befehlszeile folgenden Befehl an:
LODRUN DEV (xxxxx)
wobei OPT01 ggf. durch den tatsächlichen Namen Ihrer CD-ROM-Einheit ersetzt werden muss.

Installation über PC

Vorzugsweise können Sie die Installation mit Hilfe des Toolmaker IBM i Installers durchführen. Hierbei erfolgt die Installation an einem angeschlossenen PC (an dem Sie mit Administratorrechten angemeldet sein müssen), Sie benötigen keinen Zugriff zum CD-ROM-Laufwerk der IBM i, es muss nur FTP aktiv sein und Sie müssen die TCP/IP-Adresse Ihres Systems sowie das QSECOFR-Kennwort wissen.
Legen Sie die gelieferte DVD in das CD-ROM Laufwerk Ihres PCs ein.
Starten Sie diese Variante der Installation durch Doppelklick auf die Datei dataxpress xx.xx deutsch.exe aus dem Root-Verzeichnis der Installations-DVD. Die selbst extrahierende Datei führt Sie Schritt für Schritt durch die Installation.

1020 – Toolmaker Installer
Bestätigen Sie die Hinweise zur Installation durch Klick auf den Button „OK".

1021 – Toolmaker IBM i Installer
Klicken Sie zum Start der Installation auf den Button „Setup".

1022 – Installationsdialog
Starten Sie nach Eingabe von IP-Adresse und QSECOFR-Kennwort die Installation durch Klick auf den Button „INSTALL". Am Ende der Installation können Sie sich das Joblog durch Klick auf den Button „Show IBM i log" anzeigen lassen. Am Ende des Joblogs steht bei erfolgreicher Installation „Produkt wurde erfolgreich installiert". Sollten Sie diese Meldung nicht sehen, wenden Sie sich bitte zwecks Prüfung des Installationsvorganges an die Toolmaker Hotline. Sie können hierfür das Joblog speichern und per e-Mail an die Toolmaker Hotline senden.

Installation über Download

Laden Sie sich die Installationsdatei dataxpress xx.xx deutsch.exe über die Toolmaker Webseite aus dem Bereich Information - Software – dataxpress herunter und starten die Installation per Doppelklick auf die .exe-Datei.
Die selbst extrahierende Datei führt Schritt für Schritt durch den Installationsvorgang (siehe oben), am Ende des Installationsprogramms können Sie sich das Joblog des Installationsjobs anzeigen, am Ende sollte „Produkt wurde erfolgreich installiert" stehen. Sollten Sie diese Meldung nicht sehen, wenden Sie sich bitte zwecks Prüfung des Installationsvorganges an die Toolmaker Hotline. Sie können hierfür das Joblog speichern und per E-Mail an die Toolmaker Hotline senden.
Hinweis: Während des Downloads wird der HTTP-Server für directweb kurzzeitig beendet und nach der Installation automatisch wieder gestartet.

Installation Online-Hilfesystem

Toolmaker liefert dataxpress mit einer Online-Hilfe aus, die feldbezogen Informationen zum jeweils angezeigten Bildschirm bietet. Damit erübrigt sich oftmals die Suche im PDF- oder ausgedrucktem Handbuch, da in der Online-Hilfe die gleichen Informationen enthalten sind. Die Online-Hilfe wird mit der Installation von dataxpress installiert.
Hinweis
Funktioniert die Anzeige der Online Hilfe nicht, kann über die Toolmaker Webseite der directhelp Client heruntergeladen und auf den PCs installiert werden auf denen Hilfe angezeigt werden soll. Zur Aktivierung der Kommunikation über den directhelp Client ist im Befehl WRKHLPPTH der Parameter "Kommunikation mit PC" der Wert "DIRPCCMD" einzustellen.
Hinweis zu Windows Vista bzw. Windows7
Hilfedateien mit der Dateinamenerweiterung ".hlp" können unter Vista bzw. Windows7 nur in Verbindung mit WinHlp32.exe, das aus rechtlichen Gründen nicht mit ausgeliefert werden darf, angezeigt werden. http://support.microsoft.com/kb/917607

Konfiguration Online-Hilfesystem

Da jeder Toolmaker-Kunde individuelle Server-, Pfad- und Verzeichnisangaben verwendet, wurde das Online-Hilfesystem so entwickelt, dass dies mit wenigen Schritten an Ihre Umgebung anpasst werden kann.
Ermittlung von Pfad und Hilfedateiname
Für die Ermittlung des Pfades zur Hilfedatei wird folgende Reihenfolge verwendet, die bei den Einstellungen berücksichtig werden sollten:
Zuerst wird für den Benutzer, der die Hilfe aufruft, geprüft, welche Einstellungen für ihn in den Benutzereinstellungen (WRKHLPUSR) hinterlegt sind. Entweder stehen dort explizite Angaben die sofort verwendet werden oder *STD bei dem wie folgt weitergesucht wird:

0445 – Benutzereinstellungen in WRKHLPUSR
Die Suche in den Einstellungen die bei WRKHLPPTH unter dem Benutzer hinterlegt sind, dann unter einer Gruppe deren Mitglied der Benutzer ist und letztendlich unter *ANY wenn nichts Anderweitiges hinterlegt ist.

0446 – Benutzereinstellung in WRKHLPPTH
Ist im WRKHLPPTH nichts hinterlegt, wird die betreffende Anwendung analysiert und die dort hinterlegten Einstellungen verwendet.
Ist auch aus der Anwendung nichts zu ermitteln werden die Systemeinstellungen aus WRKHLPPTH (F10) verwendet.

0447 - Benutzereinstellung in WRKHLPPTH F10=Defaultpfad

Konfigurieren der Pfade

Starten Sie die Konfiguration mit
ADDLIBLE DATAXPRESS
WRKHLPPTH

1018 – Hilfepfade WRKHLPPTH
Es werden alle Produkte die mit directhelp-Hilfe ausgestattet sind angezeigt. Wählen Sie das Produkt für welches Sie die Pfadeinstellungen vornehmen wollen mit Auswahl 1 aus.

1023 - Mit Hilfepfaden arbeiten
Sie können hier den Pfad zur Hilfedatei für die gewünschte Anwendung mit Auswahl 2 vor dem Eintrag mit dem Benutzer *ANY für alle Mitarbeiter ändern, oder mit F6 eine Definition für einzelne Benutzer/Gruppen anlegen.

1019 – Hilfepfad ändern
Anwendung
Hier steht der Name der Anwendung für den Sie den Pfad zur Hilfedatei einstellen wollen.
Benutzer/Gruppe
Mit *ANY können Sie hier eine Einstellung für alle Benutzer Ihres Systems vornehmen.
Individuelle Einstellungen für Benutzer, bzw. Gruppen erreichen Sie, indem Sie über den nachfolgend beschriebenen Befehl WRKHLPUSR Ihre Anwender anlegen und ggf. zu Gruppen zusammenfassen. Über den Befehl WRKHLPPTH können Sie dann statt Benutzer *ANY die angelegten Benutzer bzw. Gruppen verwenden um individuelle Speicherorte für Mitarbeiter (z.B. lokal auf dem PC für Außendienstmitarbeiter, auf dem Abteilungsserver, bzw. auf dem Filialserver) festzulegen. Weitere Informationen entnehmen Sie bitte dem Handbuch des Online-Hilfesystems directhelp.
Die Konfiguration für die Anzeige der Hilfe für Menüs und Befehlen entnehmen Sie bitte dem Handbuch von directhelp.
Pfad
Tragen Sie hier den Pfad zur Hilfedatei ein. Standardmäßig werden die Hilfedateien am Client des Benutzers unter c:\programme\toolmakerPRODUKTNAME installiert. Wir empfehlen die Hilfedateien wie vorgeschlagen lokal auf dem PC des Anwenders zu installieren, da andernfalls bei Verwendung der HTML-Hilfe zwar die Texte aber nicht die Abbildungen angezeigt werden (dies ist eine Restriktion von Microsoft).
Kommunikation mit PC
directhelp verfügt über einen eigenen Client der die Hilfe anzeigen kann. Sie können jedoch auch die Standardfunktion STRPCCMD verwenden mit Hilfe derer der Hilfeaufruf von der IBM i aus über die IBM i Access Routinen erfolgt, mit DIRPCCMD über den directhelp Client. Die Einstellung *DFT prüft welche Vorgabe Sie in der Benutzerregistrierung vorgenommen haben und übernimmt diese.

Konfigurieren der Benutzer

Starten Sie die Konfiguration mit
ADDLIBLE DATAXPRESS
WRKHLPUSR

1024 – Mit Hilfebenutzern arbeiten WRKHLPUSR
Hier können Sie die Einstellungen für einzelne Benutzer/Gruppen mit Auswahl 2 ändern, bzw. neue Definitionen mit F6 hinzufügen.

1025 – Benutzerregistrierung ändern
Die wichtigsten Parameter hier sind:
Benutzer/Gruppe
Wählen Sie hier den Namen oder die Gruppe aus für die Sie den Hilfepfad festlegen wollen
Pfad
Hier geben Sie den Pfad zur Hilfedatei ein. Der Pfad setzt sich aus Laufwerk, Pfad, Sprache und Hilfedatei zusammen. Dabei stehen Ihnen neben der direkten Eingabe des Pfades auch Platzhalter zur Verfügung die im directhelp Handbuch nachzuschlagen sind.
Kommunikation mit PC
Hier wird die Art der Kommunikation der IBM i mit dem PC angegeben. Mit der Funktionstaste F4 kann aus den verfügbaren Möglichkeiten ausgewählt werden.
Gültige Werte sind:
STRPCCMD IBM i Access for Windows
DIRPCCMD directhelp Client

Kennwortvergabe

Nach der Erstinstallation funktioniert dataxpress auf Ihrem IBM i-System zum Testen für die ersten 30 Tage ohne Kennwort uneingeschränkt.
Wollen Sie dataxpress über diesen Zeitraum hinaus nutzen, müssen Sie das mitgelieferte Kennwort entsprechend den Anweisungen im Anschreiben ins System eingegeben werden (Befehl INSPSW). Falls kein Kennwort vorliegt, bitte anfordern.

Lizenzprüfung

Um zu prüfen, welche Lizenzen auf dem System installiert sind, kann jederzeit der Befehl DSPLICINFO aufgerufen werden. Angezeigt werden die aktuell gültigen Lizenzen.

0140 – Befehl DSPLICINOF Option *FULL

0137 – Ausführung Befehl DSPLICINOF Option *FULL

0139 – Befehl DSPLICINFO – Anzeige installierte Lizenzen

Installation PC

Hinweis

Bevor Sie dataxpress auf Ihrem PC installieren, vergewissern Sie sich bitte, dass Excel korrekt installiert ist und gestartet werden kann, ohne dass Startdialoge wie Einrichtung oder Aktivierung angezeigt werden. Dann kann es nämlich zu Problemen bei der Aktivierung der AddIns geben.
Die hier beschriebene Vorgehensweise gilt nur für die Version Excel XP/2003/2007.

ACHTUNG

Um ordnungsgemäß mit dataxpress arbeiten zu können, müssen Sie vor einer Update-Installation IMMER die bestehende Version über die Systemsteuerung – Software deinstallieren. Die benutzerspezifischen Einstellungen bleiben dabei erhalten.
Die Installation auf dem PC erfolgt über die mitgelieferte Installations-DVD aus dem Verzeichnis \pc.
Starten Sie die Installation über "Start" – "Ausführen" wie folgt gezeigt, geben Sie Laufwerk und Pfad zur Installationsdatei Setup.exe ein und klicken auf "OK":

0001-Starten von SETUP.EXE
InstallShield leitet Sie durch die Installation:

0002 - Auswahl der Installationssprache

0108 – Installation benötigter Komponenten
Wenn einige Komponenten die noch nicht auf Ihrem System enthalten sind installiert werden müssen, erscheint dieser Dialog. Klicken Sie zur Installation auf „OK".

0003 - Installationsvorgang
.NET Framework
Wenn Sie WindowsXP mit Excel2003 installiert haben, ist auf Ihrem PC ggf. bereits das .NET Framework 2.0 installiert und Sie können diesen Installationsschritt überspringen. Andernfalls wird das Setup für Microsoft .NET Framework 2.0 installiert. Ohne dieses Framework können Sie dataxpress nicht nutzen!

0111 - .NET Setup
Klicken Sie zum Start der Installation auf „Weiter".

0112 – Lizenzvertrag
Akzeptieren Sie den Lizenzvertrag durch Aktivieren der entsprechenden Checkbox und klicken auf „Installieren". Die Installation des .NET Framework nimmt für sich einige Minuten in Anspruch.

0113 – Fertigmeldung .NET
Klicken Sie zum Abschluss der .NET-Installation auf „Fertig stellen". Nun müssen Sie ggf. Ihren PC neu starten. Rufen Sie danach die Installation von dataxpress erneut auf.
Abschluss der Installation durch Klick auf „OK"

0007 - Start der Installation von dataxpress
Klicken Sie zum Fortfahren auf „Weiter".

0008 - Auswahl des Installationsverzeichnisses
Wir empfehlen, das vorgegebenen Installationsverzeichnis zu verwenden. Klicken Sie zum Fortfahren auf „Weiter".

0081- Auswahl Installations-Setup
Hier können Sie optionale Komponenten für die Installation markieren.
Wollen Sie die dataxpress Upload-Funktion verwenden um Excel-Daten auf IBM i zu übertragen, aktivieren Sie diese Option. Bitte beachten Sie, dass es sich hierbei um eine kostenpflichtige Option handelt und weitere Konfigurationsarbeiten im Bereich der Zugriffssicherheit auf der IBM i notwendig sind um diese Möglichkeit zu nutzen.
Klicken Sie nach Auswahl der benötigten Optionen auf „Weiter".

0009 - Auswahl des Programmordners
Klicken Sie zum Fortfahren auf „Weiter".
Während der Installation wird der dataxpress Administrator aufgerufen. So kann während der Installation die entsprechende Konfiguration vorgenommen werden. Diese können natürlich auch später über den dataxpress Administrator eingegeben/korrigiert werden.

0010 - dataxpress Administrator - Allgemein

0011 - dataxpress Administrator – TCP/IP
IBM i Systemname
Der Name Ihrer IBM i.
Benutzername
Tragen Sie hier den Namen Ihres Benutzerprofils ein, oder ein anderes Benutzerprofil, dass die Rechte auf die abzufragenden Dateien besitzt.
Kennwort
Das hier eingetragene Kennwort wird verschlüsselt gespeichert
Kennwort wiederholen
Kennworteingabe zur Überprüfung wiederholen.
Lange Kennwörter unterstützen
Klicken Sie auf „Lange Kennwörter unterstützen" wenn Ihr System auf Kennwörter in Groß-/Kleinschreibung eingestellt ist.
Service Port Nummer
Der PC kommuniziert über ein TCP/IP-Socketprogramm mit der IBM i. Das dazugehörige Server-Programm läuft auf der IBM i. Um eine Verbindung zustande zu bringen, muss die Service-Port-Nummer mit dem Servicetabelleneintrag auf der IBM i übereinstimmen. Standardmäßig wird hier die Port-Nummer „50002" eingestellt. Sofern Sie diese Port-Nummer bereits anderweitig belegt haben, oder anders einstellen wollen, beachten Sie bitte, dass die Port-Nummern von PC und IBM i übereinstimmen. Die Servicetabelleneinträge auf der IBM i erreichen Sie über den OS/400-Befehle „CFGTCP", Auswahl 21 „Zugehörige Tabellen konfigurieren" und Auswahl 1 „Mit Servicetabelleneinträgen arbeiten".
Zeichenumsatztabelle
Stellen Sie hier die für Ihr Land, bzw. ihre Sprache gültige Zeichenumsetztabelle für die Unterstützung von Sonderzeichen ein.

0012 - dataxpress Abfrage/Upload-AddIn aktivieren
dataxpress Abfrage-AddIn aktivieren
Klicken Sie auf „dataxpress Abfrage-AddIn aktivieren" wenn das Abfrage-AddIn aktiviert werden soll.
dataxpress Upload-AddIn aktivieren
Klicken Sie auf „dataxpress Upload-AddIn aktivieren" wenn das Upload-AddIn aktiviert werden soll.

0013 - Abschluß der Installation
Starten Sie nach Abschluss der Installation Ihren PC neu.

Hinweise

Wenn am Ende der Installationsroutine eine Fehlermeldung "Excel nicht gefunden" kommt, können Sie diese hier ignorieren und das Excel AddIn direkt in Excel über „Extras" – „Vorlagen und AddIns" aus dem Verzeichnis „\programme\toolmakerdataxpress" hinzufügen.
Das Installationsprogramm erstellt auf Ihrem PC ggf. ein neues Unterverzeichnis und kopiert verschiedene Dateien in dieses Verzeichnis.
dataxpress wird aufgerufen durch Laden der Datei XQ97.XLA in Microsoft Excel. Obwohl Sie im Prinzip diese Datei auch vom Netzwerklaufwerk laden können, wird diese Vorgehensweise nicht empfohlen, da Einstellungen, die in der Datei XQ.INI gespeichert werden, dann für alle Benutzer gelten. Die Dateien XQ97.XLA, XQ97.DLL, XQ.HLP und XQ.INI müssen sich im gleichen Verzeichnis befinden.
Nachdem Sie dataxpress installiert haben müssen Sie die Verbindung zur IBM i konfigurieren. Schlagen Sie hierzu im Kapitel „PC-Konfiguration – Verbindung" nach

Silent-Installation

Um in größeren Umgebungen dataxpress auf mehreren PCs zu installieren, können Sie eine unbeaufsichtigte Installation erstellen, indem Sie einmal die Installationsdatei setup.exe mit dem Parameter /r ausführen (setup.exe /r). Im Windows-Verzeichnis finden Sie nach dieser Installation die Datei setup.iss in der alle bei der Installation angepassten oder übernommenen Parameter stehen. Diese Datei können Sie nun in das Installationsverzeichnis von dataxpress kopieren und die Installation batchgesteuert mit setup.exe /s aufrufen. Die Installation erfolgt dann ohne Benutzereingriff.
Wenn Sie dann einmal die Administrator-Einstellungen wie im nächsten Kapitel beschrieben vornehmen und die Registry-Einträge unter
\\HKEY_LOCAL_MACHINE\Toolmakerdataxpress (file:////HKEY_LOCAL_MACHINE//Toolmaker//DataXPress) sowie \\HKEY_CURRENT_USER\Toolmakerdataxpress (file:////HKEY_CURRENT_USER//Toolmaker//DataXPress)
jeweils in eine Datei mit Endung .reg exportieren, können Sie über den Befehl regedit.exe /s dateiname.reg in der gleichen Batchdatei wie die Silent-Installation laufen lassen, haben Sie mit der Konfiguration von dataxpress auch keine große Arbeit.
Auf der Installations-DVD finden Sie ein Unterverzeichnis „silentsetup" mit einer Batchdatei silentsetup.bat sowie Beispiele der .iss und .reg-Dateien.