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

Inhalt der DIRWORD/RPRT bei ordnungsgemässem Ablauf

Makro Name: DWMRGDOC                                                                                                                                                                                                                                          
Job Name: P13ARCAD1                                                                                                                                                                                                                                           
IP Adresse des Fernen Systems: 192.168.42.152                                                                                                                                                                                                                 
Systemname : DEAET01 L                                                                                                                                                                                                                                        
Initiator Port: -09806                                                                                                                                                                                                                                        
Editor Name: WORD                                                                                                                                                                                                                                             
Timeout der Operation: 0000                                                                                                                                                                                                                                   
Oeffnen der TCP Verbindung                                                                                                                                                                                                                                    
Portnummer: 50004                                                                                                                                                                                                                                             
Port for client communication is:55825                                                                                                                                                                                                                        
Zugriff zu PC erstellt                                                                                                                                                                                                                                        
Daten erfolgreich gesendet                                                                                                                                                                                                                                    
Oeffnen der Datei DWSTEU : DIRWORD/DWSTEU(SP13ARCAD1)                                                                                                                                                                                                         
DWSTEU erfolgreich gesendet                                                                                                                                                                                                                                   
Oeffnen der DWBKFW Datei : DIRWORD/DWBKFW(SP13ARCAD1)                                                                                                                                                                                                         
DWBKFW erfolgreich gesendet                                                                                                                                                                                                                                   
Receiving Response: 258 bytes                                                                                                                                                                                                                                 
Received  258 bytes                                                                                                                                                                                                                                           
Feedback Status: 1; Im Klartext:Makro erfolgreich ausgeführt<zeile mit X'20' aufgefüllt>
Kommunikation mit PC erfolgreich abgeschlossen                                                                                                                                                                                                                
Status:Makro erfolgreich ausgeführt<zeile mit X'20' aufgefüllt>

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

dirword.out - bei ordnungsgemässem Ablauf

26.01.2020 11:15:46 Local Port is: 3615
26.01.2020 11:15:46 Receiving timeout value for sync communication
26.01.2020 11:15:46 GetProcIDDirect for port: 3611
26.01.2020 11:15:46 Process not found by proc id direct. Try by Proc ID
26.01.2020 11:15:46 GetProcID Begin 
26.01.2020 11:15:46 strCommandLine
26.01.2020 11:15:46 GetProcID End true
26.01.2020 11:15:46 Session is : 2
26.01.2020 11:15:46 Opening event: Global\ToolmaEv2
26.01.2020 11:15:46 Status entry for synchron process:1
26.01.2020 11:15:46 RunCacls
26.01.2020 11:15:46 open cacls "C:\ProgramData\Toolmaker\DirectWord\DirwordStatus.bin" /E /G TMS\Cornel:f
26.01.2020 11:15:46 LaunchMakro
26.01.2020 11:15:46 Session is : 2
26.01.2020 11:15:46 open cacls "C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKO46CB.tmp" /E /G TMS\Cornel:f
26.01.2020 11:15:46 open cacls "C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKO46DC.tmp" /E /G TMS\Cornel:f
26.01.2020 11:15:46 Opening event: Global\ToolmaEv2
26.01.2020 11:15:50 Wait for feedback from macro/watchdog
26.01.2020 11:15:56 Send response to caller
26.01.2020 11:15:56 Wait for status of response
26.01.2020 11:15:56 Response is:716269695
26.01.2020 11:15:56 Synchron Process lasted for: 0 seconds

Protokoll-Dateien: %USERPROFILE%\AppData\Roaming\Toolmaker\DirectMedia\directrun.out

Hier wird geloggt, was während der Makroausführung passiert

directrun.out bei ordnungsgemässem Ablauf

2020.01.26 11:08:12 DirectRun started
2020.01.26 11:08:12 Version is: 3.30.38.39
2020.01.26 11:08:12 Event Global\DirectRunRuns2 created
2020.01.26 11:08:12 Cleaning DirectMedia Temp Directory
2020.01.26 11:08:12 Waiting for events.
2020.01.26 11:15:46 Event number: 0
2020.01.26 11:15:46 Session 2, Event occured
2020.01.26 11:15:46 ProcessType: 4
2020.01.26 11:15:46 Waiting for events.
2020.01.26 11:15:46 Event number: 0
2020.01.26 11:15:46 Session 2, Event occured
2020.01.26 11:15:46 ProcessType: 1
2020.01.26 11:15:46 PKOSTEU File: C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKO46CB.tmp
2020.01.26 11:15:46 PKOBKFW File: C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKO46DC.tmp
2020.01.26 11:15:46 Launching Word Editor
2020.01.26 11:15:49 AddIns.Count: 1
2020.01.26 11:15:49 DIRECTWORD.DOT
2020.01.26 11:15:56 Waiting for events.
2020.01.26 11:24:06 Event number: 0
2020.01.26 11:24:06 Session 2, Event occured
2020.01.26 11:24:06 ProcessType: 4
2020.01.26 11:24:06 Waiting for events.
2020.01.26 11:24:06 Event number: 0
2020.01.26 11:24:06 Session 2, Event occured
2020.01.26 11:24:06 ProcessType: 1
2020.01.26 11:24:06 PKOSTEU File: C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKOE57A.tmp
2020.01.26 11:24:06 PKOBKFW File: C:\Program Files (x86)\Toolmaker\Directword\Programm\Temp\PKOE58B.tmp
2020.01.26 11:24:06 Launching Word Editor
2020.01.26 11:24:06 AddIns.Count: 1       <==== hier startet das Makro. Wenn es Probleme geben sollte, dann kommt hiernach eine Fehlermeldung
2020.01.26 11:24:06 DIRECTWORD.DOT
2020.01.26 11:24:12 Waiting for events.

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
1. 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
1. die Warteschlange "DWBATCH" mit der korrektein IP-Adresse/Name des Server-PCs verknüpft ist
2. auf dem Server-PC das Programm DWServe.exe läuft und auf den angegebenen Port konfiguriert ist
3. 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.

Browser not supported