Inhaltsübersicht

Um die Volltextindizierung und –recherche in directarchiv nutzen zu können, ist es erforderlich, die kostenpflichtige IBM i/OS Option DB2 Text Extender 5722DE1 zu installieren. Dieses Lizenzprogramm schafft die technische Voraussetzung für die Volltextsuche.

Durch den DB2 Text Extender erfolgt eine asynchrone Indexierung auf Archivebene. Das Indexieren kann z.B. nach 20 Dokumenten angestoßen werden. Zu einem Archivdokument gibt es immer auch ein .txt-Dokument.

Eine Reorganisation von temporären Dateien kann z.B. nach 50 Versionen angestoßen werden. Es gibt immer zwei Dokumente: archiviert und ein temporäres Dokument und zwar solange, bis das Dokument indexiert ist.

Eine Volltextsuche erlaubt nach Wörtern, Texten und Phrasen in den Archiven zu suchen.

Der DB2 Text Extender hat Wörterbücher und indexiert den Text. Somit kann geschlüsselt ein sehr schneller Suchvorgang gestartet werden.

In der Konfiguration muss die Sprachart der Indexierung vorgegeben werden. Die Indexerstellung erfolgt durch den DB2 Text Extender.

...

Die Konfiguration für den DB2 Text Extender ist im Menübaum unter directarchiv - Verwaltung – System – Volltextsuche zu sehen.

Hinweis: Der DB2 Text Extender muss nach der Installation mit Klick auf den Button in der Zeile Status des Service gestartet werden.

0296 – Systemeinstellungen Volltextsuche

DB2 Text Extender Installation

Ist der DB2 Text Extender installiert, erschient folgende Anzeige: Es wurde eine Installation gefunden.

Umgebungsvariablen für DB2 Text Extender / IMOCONFIGSRV / IMOCONFIGCL / NLSPATH

Die Pfadangaben sind nur informativ. Sie zeigen an, wo der DB2 Text Extender vom System installiert wurde.

Status des Service

Der DB2 Text Extender kann mit dem Butten gestartet bzw. beendet werden.

...

Folgende Grundregeln werden bei der Volltextsuche angewendet:

Suchstring

Der Suchstring kann folgende Platzhalter enthalten:

?Ignoriert den Buchstaben

*{}Wildcard (davor/dahinter)

Verknüpfungen

Wort1 +Wort2Im Dokument muss Wort1 und Wort2 vorkommen

Wort1 –Wort2Im Dokument muss Wort1 vorkommen, aber nicht Wort2

Wort1 Wort2Im Dokument muss entweder Wort1 oder Wort2 vorkommen

"Wort1 Wort2" Im Dokument müssen Wort1 und Wort2 hintereinander vorkommen.

Ebenfalls ist die Kombination der Verknüpfungen oder Platzhalter möglich:

"Wort1 Wort2" –Wort3 +Toolm* -F?ddy

...

Für den DB2 Text Extender stehen folgende globale Befehle zur Verfügung:

...

Initialisiert den Job zur Verwendung von DB2 Text Extender SQL Befehlen.

Image Removed

0306 - Befehl SETDB2TXT

...

Zeigt den Status des DB2 Text Extender Services an.

Image Removed

0307 - Befehl DSPTXTSTS

Image Removed

0445 - Befehl DSPTXTSTS - Ausführung

...

Beendet den DB2 Text Extender Service

0308 – Befehl ENDDB2TXT

...

Initialisiert den DB2 Text Extender zur ersten Verwendung auf dem System.

...

Startet den DB2 Text Extender Service.

0310 – Befehl STRDB2TXT

...

Für den DB2 Text Extender stehen folgende Befehle für die Indexe je Archiv zur Verfügung:

...

Löscht die Fehler-Logdatei für den Index eines Archivs.

0311 – Befehl CLRFTILOG

Archiv

Name des Archivs für das die Fehler-Logdatei gelöscht werden soll.

Image Removed

0440 - Befehl CLRFTILOG – ohne Konfiguration Volltextsuche

...

Zeigt den Index Status eines Archivs an.

0312 – Befehl DSPFTISTS

Archiv

Name des Archivs für das der Index-Status angezeigt werden soll.

...

Reorganisiert den Index eines Archivs.

Image Removed

0313 – Befehl RGZFTI

Archiv

Name des Archivs für das der Index reorganisiert werden soll.

Löschen temporärer IFS Dateien

Hier wird festgelegt, ob temporäre IFS Dateien nach dem Reorganisationslauf gelöscht werden sollen.

Gültige Werte sind:

*YESTemporäre IFS Dateien werden gelöscht.

*NOTemporäre IFS Dateien werden nicht gelöscht.

...

Führt einen Reset auf den Index durch und ermöglicht somit die Beseitigung von evtl. Fehlern.

0314 – Befehl RSTFTISTS

Archiv

Name des Archivs für das der Index zurückgesetzt werden soll.

...

Started den Index Update für alle Dokumente, die noch nicht indexiert wurden.

Image Removed

0315 – Befehl UPDFTI

Archiv

Name des Archivs für das der Index erstellt werden soll.

Hinweis: Sollte nach Ausführung des Befehls UPDFTI die Anzeige von DSPFTISTS einen Fehler anzeigen, so kann dies mit bekannten Fehlern im IBM Lizenzprogramm zusammenhängen.

Grundsätzliche Probleme:

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.

DB2TXT disablen: mit CALL PGM(DB2TX) PARM('disable server for db2text')

Bei allen „CONTAINS" Befehle mit „For mixed data" muss das „For mixed data" entfernt werden.

DB2TXT enablen: mit CALL PGM(DB2TX) PARM('enable server for db2text')

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.

directarchiv hat Befehle um einen Textindex zu löschen und wiederherzustellen

RMVFTI ARCHIV()

Entfernt den Suchindex von einem Archiv. Um das Archiv wieder für Volltextsuche zu verwenden, muss einmal der Reiter Volltextsuche in den Archiveigenschaften neu konfiguriert werden.

RBLFTI ARCHIV()

Kopiert sämtliche Volltext-TXT-Dateien eines Archives wieder in das TEMP IFS Verzeichnis.

Hinweis: Bitte beachten, dass das Verzeichnis: /Toolmaker/DirectArchiv/Temp/Fulltext vorher von Textdateien bereinigt wurde, in dem für alle Volltextarchive der Befehl RGZFTI aufgerufen wurde. Dieser Befehl löscht alle Temp Textdateien, die nicht mehr benötigt werden. Somit sollte das Verzeichnis anschließend leer sein. Erst dann den Befehl RBLFTI aufrufen. Inhaltsübersicht

IBM-Dokumentation und PTFs

PTFs von IBM

• Grundsätzlich werden die PTFs für OmniFind zusammen mit der Gruppe "DB2 for IBM i" ausgeliefert.
• Die folgende Seite enthält noch weitere individuelle PTFs (pro IBM i - Version), die ggf. nützlich sein könnten: https://www.ibm.com/support/pages/omnifind-text-search-server-ptf-information

Web-Ressourcen

IBM-Seite zum OmniFind Textsuchserver: https://www.ibm.com/docs/de/i/7.3?topic=enablers-omnifind-text-search-server

IBM-Seite mit der Dokumentation, Artikeln und Tipps: https://www.ibm.com/support/pages/omnifind-documentation-articles-useful-tips

Handbücher passend zur OmniFind-Version, die unter GO LICPGM, Aw. 10 gezeigt wird:

• V1R2: https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_71/rzash/rzash.pdf
• V1R3 und V1R4: https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_72/rzash/rzashpdf.pdf?view=kc

Installation

Wenn die IBM Komponente OmniFind installiert ist, ist unter GO LICPGM, Opt. 10 folgendes zu finden:

5733OMF *INSTALLED OmniFind Text Search Server for DB2 for i

Nach Druck auf F11 wird die installierte Version angezeigt:

5733OMF V1R2M0 OmniFind Text Search Server für DB2 für i
oder
5733OMF V1R4M0 OmniFind Text Search Server for DB2 for i

Wird diese IBM Komponente nicht gefunden, ist für das IBM Release V7R1 die OmniFind Version V1R2 und ab IBM Release V7R2 die OmniFind Version V1R4 zu installieren. Auf der Seite IBM i - wichtige Informationen rund um das Betriebssystem finden Sie Hilfe dabei, die Installationsquelle zu finden.

Dazu passend müssen aktuelle IBM PTFs installiert werden.

Prüfung PTF-Installation

GO PTF, Punkt 5, als Produkt (LICPGM) 5733OMF eingeben

Stand: Juni 2019

Für OMF V1R2M0 sehen Sie hier einen Auszug aus der PTF Liste

PTF-ID Status

• • • SI62422 Temporär angelegt
    • SI8941 Permanent angelegt
    • SI8940 Permanent angelegt
    • SI8785 Permanent angelegt
    • SI8310 Permanent angelegt
    • SI7588 Temporär angelegt
    • SI7101 Permanent angelegt
    • ...
    • SI36152 Ersetzt
    • SI36151 Ersetzt
    • SI36055 Temporär angelegt
    • SI36030 Ersetzt
    • SI35990 Ersetzt

Für OMF V1R4M0 sehen Sie hier einen Auszug aus der PTF Liste

PTF-ID Status

• • • SI65425 Temporär angelegt
    • SI65028 Ersetzt
    • SI64978 Temporär angelegt
    • SI64976 Temporär angelegt
    • SI64958 Temporär angelegt
    • SI64921 Temporär angelegt
    • SI64919 Temporär angelegt
    • …
    • SI9157 Temporär angelegt
    • SI9053 Temporär angelegt

Konfiguration

OmniFind (OMF) besteht aus der Software und einem Textserver.

Nach der Installation der IBM OMF Komponente ist standardmäßig ein Server aktiv.

Wenn in directarchiv die Volltextsuche aktiviert wird, verbindet sich directarchiv mit dem Textserver Toolmaker oder, wenn der Alias-Name Toolmaker fehlt, mit dem ersten Server, der gefunden wird.

Weitere Informationen zum Produkt 5733-OMF, OmniFind Text Search Server for DB2 for i finden Sie auch auf den IBM-Webseiten, z.B. hier: https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_74/rzash/rzashkickoff.htm

Die Software befindet sich im IFS der IBM i im Verzeichnis /QOpenSys/QIBM/ProdData/TextSearch/. Es können mehrere Textserver angelegt werden. Für jeden Textserver gibt es ein eigenes Unterverzeichnis mit dessen Namen, z.B. "/QOpenSys/QIBM/ProdData/TextSearch/server1".

Mit SQL-Befehlen

Siehe auch https://www.ibm.com/docs/de/i/7.1?topic=omnifind-start

Mit dem Toolmaker SQL-Komplett-Installationsskript

Die Toolmaker Hotline verfügt über eine SQL-Skript, das alle Konfigurationsschritte durchführt.

Dieses ist die einfachste und sicherste Form. Es werden auch keine anderen IBMi-Infrastruktur-Elemente, wie z.B. opsNAv oder iNav benötigt.

Bitte sprechen Sie die Toolmaker Hotline (08191/968-120 oder hotline@toolmaker.de an, wenn Sie diesen Weg gehen möchten).

OmniFind-Server für die Volltextsuche mit SQL-Befehl starten und stoppen

Diese Befehle müssen in einem SQL-Fenster oder nach STRSQL ausgeführt werden.

• Start:  CALL SYSPROC.SYSTS_START()

• Beenden: CALL SYSPROC.SYSTS_STOP()

Informationen zur Konfiguration der OmniFind Server

Tabelle QSYS2.SYSTEXTSERVERS: Liste der konfigurierten OmniFind-Server

select * from QSYS2.SYSTEXTSERVERS

Folgende Infos werden angezeigt. Beispiel (wg. der besseren Übersicht senkrecht angeordnet)

Server-ID: 50
Server-Name: 127.0.0.1
Server-Adress-Informationen:
Server-Port: 49.200
Server-Pfad: /QOpenSys/QIBM/ProdData/TextSearch/server1/bin/
Server-Typ: 0
Server-Berechtigungs-Token: ThFF5hA=
Server-Master-Schlüssel: ThFF5hA+UVaoYA3e8DV5xA==
Server-Klasse: 0
Server-Status: 0  ← 0 = Server sind aktiv
Alias-Name: Toolmaker

Den OminFind Text Search Server starten

CALL SYSPROC.SYSTS_START(serverid)

(Die serverid findet man in der Tabelle QSYS2.SYSTEXTSERVERS, siehe unten)

Nach erfolgreichem Prozeduraufruf wird der SERVERSTATUS in QSYS2.SYSTEXTSERVERS auf 0 gesetzt

Alias-Namen ändern:

Mit diesem SQL Befehl kann ein bestimmter Textserver auf den Alias-Namen Toolmaker gesetzt werden.

UPDATE QSYS2.SYSTEXTSERVERS SET ALIASNAME = 'Toolmaker' WHERE SERVERID = 50

SERVERID ergibt sich aus der vorherigen Analyse des Dateiinhalts (siehe vorherigen Abschnitt "Prüfung mit SQL")

Weitere Tabellen in Bibliothek QSYS2

• SYSTEXTDEFAULTS
• SYSTEXTINDEXES
• SYSTEXTCOLUMNS
• SYSTEXTSERVERS
• SYSTEXTCONFIGURATION
• SYSTEXTSERVERHISTORY

Mit dem System i Navigator web-basierend

Rufen Sie im Browser den IBM Navigator for i auf: http://<ibmi-adresse>:2001.

Sie finden die Seite unter: IBM i-Verwaltung → Datenbank → Datenbanken → <ibmi-seriennr> → OminFind-Textsuche → Textserver:

Image Added

Image Added

Aktive Jobs im Subsystem QSYSWRK

Wenn der OmniFind-Server gestartet ist, dann findet man 5 Jobs mit dem Namen QJVAEXEC im Subsystem QSYSWRK:

Image Added

Die Funktion kann variieren. "normal" ist

• beim ersten Job: "JVM-com.ibm.es"
• bei den 4 anderen Jobs: "PGM-OutsideInP"

Volltextsuche generell aktivieren

Voraussetzung für die Nutzung der Volltextsuche ist eine gültige Lizenz für die directarchiv Komponente FTX (Full Text Search / Volltextsuche). Lizenzanzeige:

ADDLIBLE DIRARC
DSPLICINFO *FULL

Image Added

Falls keine Lizenz vorhanden ist, wenden Sie sich bitte an den Toolmaker Vertrieb.

Volltextsuche für ein Archiv aktivieren

Damit die Volltextsuche in einem Archiv verwendet werden kann, muss sie (zusätzlich zum generellen Start des Volltextsuchservers) für dieses Archiv aktiviert werden.

Das geschieht mit directarchiv --> Archiv mit Rechtsklick auf Ändern im Reiter Volltextsuche

Image Added

Volltextsuche aktiveren - Wenn aktiv und der Volltextsuch-Server gestartet ist, dann werden die Inhalte dieses Archivs für die Volltextsuche indexiert

Bereits im Archiv gespeicherte Dokumente ohne Textanteil können nicht in die Volltextsuche einbezogen werden. Deshalb muss für jedes PDF-Dokument, das nach der Aktivierung eingeht, ein Textanteil mitgeliefert werden, der es erlaubt, die Suchworte in OmniFind zu speichern. Dies wird z.B. in directspool (alter Name: AutoMail) gesteuert, indem im Bereich Archivierung mit directarchiv die Option Volltextindex mit J eingeschaltet wird. Siehe Menü "Spool" → directarchiv auf der Seite Eine directspool-Definition bearbeiten

Sprachenverwaltung

Die Verwaltung der Sprachen für OmniFind ist in WOPiXX unter Anwendungen --> DIRARC → Rechtsklick Parameter --> Parametergruppe DB2TXTLNG zu finden.

Rechter Mausklick auf DB2TXTLNG → Parameter Details:

Image Added

Alternativ mit SQL: select * from DIRWEB.DWPRMCTL where DCNAM='DB2TXTLNG' order by DCSEQ

Start/Stopp der Volltextsuch-Server

Das Starten und Stoppen der Volltextsuch-Server wird auf der Seite Verwaltung erläutert.

Mit den Textindizes arbeiten

Für jedes Archiv, für das die Volltextsuche aktiviert ist, wird ein Textindex angelegt.

Per SQL: Tabelle QSYS2.SYSTEXTINDEXES

select * from QSYS2.SYSTEXTINDEXES

Mit dem Operations Navigator

Image Added

Suche mit der Omnifind Volltextsuche

Befehle zur Pflege der IBM OmniFind Volltextsuche

Es gibt 4 5250-GreenScreen-Befehle zur Pflege der Volltextsuch-Indizes:

• RBLFTI
• RGZFTI
• UPDFTI
• RMVFTI

Diese sind auf der Seite Befehle und Exit-Programme für 5250-Sitzungen und Client-Programme beschrieben