Inhaltsübersicht
| Table of Contents | ||
|---|---|---|
|
Lizenz prüfen
Fehlersuche und -behebung auf IBM i
...
Den Job TCPDXPSERV (läuft im Subsystem QINTER) mit Option *IMMED beenden - natürlich darf zu dem Zeitpunkt kein User mit dataxpress arbeiten!
Subsystem und Jobs
Im Diese Jobs laufen alle im Subsystem QINTER läuft der .
1. Der Job TCPDXPSERV.
Dieser Job startet für die Anfragen von den PCs mehrere Jobs, die auch in QINTER laufen. Die Namen dieser Jobs beginnen mit DXP, gefolgt von einer 5-stelligen Zahl (z.B. "DXP11000").
2. Pro PC-Sitzung werden drei DXP DXPxxxxx-Jobs gestartet. Zum Beispiel: DXP11000, DXP11003, DXP11006. Standardmässig stehen Sie in der Funktion PGM-STRLINK
...
Die Namen der Jobs sind willkürlich.
Logs/Protokolle/Dumps (IBM i)
Protokoll-Dateien auf IBM i
Wenn die Protokollierung eingeschaltet ist (Stelle 222 des DXPDTAARA auf "LL", siehe nächsten Abschnitt), dann schreibt das System Protokoll-Information in die Datei DATXPRESS/RPRT:
DSPPFM DATAXPRESS/RPRT
Die Protokollierung einschalten auf IBM i
1. CLRPFM DATAXPRESS/RPRT
2. CHGDTAARA DTAARA(DATAXPRESS/DXPDTAARA (222 2)) VALUE('LL')
...
Ab jetzt wird die Datei DATAXPRESS/RPRT mit trace-Daten gefüllt.
Die Protokollierung ausschalten auf IBM i
1. CHGDTAARA DTAARA(DATAXPRESS/DXPDTAARA (222 2)) VALUE(' ')
...
Start → Programme → dataxpress→ dataxpress Administrator
Logs/Protokolle/Dumps auf dem Windows-Client
Protokoll-Datei auf dem Windows Client
- Die Protokolldateien des Windows Clients liegt im temporären Verzeichnis des jeweiligen Users.
- %TEMP%\DataXPress.log (SQL-Befehl u.a.)
- %TEMP%\DataXPress.out (trace der Makroausführung)
- %TEMP%\AS2PCDXP.log
- %TEMP%\DataXPress.log (SQL-Befehl u.a.)
- Wenn das Upload-Add-In installiert ist, dann gibt es u.U. auch die Datei
- %TEMP%\DxpUpload.log
Protokollierung ein und ausschalten - auf dem Windows Client
Start → Programme → dataxpress→ dataxpress Administrator, Registerkarte "Allgemein"
...
Bei eingeschalteter Protokollierung (siehe oben) findet man im Protokoll in der Datei %TEMP%\dataxpress.log auch die von dataxpress generierten SQL-Anweisung.
Erforderliche Windows-Komponenten
Microsoft Redistributable und Visual Studio-Komponenten
Stellen Sie sicher dass die folgenden Komponenten auf dem PC installiert sind (Start → Systemsteuerung → Programme und Features):
- Microsoft C++ 2015 Redistributable (x86) (oder höher)
- Microsoft Visual Studio 2010 Tools for Office Runtime (x64)
- Microsoft Visual Studio 2010 Tools for Office Runtime (x64) Language Pack - DEU
Zum Beispiel kann die Anzeige so aussehen (hier ist die C++ 2017 Redistributable installiert)
Wenn diese Komponenten nicht bereits auf dem PC vorhanden sind, dann soll die dataxpress-Installationsroutine sie hinzufügen. Sollte dies aus irgendeinem Grunde nicht geschehen sein, müssen sie manuell von Microsoft heruntergeladen und installiert werden.
Nur für Upload-Funktion: ODBC-Treiber für die IBMi
Wenn die dataxpress-Upload Funktion verwendet werden soll, dann müssen die ODBC-Treiber für den Zugriff auf die Datenbank installiert sein.
Diese sind Bestandteil
- entweder des aktuellen "IBM i Access Client Solution" - "Windows Application Package"
- oder des alten "IBM i Access für Windows (auch "Client Access" genannt)
Man kann prüfen, ob die ODBC-Treiber verfügbar sind, indem man auf dem PC die ODBC-Verwaltung für 32bit aufruft (den "ODBC-Datenquellen-Administrator (32-Bit)") und den Button "Hinzufügen" klickt:
Wenn hier einer oder mehrere dieser Treiber angeboten werden, dann sind die ODBC-Treiber installiert:
- Client Access ODBC Driver (32-bit)
- IBM i Access ODBC Driver
- iSeries Access ODBC Driver
Die Treiber sind alle gleichwertig, die verschiedenen Namen sind nur aus Kompatibilitätsgründen erforderlich.
Es nicht nicht erforderlich, eine Datenquelle zu erstellen! Sie können jetzt abbrechen.
Diese Schritte sind nur dazu da, festustellen, ob die ODBC-Treiber installiert sind, die vorhanden sein müssen, damit die dataxpress-Upload-Funktion funktioniert.
(Natürlich kann man zu Diagnosezwecken eine Datenquelle erstellen. Aber dataxpress braucht keine.)
Weitere Infos dazu: Datenzugriff mit ODBC / ADO .Net - Treibern von IBM
Wichtige Registry-Keys für dataxpress
Download (Standard)
HKEY_CURRENT_USER/Software/Microsoft/Office/16.0/Excel/OptionsWert:
- "C:\PROGRA~2\TOOLMA~1\DATAXP~1\XQ97.XLA"
Die Versionsnummer (hier die 16.0) hängt von der MS Office-Version ab (vgl. https://de.wikipedia.org/wiki/Microsoft_Office und https://docs.microsoft.com/de-de/officeupdates/update-history-office365-proplus-by-date):
2010 14.0
2013 15.02016 365-1910 16.0
2019 365-1912 16.0
Zur Installation des Add-Ins XQ97.XLA reicht es hin, einen Eintrag zu erstellen. Excel wird dann beim nächsten Start versuchen das Add-In zu laden. Sollte es bereits "OPEN"-keys geben, so muss durchnumeriert werden:
DXP Upload
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Excel\AddIns\DXPOutlook2k13
...
Support-Fälle
DSPLICINFO *FULL zeigt "9312 Zertifikatdatei im IFS nicht gefunden" trotz korrekter Lizenzdatei
Obwohl die von Toolmaker empfangene Lizenzdatei korrekt im IFS-Verzeichnis /Toolmaker abgelegt ist, kommt diese Fehlermeldung
Lösung:
Der Name der Lizenzdatei muss geändert werden: die Angabe der LPAR entfernen:
- vorher:
License_DATAXPR_04_78A4721_LPAR85.txt - nachher:
License_DATAXPR_04_78A4721.txt
Ursachencode 704: Evoke failed <MajorCode : 83, MinorCode : 1A>
...
Es werden nur die Upload-Icons angezeigt
Lösung 1: Verbindungskonfiguration zur IBM i korrigieren
Bitte prüfen Sie im dataxpress-Administrator (Start → Programme → dataxpress → DataXpress Administrator, Registerkarte TCP/IP) angegebene Verbindungskonfiguration zu Ihrer IBM i:
Lösung 2: das Projekt "Analyse-Funktionen-VBA" deaktivieren (Office 2016)
In einem Fall verhinderte dieses von Microsoft gelieferte Projekt die Ausführung des auto_open - Makros von dataxpress.
Nachdem der Kunde dieses Projekt deaktivierte wurden auch die Download-Icons von dataxpress wieder sichtbar.
Weitere Informationen über das Projekt "Analyse-Funktionen-VBA" stellt Microsoft auf diesen Websites zur Verfügung:
- https://support.office.com/de-de/article/verwenden-der-analyse-funktionen-um-komplexe-datenanalysen-auszuf%C3%BChren-6c67ccf0-f4a9-487c-8dec-bdb5a2cefab6
- https://support.office.com/de-de/article/laden-der-analyse-funktionen-in-excel-6a63e598-cd6d-42e3-9317-6b40ba1a66b4
Lösung 3: Einstellungen des Trust Centers anpassen
Dataxpress Pfad in den Vertrauenswürdigen Speicherorten hinzufügen
Makroeinstellung - Alle Makros mit Benachrichtigung deaktivieren
Bei Zugriffsanstellungen Excel 97-2003 Add-in Dateien und Excel Add-in Dateien sicherstellen dass die Kontrollkästchen bei Öffnen und Speichern nicht gecheckt sind
Lösung 4: das Add-in manuell nachladen
In diesem enster fehlt das "DataXPress" Add-in
So soll es aussehen:
Zum Nachladen "Excel-Add-Ins" auswähelen und auf "Los" klicken:
Im nächsten Fenster "Durchsuchen" klicken
Die Datei %PROGRAMFILES(X86)\Toolmaker\DataXPress\Xq97.xla auswählen
Fenster mit Fehler E_FAIL(0x80004005) beim Erstellen einer Abfrage oder beim Laden der Rechte
Dieser Fehler deutet darauf hin, dass dataxpress keine Verbindung zur IBM i herstellen kann.
Es muss geprüft werden, ob der PC die IBM i "erreichen" kann:
- funktioniert ein PING auf die IBM i?
- kann man die 5250-Emulation starten?
Im vorliegenden Fall war nach einem Neustart des PCs der VPN-Tunnel nicht wieder neu gestartet worden.
Doppelklick in eine Zelle startet das dataxpress-Abfragemenü
Ohne den dataxpress-Client führt ein Doppelklick eine Zelle dazu, dass die Zelle zum Bearbeiten (Kopieren, Ausschlagen) geöffnet wird.
Dieses wird von dataxpress geändert: ein Doppelklick öffnet das Menü zum Bearbeiten einer Abfrage.
Dieses Verhalten wird durch eine Einstellung des dataxpress-Clients gesteuert. Um es abzuschalten ist so vorzugehen:
1. Add-Ins → dataxpress → Konfiguration
2. Checkbox "Aufruf mit Doppelklick" deaktivieren
