Inhaltsübersicht
Lizenz prüfen
Bibliotheken und Verzeichnisse für directword
Fehlersuche und -behebung auf IBM i
Version feststellen
IBM i-Version
GO LICPGM
, Auswahl 10, Taste F11
directword Version
WRKLIB DIRWORD
- in der Beschreibung steht die Versionsnummer
DSPDTAARA DIRWORD/prdrel
WOPiXX
Befehle zur Konfiguration
Start/Stop -Befehle
Subsystem und Jobs
Logs/Protokolle/Dumps
Protokoll-Datei DIRWORD/RPRT - Protokollierung ein- und ausschalten
Zu Test-/Debugzwecken kann die zwischen IBM i und PC stattfindende Kommunikation in eine Datei DIRWORD/RPRT protokolliert werden. An dieser Stelle wird die Protokollierung ein- bzw. ausgeschaltet.
Gültige Werte sind:
" "
Protokollierung wird ausgeschaltet"LL"
Protokollierung wird eingeschaltet
CHGDTAARA DTAARA(DIRWORD/DWDDTAARA (222 2)) VALUE('LL')
Nachdem Sie die Protokollierung ausgeschaltet haben, sollten Sie dafür sorgen, dass die Protokolldatei wieder gelöscht wird, indem Sie den folgenden IBM i Befehl eingeben:
CLRPFM DIRWORD/RPRT
IBM i - Protokolldatei DIRWORD/RPRT
select SRCDTA from DIRWORD/RPRT
Fehlersuche und -behebung auf dem Windows Client
Version feststellen
Windows
Microsoft Office
directword-Version
Start → Programme → directword→ directword Administrator, Registerkarte "Info"
Befehle zur Konfiguration
Start/Stop -Befehle
Logs/Protokolle/Dumps
Protokollierung ein und ausschalten
Start→ Programme → directword → directword Administrator, Registerkare Serverdaten
Protokoll-Dateien: %PROGRAMDATA%\Toolmaker\DirectWord\dirword.out
Auch anzeigbar über Start→ Programme → directword → directword Logdatei anzeigen
Protokoll-Dateien: %USERPROFILE%\AppData\Roaming\Toolmaker\DirectMedia\directrun.out
Hier wird geloggt, was während der Makroausführung passiert
Erhalten Sie beim Ausführen eines directword Befehls eine Fehlermeldung, so sollten Sie sich kurz die folgende Liste durchlesen. Suchen Sie die Kapitelüberschrift die zu Ihrer Fehlermeldung oder Problem am besten passt und lesen Sie die Tipps und Verweise, um den Fehler zu beheben.
Allgemeine Fehler
Wurde ein directword Befehl (z.B. DWMRGDOC) gestartet, so geschieht überhaupt nichts (keine Fehlermeldung, weder in der Sitzung noch auf dem Client).
Prüfen Sie, ob der directword TCP-Server gestartet ist und die Portnummer mit der auf der IBM i gespeicherten übereinstimmt.
Wurde ein directword Befehl (z.B. DWMRGDOC) gestartet so wird ein Dokument geöffnet, jedoch werden keine Daten eingemischt.
Prüfen Sie, ob im Word das AddIn directword.dot geladen wurde.
Stellen Sie sicher dass die Installation auf dem IBM i Server lizenziert ist.
Prüfen Sie ob die Datenübertragung über den TCP-Server fehlerfrei war. Prüfen der Datei unter C:\Dokumente und Einstellungen\AllUsers\Anwendungsdaten\Toolmaker\directword\directword.out.
0459 – directword.out
Bei VISTA bzw. WINDOWS7: ProgramData\Toolmaker\directword\directword.out
Stellen Sie sicher, dass die richtige Datendatei beim Aufruf der DW-Funktion übergeben wurde. Sie können dafür auch die Datei PKO...tmp (genauer Name und Pfad siehe Eintragungen in der directword.out-Datei) zum Vergleich mit einem Texteditor einsehen.
WINDOWS7
Die Firewall muß so durch den Administrator DWServ.exe
Visual Basic Fehler
Visual Basic Fehler können durch die Dialogart und die damit verbundene Fehlermeldung erkannt werden. Diese Fehler werden immer durch die Funktionen die in Microsoft Word ausgeführt werden (aus directword gestartet) verursacht.
Brechen Sie die Funktion immer mit Beenden ab und prüfen Sie die jeweiligen Einstellungen wie nachfolgend beschrieben. Beenden und starten Sie Word zwingend vor dem nächsten Versuch.
Laufzeitfehler 537: Der angegebene Makro kann nicht ausgeführt werden.
Prüfen Sie die Liste aller automatisch gestarteten Formatvorlagen in Word über die Menüfunktion Extras - Vorlagen und Add-Ins. In der Liste muss die Datei directword.dot eingetragen sein.
Laufzeitfehler 53: Datei POVBAEXT.DLL kann nicht gefunden werden.
Dieser Fehler tritt normalerweise nur in der Servervariante auf. Dabei kann die directword Visual Basic Erweiterung nicht gefunden werden. Prüfen Sie folgende Einstellungen:
Starten Sie die Systemeinstellungen über den Button Start– Einstellungen – Systemsteuerung – System
Aktivieren Sie die Registerseite Erweitert – Umgebungsvariablen und klicken in der Auswahlliste Systemvariablen auf die Variable Path.
Ergänzen Sie den Wert der Variablen, indem Sie den vorhandenen Text mit einem Semikolon und dem Installationspfad von directword erweitern. Booten Sie zwingend den PC nach dem Ändern des Wertes. Ist der ferne Windows NT Server (PC) zum Beispiel über TRN18 anzusprechen, so sollte der Wert am Ende wie folgt lauten:
C:\......;\\TRN18\directword\Programm
Grundlegende Test-Programme
In der Bibliothek DIRWORD stehen eine Reihe von Test-Programmen zur Verfügung, mit denen man die grundlegende Funktion von directword überprüfen kann.
Diese Programme heissen alle BEISP*. Ihre Quellen sind in der Quelldatei DIRWORD/QCLPSRC zu finden.
Sicherstellen, dass das "Erweiterte Protokoll" aktiviert ist
Starten Sie den directword-Administrator (Start → Programme → directword → directword Administrator) und stellen sie sicher, dass in der Registerkarte "Serverdaten" das Erweiterte Protokoll aktiv ist:
Word-Dokument lokal mischen und danach editieren: BEISP0200
ADDLIBLE DIRWORD
CLRPFM RPRT
CALL BEISP0200
- Das Dokument sollte jetzt auf dem PC erscheinen und gemischt werden, danach zum Editieren offen bleiben
DSPPFM RPRT
Word-Dokument auf einem Server mischen und drucken: BEISP02110
Sicherstellen, dass der Name "DWBATCH" mit dem Server-PC verbunden ist
- ADDLIBLE DIRWORD
- GO DIRWORD, Auswahl 4
- Sicherstellen, dass
- die Warteschlange "DWBATCH" mit der korrektein IP-Adresse/Name des Server-PCs verknüpft ist
- auf dem Server-PC das Programm DWServe.exe läuft und auf den angegebenen Port konfiguriert ist
- auf dem Server-PC der Dienst "DirWordService" nicht aktiv ist
Port 50004 ist konfiguriert, auf PC, wie auf IBM i:
Auf dem Server-PC läuft DWServ.exe:
Der Service "DirWordService" ist nicht aktiv:
Das Test-Programm BEISP0210 aufrufen
ADDLIBLE DIRWORD
CLRPFM RPRT
CALL BEISP0210
DSPPFM RPRT
Hotline-Fälle
DWMRGDOC (etc.) - Aufruf kommt nicht beim PC, bzw. Server an (2000040)
- Im Protokoll des PC oder Server findet man keinen Hinweis auf irgendeine Aktivität durch den DWMRGDOC (oder andere DW-Befehle).
- In der Datei DIRWORD/RPRT (siehe: Protokoll-Datei DIRWORD/RPRT - Protokollierung ein- und ausschalten) findet man die Zeile:
000000000000ERROR : getservbyname.
Lösung:
Es fehlte der Servicetabelleneintrag für den Port 50004:
Prüfen mit WRKSRVTBLE und blättern, bis man ihn findet:
Wenn nicht vorhanden, hinzufügen:
ADDSRVTBLE SERVICE(DWRDSRV) PORT(50004) PROTOCOL(TCP) TEXT('directword')
Fehler "DIRWORDLOGICLib.Steuerung" konnte nicht erstellt werden
Prüfen, ob das Microsoft Visual C++ 2010 Redistributable Package (x86) (vcredist_x86.exe) installiert ist (siehe: Installationsvoraussetzungen auf dem Windows Client)
Wenn nicht:
- Das Paket nachinstallieren
- Die dirwordlogic.dll nach-registieren, siehe: Fehler "Automatisierungsfehler - Bibliothek nicht registriert"
Fehler "Automatisierungsfehler - Bibliothek nicht registriert" (dirwordlogic.dll noch nicht registriert) (210000010)
Fehler-Anzeige:
Lösung:
Prüfen, ob das Microsoft Visual C++ 2010 Redistributable Package (x86) (vcredist_x86.exe) installiert ist (siehe: Installationsvoraussetzungen auf dem Windows Client).
Wenn sie installiert sind, dann muss die DLL "dirwordlogic.dll" nachregistrieren.
Dazu muss eine administrative CMD-Box geöffnet und der folgende Befehl eingegeben werden:
regsvr32.exe "C:\Program Files (x86)\Toolmaker\Directword\Programm\dirwordlogic.dll"
Danach kann man mit den Testprogrammen prüfen, ob die Installation korrekt ist: Grundlegende Test-Programme.