InhaltsübersichtContent overview
| Table of Contents |
|---|
Lizenz prüfen
...
Bibliotheken und Verzeichnisse für directword
...
...
Troubleshooting on IBM i
...
Determine version
IBM i
...
version
GO LICPGM, Auswahl selection 10, Taste key F11
directword
...
version
WRKLIB DIRWORD - in der Beschreibung steht die Versionsnummerthe description contains the version number
DSPDTAARA DIRWORD/prdrel
WOPiXX
...
Configuration commands
Start/Stop
...
commands
Subsystem
...
and jobs
Logs/
...
Protocols/Dumps
| Anchor |
|---|
...
|
...
|
...
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:
...
Turn logging on and off
For test/debug purposes, the communication taking place between IBM i and PC can be logged to a DIRWORD/RPRT file. At this point, logging is enabled or disabled.
Valid values are:
" " Logging is disabled"LL" Logging is switched on
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 eingebenAfter turning logging off, you should make sure that the log file is cleared again by entering the following IBM i command:
CLRPFM DIRWORD/RPRT
IBM i -
...
log file DIRWORD/RPRT
select SRCDTA from DIRWORD/RPRT
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
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
...
...
Troubleshooting on the Windows client
Determine version
Windows
Microsoft Office
directword
...
version
Start → Programme Programs → directword→ directword Administrator, Registerkarte "Info"About tab.
...
Configuration commands
Start/Stop
...
commands
Logs/
...
Protocols/Dumps
...
Turn logging on and off
Start→ Programme Programs → directword → directword Administrator, Registerkare Serverdaten Server Data tabs
...
Log files:
...
%PROGRAMDATA%\Toolmaker\DirectWord\dirword.out
Auch anzeigbar über Start→ Programme Also displayable via Start→ Programs → directword → directword Logdatei anzeigenShow log file
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
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 |
...
Log files:
...
%USERPROFILE%\AppData\Roaming\Toolmaker\DirectMedia\directrun.out
Hier wird geloggt, was während der Makroausführung passiertHere we log what happens during the macro execution
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
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\AnwendungsdatenIf you get an error message when executing a directword command, you should briefly read through the following list. Find the chapter heading that best fits your error message or problem and read the tips and references to fix the error.
General errors
If a directword command (e.g. DWMRGDOC) was started, nothing happens at all (no error message, neither in the session nor on the client).
Check if the directword TCP server is started and the port number matches the one stored on the IBM i.
If a directword command (e.g. DWMRGDOC) was started, a document is opened, but no data is merged.
Check if the AddIn directword.dot was loaded in Word.
Make sure that the installation is licensed on the IBM i server.
Check whether the data transfer via the TCP server was error-free. Check the file under C:\Documents and Settings\AllUsers\Application Data\Toolmaker\directword\directword.out.
0459 – - directword.out
Bei For VISTA bzw. or 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 Make sure that the correct data file was passed when calling the DW function. For this purpose you can also view the file PKO...tmp (genauer Name und Pfad siehe Eintragungen in der for exact name and path see entries in the directword.out -Datei) zum Vergleich mit einem Texteditor einsehenfile) for comparison with a text editor.
WINDOWS7
Die Firewall muß so durch den Administrator The firewall must be configured by the administrator DWServ.exe
Visual Basic
...
errors
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 lautenerrors can be recognized by the dialog type and the associated error message. These errors are always caused by the functions executed in Microsoft Word (started from directword ).
Always abort the function with Exit and check the respective settings as described below. Always quit and start Word before the next attempt.
Runtime error 537: The specified macro cannot be executed.
Check the list of all automatically started style sheets in Word via the menu function Tools - Templates and Add-Ins. The directword.dot file must be entered in the list.
Runtime error 53: File POVBAEXT.DLL cannot be found.
This error normally only occurs in the server variant. In this case, the directword Visual Basic extension cannot be found. Check the following settings:
Start the system settings via the button Start- Settings - Control Panel - System
Activate the tab page Advanced - Environment variables and click in the selection list System variables on the variable Path.
Complete the value of the variable by extending the existing text with a semicolon and the installation path of directword. It is mandatory to boot the PC after changing the value. For example, if the remote Windows NT server (PC) is to be accessed through TRN18, the value at the end should be as follows:
C:\......;\\TRN18\directword\Programmprogram
...
| Anchor | |||
|---|---|---|---|
|
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:
...
|
Basic test programs
There are a number of test programs available in the DIRWORD library that can be used to check the basic operation of directword.
These programs are all called BEISP*. Their sources can be found in the source file DIRWORD/QCLPSRC.
Ensure that the "Advanced Protocol" is enabled
Start the directword administrator(Start → Programs → directword → directword Administrator) and make sure that the Extended Protocol is active in the "Server Data" tab:
Shuffle Word document locally and then edit it: BEISP0200
ADDLIBLE DIRWORDCLRPFM RPRTCALL BEISP0200- Das Dokument sollte jetzt auf dem PC erscheinen und gemischt werden, danach zum Editieren offen bleibenThe document should now appear on the PC and be merged, then remain open for editing
DSPPFM RPRT
Word-Dokument auf einem Server mischen und drucken: BEISP02110
...
Shuffle and print Word document on server: BEISP02110
Make sure that the name "DWBATCH" is connected to the server PC
- ADDLIBLE DIRWORD
- GO DIRWORD, Auswahl selection 4
- Sicherstellen, dassdie Warteschlange Make sure that
- the queue "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
...
- is linked to the correct IP address/name of the server PC
- the program DWServe.exe is running on the server PC and is configured to the specified port
- on the server PC the service "DirWordService" is not active is
Port 50004 is configured on PC, as on IBM i:
Auf dem Server-PC läuft DWServ.exe is running on the server PC:
Der Service The service "DirWordService" ist nicht aktivis not active:
...
Call the test program BEISP0210
ADDLIBLE DIRWORDCLRPFM RPRTCALL BEISP0210DSPPFM RPRT
...
Hotline
...
cases
DWMRGDOC (etc.) -
...
call does not arrive at the PC or server (2000040)
- There is no indication of any activity by the DWMRGDOC (or other DW commands) in the log of the PC or server.
- In the file DIRWORD/RPRT (siehe: Protokoll-Datei DIRWORD/RPRT - Protokollierung ein- und ausschalten) findet man die Zeileyou will find the line:
000000000000ERROR 0000000000ERROR : getservbyname .
LösungSolution:
Es fehlte der Servicetabelleneintrag für den Port 50004:
Prüfen mit WRKSRVTBLE und blättern, bis man ihn findetThe service table entry for port 50004 was missing:
Check with WRKSRVTBLE and scroll until you find it:
Wenn nicht vorhanden, hinzufügenIf not present, add:
ADDSRVTBLE SERVICE(DWRDSRV) PORT(50004) PROTOCOL(TCP) TEXT('directword')
...
Error "DIRWORDLOGICLib.
...
control" could not be created
Check if the Microsoft Visual C++ 2010 Redistributable Package (x86)(vcredist_x86.exe) installiert ist (siehe: is installed (see Installationsvoraussetzungen auf dem Windows Client)
Wenn nichtIf not:
- Das Paket nachinstallieren
- Die Reinstall the package
- Re-register the dirwordlogic.dll nach-registieren, siehe: see Fehler "Automatisierungsfehler - Bibliothek nicht registriert"
| Anchor | ||||
|---|---|---|---|---|
|
...
Error "
...
Automation error - library not registered" (dirwordlogic.dll
...
not yet registered) (210000010)
Fehler-AnzeigeError display:
LösungSolution:
Prüfen, ob das Check if the Microsoft Visual C++ 2010 Redistributable Package (x86)(vcredist_x86.exe) installiert ist (siehe: is installed (see Installationsvoraussetzungen auf dem Windows Client).
Wenn sie installiert sind, dann muss die If they are installed, then the DLL "dirwordlogic.dll" nachregistrieren.Dazu muss eine administrative CMD-Box geöffnet und der folgende Befehl eingegeben werdenmust be re-registered.
To do this, open an administrative CMD box and enter the following command:
regsvr32.exe "C:\Program Files (x86)\Toolmaker\Directword\ProgrammProgram\dirwordlogic.dll".
Danach kann man mit den Testprogrammen prüfen, ob die Installation korrekt ist: After that you can use the test programs to check if the installation is correct Grundlegende Test-Programme.
...