Toolmaker Produkt-Dokumentation

directarchiv - Fehlersuche und -behebung

Owned by Robert E. Schneider
Last updated: Jun 15, 2023
5 min read

Inhaltsübersicht

Lizenz prüfen


Bibliotheken und Verzeichnisse für directarchiv


Fehlersuche und -behebung auf IBM i

Version feststellen

IBM i-Version

GO LICPGM, Auswahl 10, Taste F11

directarchiv Version

WRKLIB DIRARC - in der Beschreibung steht die Versionsnummer

DSPDTAARA DIRARC/PRDREL

Omnfind Text Search Server (5733OMF)

STRQSH
cd /QOpenSys/QIBM/ProdData/TextSearch/server1/bin
adminTool.sh 'version'

WOPiXX

DSPDTAARA DTAARA(DIRWEB/PRDREL)

Monitor-Jobs im Subsystem DIRARC

Die verschiedenen Monitorjobs laufen im Subsystem DIRARC.

IFS-Monitor

Der Standard-Job für den IFS-Monitor hat den Namen IFSMONDFT. Es ist aber möglich, bei der Konfiguration der IFS-Monitore eigene Namen anzugeben.

  • auf IBM i:

  • in WOPiXX:

Verteiljob DIRARCDST

  • Der Job DIRARCDST dient zum Verteilen gemäss der Konfiguration der Archive: Verteilung.
  • wird mit STRDSTMON / ENDDSTMON gestartet und beendet
    • muss nach IPL oder Beendigung von SBS-DIRARC neu gestartet werden

Befehle zur Konfiguration

Start/Stop -Befehle

Subsystem und Jobs

Logs/Protokolle/Dumps

Protokollierung ein und ausschalten

Protokoll-Dateien

  • IFS-Monitor-Protokolle im IFS in \Toolmaker\DirectArchive\temp
  • Verteiljob in der Datei DIRARC/DADSTLOG



Fehlersuche und -behebung auf dem Windows Client

Version feststellen

Windows

Microsoft Office

directarchiv-Version

Start → Programme → directarchiv→ directarchiv Administrator, Registerkarte "Info"

IBM i ClientAccess bzw. Access Manager

Befehle zur Konfiguration

Start/Stop -Befehle

OmniFind Search Server starten

  • 5250-Befehl: CALL DIRARC/DASTRFTI
  • Über WOPiXX: directarchiv --> Verwaltung --> System im Reiter Volltextsuche

Logs/Protokolle/Dumps

Protokollierung ein und ausschalten

Protokoll-Dateien

Die Logs des OminFind Servers

Die Protokolle des OminFind Servers befinden sich im IFS der IBM i im Verzeichnis

/QOpenSys/QIBM/ProdData/TextSearch/server1/log


Fehlersuche und -behebung mit dem IFS-Monitor

Kommt es beim aktiven IFS Monitoring zu Problemen bei der Archivierung, so werden diese wie in der Definition des IFS Monitors festgelegt, entsprechend protokolliert.

Ablage im Unterverzeichnis /ERROR

Dateien, die nicht archiviert werden können, legt der IFS Monitor standardmäßig in das Verzeichnnis /ERROR unterhalb des Verzeichnisses, das der Montior überwacht.

E-Mail an konfigurierte Adresse

Wenn die E-Mail-Funktion von wopixx konfiguriert ist, dann erfolgt eine E-Mail Benachrichtigung an den Benutzer, der in der IFS Monitor Definition eingetragen ist (E-Mail-Adresse für Fehlermeldungen).

Beispiel:

Eintrag im Joblog des IFS-Monitor Jobs im Subsystem DIRARC


Für jede fehlgeschlagene Archivierung wird im Joblog des IFS-Monitor Jobs angegeben, was schiefgegangen ist:

Fehlersuche und -behebung auf dem Barcode-Mointor (BCD-Monitor)

Version feststellen

Windows

BCD-Monitor-Programm


Fehlersuche und -behebung für das Barcode-Labelprogramm

Version feststellen

Windows

BCD-Labelprogramm


Fehlersuche und -behebung für die Upload-Funktion

Version feststellen

Windows

Microsoft Office


Fehlersuche und -behebung für die Volltextsuche mit IBM Omnifind 5733OMF (ab Version 1.80)

Web-Ressourcen

Siehe: IBM OmniFind einrichten und verwalten - Web-Ressourcen

Wiederherstellung des Volltextindexes

Bitte beachten Sie die Befehle um einen Textindex zu löschen und wiederherzustellen RMVFTI und RBLFTI.

Die OmniFind-Installation verifzieren (adminTool.sh)

  1. STRQSH
  2. cd /QOpenSys/QIBM/ProdData/TextSearch/server1/bin

Version des Servers mit 'version'

adminTool.sh 'version'   ← Gross-/Kleinschreibung beachten!

Status der Server mit 'status'

adminTool.sh 'status'   ← Gross-/Kleinschreibung beachten!



Es werden die Omnifind Index Datenbanken angezeigt mit Anzahl der Dokumente.

Den Index kann man verifizieren mit:

dumpIndex.sh '0_50_5002_2018_08_23_14_35_56_196647' 'topTerms 100'


...usw.

Mit den OmniFind Textservern arbeiten

Siehe dazu: IBM OmniFind - Mit den Textservern arbeiten

Mit den OmniFind Text-Indizes arbeiten

Siehe dazu: IBM OmniFind Mit den Textindizes arbeiten

Das Feld "Status" in der OpsNav-Anzeige (bzw. LASTUPDATESTATUS der Tabelle SYSTEXTINDEXES) gibt den Zustand des Index an:

Zeigt den internen Status für die die Optimierung des Bereinigungsprozesses nach einer ersten oder inkrementellen Aktualisierung des des Textsuchindexes.

Typische Werte umfassen:

  • (Null) bedeutet, dass der Index nie aktualisiert wurde.
  • 'C' zeigt an, dass eine erste Aktualisierung eingeleitet wurde. Wenn der Aktualisierungsmodus nicht inkrementell ist, dann ist die erste Aktualisierung entweder noch im Gange oder nicht abgeschlossen.
  • N' zeigt an, dass eine inkrementelle Aktualisierung erfolgreich abgeschlossen wurde.

Andere Codes werden intern verwendet während der Aktualisierungsverarbeitung verwendet. Der Aktualisierungsprozess verwendet diese Codes, um spezifische Wiederherstellungsmaßnahmen zu bestimmen die ergriffen werden können, wenn die Aktualisierung fehlschlägt.

(siehe: Electronic business and Web serving OmniFind Text Search Server for DB2 for i (RZASHPDF), Version 7.2, Seite 107).

CALL DIRARC/DASTRFTI - Start des Search Servers über ein Batchprogramm

Hinzugefügt in Version 1.80, PTF 10

Wenn der IBM OmniFind Text Search Server nicht aktiv ist, werden bestimmte Funktionen für die Volltextsuche nicht ausgeführt. Durch ein unerwartetes Systemende kann es aber dazu kommen, dass die Konfiguration des Servers nach dem IPL eine Aktivität anzeigt, obwohl das Programm gar nicht läuft.

Dieses Programm DASTRFTI erlaubt es, den IBM OmniFind Text Search Server auch über einen Batchvorgang zu starten.


Fehlersuche und -behebung für die Volltextsuche mit DB2 Text Extender (bis Version 1.70)

Fehler in Script QDB2TX/QADESDDL.DESCUDF

Es gibt eine Reihe von SQL Scripts, die ausgeführt werden, wenn DB2TXT sich am SQL Server registriert. Dies wird mit dem DB2TXT-Befehl „enable server for db2text" oder mit dem Archiv-Befehl INIDB2TXT gemacht.

In einem dieser Scripts sind zwei Fehler. Folgende Schritte könnten das Problem beheben.

Das Member QDB2TX/QADESDDL.DESCUDF muss abgeändert werden.

  1. DB2TXT disablen: mit CALL PGM(DB2TX) PARM('disable server for db2text')
  2. Bei allen „CONTAINS" Befehle mit „For mixed data" muss das „For mixed data" entfernt werden.
  3. DB2TXT enablen: mit CALL PGM(DB2TX) PARM('enable server for db2text')

CCSIDs der Wörterbücher anpassen

Scheinbar müssen die CCSIDs der Wörterbücher und des Jobs auf der IBM i gleich sein. Die CCSID der Wörterbücher im IFS muß auf die CCSID des Jobs geändert werden. Die Wörterbücher sind:

  • /qibm/ProdData/imo/dict/deutsch.abr
  • /qibm/ProdData/imo/dict/deutsch.dic

Hinweis: Je nach verwendeter Sprache gibt es eigene Wörterbücher.

Support-Fälle

Anzeige eines archivierten Dokumentes versagt mit einem timeout (18030184)

Wenn man ein Dokument anzeigen will, muss man über 60 Sekunden (Timeout? Object lock?) warten.

Lösung:

Das IBM i -  Benutzerprofil DIRARC war gesperrt. Nach dem Ent-Sperren läuft es wieder.

Dokument wg. falscher Endung nicht anzeigbar

Bei einer PC-Datei, die über den IFS-Monitor archiviert wurde und deren Name incl. Endung (z.B. .pdf)) zufällig zwischen 61 und 63 Zeichen lang war, wurde der Name nach der Stelle 60 abgeschnitten. Dies führt heute dazu, dass der Browser das Dokument nicht anzeigen kann. Man kann das Dokument aber mit Rechtsklick und Export speichern, die Endung richtigstellen und es dann mit Doppelklick anzeigen.

Lösung:

Gelöst in Version 1.80, PTF 10

Achivierte Dokument sehr gross ("aufgebläht")

Die Analyse der Eigenschaften der PDF mit dem Overlay des Kunden zeigt, dass die Original Grafik in Corel Draw (.cdr) designed und dann von Corel Draw als PDF ausgegeben wurde. Hier liegt die Ursache für das Volumen der PDF Rechnung insgesamt.

Dort muss auch der Lösungsansatz liegen. Prüfen Sie bitte, wie groß die Datei wird, wenn die Grafik im Format JPG ausgegeben wird. Directmail kann auch ein JPG als Overlay in eine PDF-Datei einbinden.

Falls später geplant ist, die Rechnungen im Format PDF/A (Langzeitarchivierung) auszugeben, werden alle erforderlichen Fonts aus der SPLF in jede Rechnungs-PDF eingebunden, was auch das Volumen vergrößert. Das sind dann Kompromisse, die möglicherweise durch Vorschriften von anderer Seite ausgelöst werden.