--- version: "latest" language: "de" --- # FAQ **Willkommen!** Dies ist die Startseite des Knowledge Base-Bereichs von i-effect. Hier finden Sie eine Zusammenstellung von wichtigen Artikeln zu den Themengruppen **Anleitungen** und **Fehlerbehebungsartikel**. Verwenden Sie die Navigation auf der linken Seite um bestimmte Artikel aufzurufen, oder die folgende Volltextsuche um nach Stichwörtern oder Textbestandteilen in den Artikeln zu suchen. *** ** * ** *** ## Häufig gestellte Fragen * [i-effect sichern](https://manual.i-effect.com/de/faq/latest/i-effect-sichern.md) * [i-effect wiederherstellen](https://manual.i-effect.com/de/faq/latest/i-effect-wiederherstellen.md) ### Benötigen Sie weitere Hilfe? * [menten Helpdesk](https://helpdesk.menten.com/) * [i-effect Handbuch](https://manual.i-effect.com/) * [menten GmbH Kontaktdaten](https://www.menten.com/de/kontakt) ### Andere Ressourcen * [IBM Support](https://www.ibm.com/mysupport/s/?language=de) * [i-effect](https://www.i-effect.com/) * [menten GmbH](https://www.menten.com/) *** ** * ** *** ## Nach Thema durchsuchen 1. A-E * [browser]( /wiki/label/FAQmanual/browser ) * [config]( /wiki/label/FAQmanual/config ) * [connect]( /wiki/label/FAQmanual/connect ) * [console]( /wiki/label/FAQmanual/console ) * [cvtdbxls]( /wiki/label/FAQmanual/cvtdbxls ) * [db]( /wiki/label/FAQmanual/db ) * [db2]( /wiki/label/FAQmanual/db2 ) * [dns]( /wiki/label/FAQmanual/dns ) * [excel]( /wiki/label/FAQmanual/excel ) * [exitpoints]( /wiki/label/FAQmanual/exitpoints ) 2. F-K * [firefox]( /wiki/label/FAQmanual/firefox ) * [headless]( /wiki/label/FAQmanual/headless ) * [hy000]( /wiki/label/FAQmanual/hy000 ) * [ifs]( /wiki/label/FAQmanual/ifs ) * [install]( /wiki/label/FAQmanual/install ) * [installation]( /wiki/label/FAQmanual/installation ) * [ipv6]( /wiki/label/FAQmanual/ipv6 ) * [java]( /wiki/label/FAQmanual/java ) * [keys]( /wiki/label/FAQmanual/keys ) * [keystore]( /wiki/label/FAQmanual/keystore ) 3. L-P * [library]( /wiki/label/FAQmanual/library ) * [license]( /wiki/label/FAQmanual/license ) * [mapgui]( /wiki/label/FAQmanual/mapgui ) * [mapper]( /wiki/label/FAQmanual/mapper ) * [move]( /wiki/label/FAQmanual/move ) * [needs-translating]( /wiki/label/FAQmanual/needs-translating ) * [network]( /wiki/label/FAQmanual/network ) * [portecle]( /wiki/label/FAQmanual/portecle ) * [portnummer]( /wiki/label/FAQmanual/portnummer ) 4. Q-S * [qibm_qca_chg_command]( /wiki/labels/viewlabel.action?ids=1944388091&key=FAQmanual ) * [qibm_qca_rtv_command]( /wiki/labels/viewlabel.action?ids=1944388092&key=FAQmanual ) * [rename]( /wiki/label/FAQmanual/rename ) * [restore]( /wiki/label/FAQmanual/restore ) * [rpmdb]( /wiki/label/FAQmanual/rpmdb ) * [save]( /wiki/label/FAQmanual/save ) * [socket]( /wiki/label/FAQmanual/socket ) * [sqldriverconnect]( /wiki/label/FAQmanual/sqldriverconnect ) * [subsystem]( /wiki/label/FAQmanual/subsystem ) 5. T-Z * [tcp/ip]( /wiki/labels/viewlabel.action?ids=1944388089&key=FAQmanual ) * [translated]( /wiki/label/FAQmanual/translated ) * [version]( /wiki/label/FAQmanual/version ) * [webcontrol]( /wiki/label/FAQmanual/webcontrol ) * [xml]( /wiki/label/FAQmanual/xml ) * [xsd]( /wiki/label/FAQmanual/xsd ) * [yum]( /wiki/label/FAQmanual/yum ) ## Kürzlich aktualisierte Artikel * [Fehler beim Importieren von Zertifikaten](https://manual.i-effect.com/de/faq/latest/fehler-beim-importieren-von-zertifikaten.md) * Feb. 12, 2026 bereitgestellt * [Error importing certificates](https://manual.i-effect.com/en/faq/latest/error-importing-certificates.md) * Feb. 12, 2026 bereitgestellt * [FAQ](https://manual.i-effect.com/de/faq/latest.md) * Jan. 14, 2026 bereitgestellt * [Subsysteme starten nicht: Error while initializing system connection for i-effect.](https://manual.i-effect.com/de/faq/latest/subsysteme-starten-nicht-error-while-initializing-.md) * Jan. 14, 2026 bereitgestellt * [FAQ](https://manual.i-effect.com/en/faq/latest.md) * Jan. 14, 2026 bereitgestellt * [Installation without GUI](https://manual.i-effect.com/en/faq/latest/installation-without-gui.md) * Jan. 09, 2026 bereitgestellt * [Installation ohne GUI](https://manual.i-effect.com/de/faq/latest/installation-ohne-gui.md) * Jan. 09, 2026 bereitgestellt * [i-effect auf ein anderes System übertragen](https://manual.i-effect.com/de/faq/latest/i-effect-auf-ein-anderes-system-ubertragen.md) * Jan. 09, 2026 bereitgestellt * [Transfer i-effect to another system](https://manual.i-effect.com/en/faq/latest/transfer-i-effect-to-another-system.md) * Jan. 09, 2026 bereitgestellt * [YUM Fehler beheben](https://manual.i-effect.com/de/faq/latest/yum-fehler-beheben.md) * Nov. 21, 2025 bereitgestellt * [How do I change the port of the Tomcat server/service API?](https://manual.i-effect.com/en/faq/latest/how-do-i-change-the-port-of-the-tomcat-server-serv.md) * Mai 12, 2025 bereitgestellt * [Wie ändere ich den Port des Tomcat-Servers/Service-API?](https://manual.i-effect.com/de/faq/latest/wie-andere-ich-den-port-des-tomcat-servers-service.md) * Mai 12, 2025 bereitgestellt * [Restore i-effect](https://manual.i-effect.com/en/faq/latest/restore-i-effect.md) * Feb. 05, 2024 bereitgestellt * [i-effect wiederherstellen](https://manual.i-effect.com/de/faq/latest/i-effect-wiederherstellen.md) * Feb. 05, 2024 bereitgestellt * [Wie kann ich die Namen der von i-effect verwendeten Bibliotheken ändern?](https://manual.i-effect.com/de/faq/latest/i-effect-auf-ein-anderes-system-ubertragen/wie-kann-ich-die-namen-der-von-i-effect-verwendete.md) * Jan. 20, 2024 bereitgestellt --- version: "latest" language: "de" --- # Anleitungsartikel *** ** * ** *** ## How-to article Provide step-by-step guidance for completing a task. Add how-to article --- version: "latest" language: "de" --- # Firefox Portfreigabe In neueren Firefox Versionen werden einige Portnummern als unsicher eingestuft und gesperrt. Darunter fallen auch die vom ZendServer verwendeten Portnummern wie 10080 oder 10088. Um im Firefox eine Ausnahme Regel für diese Portnummern einzurichten, gehen Sie bitte wie folgt vor: * In der Firefox-Navigationsleiste die URL **about:config** eingeben und den Zugriff bestätigen. * Einen neuen Eintrag vom Typ String erstellen, der den Namen **network.security.ports.banned.override** trägt. * Die gewünschte Portnummer oder eine per Komma getrennte Port-Liste eingeben. Z.B. die ZendServer Portnummer aus der Adressleiste: 10080. Danach sollte die Seite im Firefox wieder funktionieren. --- version: "latest" language: "de" --- # WebControl Lizenzen Im GreenScreen kann man mit dem Befehl WRKLICINF die Lizenzinformationen für das WebControl Modul einsehen. Mit den Optionen 5 und 8 sieht man, wieviele und welche Benutzer gerade eine Lizenz verwenden. Pro Login in WebControl wird eine Lizenz gesperrt und auch erst wieder freigegeben, wenn sich dieser Benutzer in WebControl abmeldet. Allerdings gibt es eine Funktione, welche einem Benutzer über die Session Cookies erlaubt, den Browswer ohne abmelden zu schließen, und beim nächsten öffnen von WebControl im gleichen Browser ohne neue Lizenzabfrage weiterzuarbeiten. Es muss aber wirklich der gleiche Browser/Rechner ohne gelöschten Cache sein und das WebControl Subsystem (WEBCTRL) darf zwischenzeitlich nicht beendet werden. Um für inaktive Benutzer unter V2R8M0 oder V2R9M0 die Lizenz freizugeben, kann man diesen Aufruf verwenden: select IEFFECTDB.ReleaseProductLicense('2MEBEFF','V2R9M0','5003','') from SYSIBM.SYSDUMMY1 --- version: "latest" language: "de" --- # com.menten.ieffect.mapper.db.engine.write.DataTargetException, SQL state \[38501\]; error code \[-443\] ## Problem In einem Mapping, in dem Datensätze in eine DB2-Tabelle geschrieben werden, kann es zum oben beschriebenen SQL Fehler kommen, sofern an der Tabelle ein Triggerprogram hängt, welches nicht gefunden werden kann. ## Ursache Die Ursache liegt in der Verwendung des "nativen" DB2 Treibers ohne Angabe einer Bibliotheksliste in der URL. ## Lösung In der Datei /i-effect/V2r9m0/mapper/db/preferences.xml" kann folgende Änderung vorgenommen werden: VORHER: \jdbc:[as400://mapmam;driver=native;naming=sql;date](https://manual.i-effect.com/de/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) format=iso;translate binary=true\ NACHHER: \jdbc:[as400://mapmam;naming=sql;date](https://manual.i-effect.com/de/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) format=iso;translate binary=true\ ## Verwandte Artikel ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Der Keystore wird nicht mehr vollständig in Portecle angezeigt ## Problem Der Inhalt des i-effect Keystores wird nicht mehr vollständig in Portecle (i-effectKeyManager) angezeigt. Die Anzeige enthält nur noch die Einträge der Schlüsselpaare, die Zertifikate fehlen vollständig. ## Lösung Bitte führen Sie folgende Schritte mit Administratorrechten auf Ihrem Windows System durch: 1. Öffnen Sie mit einem Editor die Datei "*C:\\Program Files\\Java\\\\\lib\\security\\java.security*" (Den Pfadnamen passen Sie bitte entsprechend Ihrer Java Installation und Windows Version (32/64 Bit) an) 2. Suchen Sie nun in der Datei nach der Zeile **"** ***keystore.type.compat=true*** **"** 3. Ersetzen Sie den Wert durch **"** ***false*** **"** zu und speichernSie anschließend die Änderung ab. Nach dem nächsten Start von Portecle werden dann wieder alle Einträge angezeigt. ## Ursache Ab Java 8 Update 60 (8u60) hat Oracle eine neue Keystore-Kompatibilitätsmodus Einstellung eingeführt, welche standardmäßig aktiv ist. Information von [Oracle-Seite](https://www.java.com/de/download/faq/release_changes.xml) hierzu: *"Unterstützung der Erkennung des Keystore-Typs bei JKS- und PKCS12-Keystores. Keystore-Kompatibilitätsmodus: Aus Kompatibilitätsgründen unterstützt der Java Keystore-Typ JKS jetzt standardmäßig den Keystore-Kompatibilitätsmodus. In diesem Modus können JKS-Keystores sowohl auf JKS- als auch auf PKCS12-Dateiformate zugreifen. Um den Keystore-Kompatibilitätsmodus zu deaktivieren, legen Sie die Sicherheitseigenschaft keystore.type.compat auf den Zeichenfolgenwert false fest."* ### Verwandte Artikel #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Error while executing query. \ in Bibliothek für Operation ungültig. ## Problem Dieser Fehler kann bei Mappings auftreten, die mit Tabellen/Datenbanken arbeiten die noch nicht im Journal aufgezeichnet sind. ## Lösung Die Dateien zum Journal hinzufügen mit: STRJRNPF FILE(BIBLIOTHEK/FILE) JRN(IEFFECTDB/EDIJRN) IMAGES(*BOTH) ## Verwandte Artikel ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Error while reading next node, Error while fetching next row from resultset ## Problem Der Fehler *com.menten.ieffect.mapper.db.DBModuleException: Error while reading next node* oder *Error while fetching next row from resultset*erscheint, wenn Änderungen an Ihrer Datenbank vorgenommen worden sind, die der IBM i bzw. i-effect aufgrund eines SQL-Packages noch nicht bekannt sind. ## Lösung Geben Sie den folgenden Befehl an, um alle SQL Pakete von i-effect zu finden. wrkobj *ALL/IEFF* *SQLPKG Löschen Sie die angezeigten SQL Pakete mit Auswahl 4 Beenden und Starten Sie anschließend das i-effect \*EDI Subsystem. endeffsbs *edi streffsbs *edi ### Verwandte Artikel #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Exitpoints neu erstellen i-effect verwendet die Exitpunkte QIBM_QCA_CHG_COMMAND und QIBM_QCA_RTV_COMMAND. Sollte es erforderlich sein, diese i-effect Exitpoints neu zu erstellen, kann folgender Aufruf verwendet werden. Im Aufruf ist vXrYmZ mit der installierten Version zu ersetzen, z.B. V3R1M0 ## **Exitpoints erstellen** Den folgenden Befehl in einer QSHell (STRQSH) oder SSH Sitzung eingeben: /home/ieffect/current/base/tools/scripts/setup.sh --mode recreateexitpoints --version vXrYmZ ## **Meldungen** Auf der Konsole werden die folgenden Meldungen ausgegeben qsecofr@MAPRM:~# /home/ieffect/current/base/tools/scripts/setup.sh --mode recreateexitpoints --version v3r1m0 *** (setup.sh) Started at: Wed Sep 16 09:01:36 CEST 2026 Remove old command exit point entries... Configure objects.. Adjusting commands... *** i-effect Mode:RECREATEEXITPOINTS operation completed. SETUP finished successfully *** (setup.sh) Ended at: Wed Sep 16 09:04:08 CEST 2026 <2 minutes and 34 seconds> qsecofr@MAPRM:~# --- version: "latest" language: "de" --- # Fehler beim Importieren von Zertifikaten Beim Importieren von Zertifikatsketten kann es zu einer HTTP 400 Fehlermeldung der API (Service Subsystem kommen. Ursache ist eine zu große Datenmenge im HTTP Header der Anfgrage. Als Lösung kann die der Wert "maxHttpHeaderSize" im Tomcat angepasst werden. Folgende Datei öffnen: \IEFFECT\V3R1M0\base\tomcat\conf\server.xml Diese Zeile im Block "Connector" hinzufügen: maxHttpHeaderSize="65536" Der Block sollte dann so aussehen: Danach das \*SERVICE Subsystem neustarten. --- version: "latest" language: "de" --- # Fehlerbehebungsartikel *** ** * ** *** ## Troubleshooting article Provide solutions for commonly encountered problems. Add troubleshooting article --- version: "latest" language: "de" --- # i-effect auf ein anderes System übertragen Mit folgenden Scriptaufrufen kann i-effect gesichert und der gesicherte Stand auf einer anderen Partition oder einem anderen System wiederhergestellt werden ## Sichern auf dem Quellsystem Die installierte Version von i-effect mit diesem Aufruf sichern. Parameter --library gibt den Namen der zu verwendenden Sicherungsbibliothek an. Hier MYSAVLIB Parameter -v gibt die Versionsnummer an. Hier V2R9M0 Parameter --target_release benennt das Zielrelease für die Sicherung. Hier V7R4M0 ### **Sichern** /i-effect/V3R1M0/base/tools/scripts/save2mebeff.sh --library MYSAVLIB -v v2r9m0 --target_release v7r4m0 ## Übertragen auf das Zielsystem Die erstellte Sicherungsbibliothek muss nun in eine Sicherungsdatei gesichert und auf das Zielsystem, zum Beispiel mit FTP, übertragen werden ### **Sicherungsbibliothek übertragen** CRTSAVF QGPL/MYSAVLIB SAVLIB LIB(MYSAVLIB) DEV(*SAVF) SAVF(QGPL/MYSAVLIB) TGTRLS(V7R2M0) Die erstellte Sicherungsdatei QGPL/MYSAVLIB auf das Zielsystem übertragen Das Verzeichnis /i-effect/V3R1M0/base/tools/scripts in das Verzeichnis /tmp auf dem Zielsystem übertragen ## Zurückspeichern Auf dem Zielsystem die gesicherte Bibliothek zurück speichern und i-effect wiederherstellen ### **i-effect zurückspeichern** RSTLIB SAVLIB(MYSAVLIB) DEV(*SAVF) SAVF(QGPL/MYSAVLIB) /tmp/2mebeff/software/i-effect/V3R1M0/base/TOOLS/scripts/restore2mebeff.sh -t *last --library MYSAVLIB --- version: "latest" language: "de" --- # Wie kann ich die Namen der von i-effect verwendeten Bibliotheken ändern? Wenn die Namen der i-effect Speicherorte nach der Installation verändert werden sollen, dann können folgenden Scriptaufruf dazu verwendet werden Die Reihenfolge der Aufrufe ist entscheidend! ## Name der Systembibliothek ändern Der folgende Scriptaufruf ändert den Namen der Systembibliothek in IEFFECTS29 /i-effect/v2r9m0/base/tools/script/setup.sh --version v2r9m0 --mode move --source *sysbaslib --targetname ieffects29 ## Name der Anwendungsbibliothek ändern Der folgende Scriptaufruf ändert den Namen der Anwendungsbibliothek in IEFFECT29 /i-effect/v2r9m0/base/tools/script/setup.sh --version v2r9m0 --mode move --source *appschema --targetname ieffect29 ## Name der Datenbankbibliothek ändern Der folgende Scriptaufruf ändert den Namen der Datenbankbibliothek in IEFFECTDB9 /i-effect/v2r9m0/base/tools/script/setup.sh --version v2r9m0 --mode move --source *dbschema --targetname ieffectdb9 --- version: "latest" language: "de" --- # i-effect sichern Soll i-effect^®^ vollständig gesichert werden, enthält diese Anleitung die dafür notwendigen Verarbeitungsschritte. Da die automatisierte Installation von i-effect ebenfalls eine automatische Sicherung anfertigt, ist das hier beschriebene Vorgehen nur anzuwenden, wenn eine weitere Sicherung gezielt angefertigt werden soll. i-effect^®^ muss vor dem Start der Sicherung beendet werden ([i-effect beenden](https://manual.i-effect.com/de/installation/vor-der-installation/upgrade-und-update/i-effect-beenden)). ## Sichern des aktuellen Stands Mit Hilfe des folgendes Sciptaufrufs, kann die aktuelle Installation mit allen Bestandteilen gesichert werden. Dazu zählen sämtliche vom Produkt verwendeten Objekte wie Bibliotheken und IFS Verzeichnisse, als auch Umgebungsvariablen und Einstellungen. Die Sicherungen werden mit einer laufenden Nummer gekennzeichnet. Diese Sicherung erhält die nächste verfügbare Nummer zugeteilt. In der Bibliothek IEFFSAVE können die angefertigten Sicherungen eingesehen werden. Anhand der Objektbeschreibung kann der Versionsstand und das Datum der Sicherung abgelesen werden. | Objekt | Art | Attribut | Text | Erläuterung | |--------|--------|----------|--------------------------------------|----------------------------------------------------------------------------------| | APP0 | \*FILE | SAVF | APP 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung des Applikationsschemas aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | APP1 | \*FILE | SAVF | APP 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung des Applikationsschemas aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | DB0 | \*FILE | SAVF | DB 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung des Datenbankschemas aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | DB1 | \*FILE | SAVF | DB 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung des Datenbankschemas aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | ENV0 | \*FILE | PF-DTA | ENV 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung der Umgebungsvariablen aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | ENV1 | \*FILE | PF_DTA | ENV 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung der Umgebungsvariablen aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | IFS0 | \*FILE | SAVF | IFS 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung der IFS Verzeichnisse aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | IFS1 | \*FILE | SAVF | IFS 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung der IFS Verzeichnisse aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | LNG0 | \*FILE | SAVF | LNG 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung der Sekundärsprache aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | LNG1 | \*FILE | SAVF | LNG 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung der Sekundärsprache aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | LNGS0 | \*FILE | SAVF | LNGS 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung der Sekundärsprache (SYSBAS) aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | LNGS1 | \*FILE | SAVF | LNGS 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung der Sekundärsprache (SYSBAS) aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | SYS0 | \*FILE | SAVF | SYS 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung des SYSBAS Schema aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | SYS1 | \*FILE | SAVF | SYS 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung des SYSBAS Schema aus Version 2.9.0 vom 22.3.2021, 17:12:55 | | VER0 | \*FILE | PF-DTA | VER 2.9.0-RC100 2021-03-22 16:48:01 | Sicherung des Versionsstands aus Version 2.9.0 vom 22.3.2021, 16:48:01 | | VER1 | \*FILE | PF-DTA | VER 2.9.0-RC109 2021-03-22 17:12:55 | Sicherung des Versionsstands aus Version 2.9.0 vom 22.3.2021, 17:12:55 | ### **Sicherung starten** Nach Eingabe des folgenden Befehls in einer QSH Sitzung wird der aktuelle Stand gesichert /i-effect/v2r9m0/base/tools/scripts/save2mebeff.sh -v v2r9m0 #### Protokoll Auf der Konsole erscheinen folgende Meldungen im Laufe einer Sicherung: [17:34:47] *** Gestartet um: Mo Mär 22 17:34:47 2021 [17:34:47] Prüfe Zugriffsrechte... [17:34:52] Prüfe Sperren... [17:35:26] Starte Sicherung... [17:35:26] Sicherung mit eindeutiger Identifizierung: 13 [17:36:14] *** Endet um : Mo Mär 22 17:36:14 2021set [17:36:14] *** Dauer : 1 Minuten und 30 Sekunden verstrichen. [17:36:14] Sichern erfolgreich beendet #### Protokolldatei In der Protokolldatei **/tmp/JHJJMMTT-HHMMSS-ieffect-save.log** befindet sich das erweiterte Protokoll für diese Sicherung. ## Wiederherstellung aus dieser Sicherung Die mit dieser Sicherung angefertigte Kopie kann jederzeit wie unter [Wiederherstellen](https://confluence.menten.com/display/EN/Wiederherstellen) beschrieben, zurück gespeichert werden. --- version: "latest" language: "de" --- # i-effect wiederherstellen ## Vollständige Wiederherstellung von i-effect Soll i-effect^®^auf einen Stand VOR der Installation eines Updates oder Upgrades zurückgesetzt werden, enthält diese Anleitung die dafür notwendigen Schritte. Da die automatisierte Installation von i-effect einen automatischen Rollback bei Installationsabbruch durchführt, ist das hier beschriebene Vorgehen nur anzuwenden, wenn die automatische Wiederherstellung im Installationsprogramm fehlschlägt oder gezielt auf eine vorherige Version gewechselt werden soll. Vor dem Beginn einer Wiederherstellung, muss die installierte i-effect^®^ Version sauber deinstalliert oder gelöscht werden, ansonsten werden die Bibliotheken und IFS-Verzeichnisse zum Teil überschrieben und eine korrupte Installation könnte das Resultat sein. ### Wiederherstellung aus der Sicherung der automatischen Installation Die automatische Installation erstellt vor einem Update oder Upgrade eine Sicherung folgender Objekte: * Bibliotheken (Namen können bei personalisierter Installation abweichen) * IEFFECT * IEFFECTDB * IEFFECTSYS * IFS-Verzeichnisse * /home/ieffect/ * /i-effect/VxRxMx Aus diesen Objekten kann eine Sicherung wiederhergestellt werden. ### Wiederherstellung in den Stand VOR der letzte Installation Mit Hilfe des folgendes Skript Aufrufs, kann die Installation auf den Stand VOR der letzten Installation zurück gesetzt werden, die Installationsobjekte müssen dafür in /tmp/2mebeff noch vorhanden sein, oder eine neue ISO dort entpackt werden (s. unten). /tmp/2mebeff/scripts/restore2mebeff.sh -t *last Die Option \*LAST gibt hierbei an, dass auf die zuletzt angefertigte Sicherung zurückzugreifen ist. Die Sicherungen werden mit einer laufenden Nummer gekennzeichnet. Der Sicherungseintrag mit der höchsten laufenden Nummer repräsentiert die letzte angefertigte Sicherung. In der Bibliothek IEFFSAVE können die angefertigten Sicherungen eingesehen werden. Anhand der Objektbeschreibung kann der Versionsstand und das Datum der Sicherung abgelesen werden. | Objekt | Art | Attribut | Text | Erläuterung | |--------|--------|----------|--------------------------------|--------------------------------------------------------------------------------------| | APP1 | \*FILE | SAVF | APP 3.0.3 2022-11-25 13:07:29 | Sicherung des Applikationsschemas aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | DB1 | \*FILE | SAVF | DB 3.0.3 2022-11-25 13:07:29 | Sicherung des Datenbankschemas aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | ENV1 | \*FILE | PF_DTA | ENV 3.0.3 2022-11-25 13:07:29 | Sicherung der Umgebungsvariablen aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | IFS1 | \*FILE | SAVF | IFS 3.0.3 2022-11-25 13:07:29 | Sicherung der IFS Verzeichnisse aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | LNG1 | \*FILE | SAVF | LNG 3.0.3 2022-11-25 13:07:29 | Sicherung der Sekundärsprache aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | LNGS1 | \*FILE | SAVF | LNGS 3.0.3 2022-11-25 13:07:29 | Sicherung der Sekundärsprache (SYSBAS) aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | SYS1 | \*FILE | SAVF | SYS 3.0.3 2022-11-25 13:07:29 | Sicherung des SYSBAS Schema aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | | VER1 | \*FILE | PF-DTA | VER 3.0.3 2022-11-25 13:07:29 | Sicherung des Versionsstands aus Version3.0.3 vom 25.11.2022, 13:07:29 Uhr | ### Skript bereitstellen Die Wiederherstellung erfolgt mit der aktuellsten Version eines Skripts, das vorher bereit gestellt werden muss: Entpacken Sie den Unterordner **2MEBEFF** aus der **ISO** von i-effect und kopieren Sie den Ordner nach **/tmp**auf Ihrem IBM i System. Der Aufruf des Scripts erfolgt dann mit diesem Pfad /tmp/2mebeff/scripts/restore2mebeff.sh...... ### **Zurücksetzen auf den Stand mit dem Index "1"** Nach Eingabe des folgenden Befehls in einer QSH Sitzung wird der gewünschte Stand (abweichend von \*last) wiederhergestellt /tmp/2mebeff/scripts/restore2mebeff.sh -t 1 ### Anpassung für i-effect^®^ 2.7 Wurde mit dieser Wiederherstellung eine Version 2.7 wiederhergestellt, muss folgende Anpassung manuell vorgenommen werden CHGUSRPRF USRPRF(IEFFECT) JOBD(IEFFECTSYS/IEFFECTD) GRPPRF(\*NONE) ### Protokoll Auf der Konsole erscheinen folgende Meldungen im Laufe einer Wiederherstellung: /home/ieffect/current/base/tools/scripts/restore2mebeff.sh -t *last [13:21:50] *** (restore2mebeff.sh ) Gestartet um: Fr Nov 25 13:21:51 2022 [13:21:50] Initialisiere Restore... [13:21:50] Zugriffsrechte prüfen... [13:21:50] Check for existing backup files... [13:21:50] Rückspeicherung aus Identifizierung: 1 [13:21:50] Lesen der Backup Versionsnummer und Einstellungen... [13:21:50] Prüfe Sperren... [13:22:03] Starte Zurückspeicherung... [13:22:03] Entferne Journale... [13:22:08] Entferne Schemas und IFS Verzeichnisse... [13:22:41] Rückspeicherung von Schemas and Verzeichnissen... [13:24:09] Rückspeicherung der Umgebung... [13:24:09] Rückspeicherung erfolgreich [13:24:09] *** (restore2mebeff.sh ) Beendet um : Fr Nov 25 13:24:24 2022 <2 Minuten und 37 Sekunden> In der Protokolldatei **/tmp/JHJJMMTT-restore.log** befindet sich das erweiterte Protokoll für diese Rückspeicherung.. --- version: "latest" language: "de" --- # Installation ohne GUI Die Installation kann mit dem zur Verfügung stehenden Installationsscript direkt auf dem System gestartet werden. Die Verwendung des grafischen Installers ist nicht notwendig. Insbesonders in Umgebungen in denen die Übertragungsgeschwindigkeit zum Host über z.B. eine VPN Verbindung zu langsam ist, kann mit dieser Methode eine Installation direkt auf dem System ausgeführt werden. In diesem Dokument sind alle möglichen Aufrufszenarien und die damit verbundenen Parameterkombinationen dokumentiert. Die Installation wird im Verzeichnis ../2MEBEFF/scripts gestartet. In diesen Beispielen wurde das Verzeichnis 2MEBEFF von der ISO in das Verzeichnis /tmp des Zielsystems kopiert ## Neue Installation (Standardnamen) i-effect ist auf dem System noch nicht vorhanden und soll erstmalig installiert werden. Es werden die Standardnamen für Bibliotheken und Verzeichnisse verwendet |--------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW` | ## Neue Installation (Abweichende Benennung) i-effect ist auf dem System noch nicht vorhanden und soll erstmalig installiert werden. Es werden die Standardnamen für Bibliotheken und Verzeichnisse verwendet |--------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## Neue Installation mit Migration aus V2R7M0 i-effect ist in Version 2.7 bereits vorhanden. Diese Version soll parallel in neue Bibliotheken und Verzeichnisse installiert werden. Die Daten sollen aus der vorherigen Version übernommen werden. |-------------------------------------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW -m --previous_version v2r7m0 --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## Neue Installation mit Migration aus V2R8M0 i-effect ist in Version 2.8 bereits vorhanden. Diese Version soll parallel in neue Bibliotheken und Verzeichnisse installiert werden. Die Daten sollen aus der vorherigen Version übernommen werden. |-------------------------------------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW -m --previous_version v2r8m0 --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## Ersetzen einer vorhanden 2.7 Installation i-effect ist in Version 2.7 bereits vorhanden. Diese Version soll durch die neue Version ersetzt werden. |--------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type UPGRADE --previous_version v2r7m0` | ## Ersetzen einer vorhanden 2.8 Installation i-effect ist in Version 2.8 bereits vorhanden. Diese Version soll durch die neue Version ersetzt werden. |--------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type UPGRADE --previous_version v2r8m0` | ## Aktualisierung einer vorhandenen 2.9 Installation i-effect ist in Version 2.9 bereits vorhanden. Diese Version soll aktualisiert werden |-----------------------------------------| | `/tmp/2MEBEFF/install.sh --type update` | --- version: "latest" language: "de" --- # Numerische Werte mit CVTDBXLS mit Währungssymbol umsetzen Um Daten aus einer Datenbank in Excel so zu konvertieren, dass das Währungssymbol erscheint, sind die Parameter DFNSTYLES und APPSYLES wie folgt zu verwenden: (Hier wird die Spalte OZAPROR mit dem Stil "EURO" formatiert, der im Parameter DFNSTYLES definiert ist). CVTDBFXL FROMFILE(/) TOSTMF('/tmp/test') DFNSTYLES((EURO *NO *NO *GENERAL *NONE *BOTTOM *DFT *NO *AUTOFIT *ARIAL 10 *NO *NO *NO *AUTO *NONE *AUTO *NONE *NONE *AUTO *CUSTOM *F IELD *FMT *FMT *FMT *FMT '#,##0.00€;-#,## 0.00€')) APYSTYLES((*FLDNAM OZAPROR EURO)) EXCEL(*XLSX) --- version: "latest" language: "de" --- # org.apache.xmlbeans.XmlException: error: Unexpected element: CDATA ## Problem Der folgende Fehler kann in einer XMl Konvertierung auftreten [2018-04-10 15:44:43.276] [ 23015813 ms] [Snr= 111] [XML SOURCE prepare Thread] [ERROR] File couldn't be parsed org.apache.xmlbeans.XmlException: error: Unexpected element: CDATA Es könnte es sich hierbei um ein CCSID-Problem mit der Objektdatei (XSD) handeln. Es muss überprüft werden, ob es sich ggf. um eine mit UTF8 kodierte Datei handelt. ## Lösung Korrektur der CCSID der Datei. ## Verwandte Artikel ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Performance allgemein ## Problem Die allgemeine Performance der Anwendung liegt unterhalb der Erwartungen. ## Ursachen Für eine allgemeine Beeinträchtigung kommen unter anderem die beiden folgenden Ursachen in Betracht ### Netzwerkkonfiguration Die Basis Netzwerkkonfiguration des System sollte untersucht werden um auszuschließen, dass eine Fehlkonfiguration für die Performancebeeinträchtigung verantwortlich ist. [Überprüfung der Netzwerkkonfiguration](https://manual.i-effect.com/de/faq/latest/uberprufung-der-netzwerkkonfiguration.md) ### IPV6 ist aktiviert aber nicht konfiguriert Die JVM Geschwindigkeit kann bei aktiviertem, aber nicht konfiguriertem IPV6 beeinträchtigt sein. ### Lösung Sofern bei den oben beschriebenen Untersuchungen Fehler gefunden wurden, sind nach deren Korrekturen lediglich die i-effect Subsysteme erneut zu starten. ### Verwandte Artikel #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # SQLSTATE\[HY000\] SQLDriverConnect:30137 ## Problem Beim Anmelden in WebControl erscheint eine Fehlermeldung ![image2021-4-21_15-45-10.png](https://manual.i-effect.com/__attachments/a_72d8a3375abb294f2eebaeb21d880229e0bff6e27fcbf36d73faf3c09b9be563/image2021-4-21_15-45-10.png?cb=1fd314ac17bfda0c402c4c1b936c336f) ## Lösung Dieses Problem ist noch offen. Sobald eine Lösung bekannt ist wird sie hier veröffentlicht ## Verwandte Artikel ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Subsysteme starten nicht: Error while initializing system connection for i-effect. Wenn Sie das Problem haben, dass die Subsysteme nicht starten und Sie die nachfolgende Nachricht erhalten kann es sein das Ihnen Programmteile von i-effect Base im IFS fehlen. Nachrichten-ID . . . . : IEF9997 Bewertung . . . . . . : 40 Nachrichtenart . . . . : Information Sendedatum . . . . . . : 26.11.23 Sendezeit . . . . . . : 09:05:10 Nachricht . . . : Error while initializing system connection for i-effect. Kontrollieren Sie, ob Sie zumindest die nachfolgenden Dateien unterhalb von /home/ieffect/base finden können: * jtopen.properties * jvm.properties --- version: "latest" language: "de" --- # Subsysteme starten nicht. Socket Connect Error ## Problem Die Subsysteme können nicht gestartet werden. Ein Socket Connect Error wird ausgegeben. ## Lösung Es sollte überprüft werden, ob eine Verbindung von außen zu den HostServern möglich ist. ### HostServer prüfen Dazu auf einem PC mit installierten IBM Access Client den folgenden Befehl absetzen C:\>cwbping 10.206.2.1 Das erzeugte Protokoll enthält Hinweise zu Verbindungsproblemen BM i Access für Windows Version 7 Release 1 Stufe 0 Programm zum Überprüfen von Verbindungen (64-Bit) (C) Copyright IBM Corporation and Others 1984, 2010. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Licensed Materials - Property of IBM Mit der Tastenkombination STRG-C oder STRG-UNTBR können Sie die Anforderung CWBPING abbrechen I - Verbindung zu System 10.206.2.1 wird überprüft... I - Verbindung zu Serveranwendung Zentraler Client wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Netzwerkdatei wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Netzwerkdruck wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Datenzugriff wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Datenwarteschlangen wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Ferner Befehl wurde erfolgreich hergestellt I - Verbindung zu Serveranwendung Sicherheit wurde erfolgreich hergestellt F - CWBCO1003 - Sockets-Fehler, Funktion connect() hat 10060 zurückgegeben F - CWBCO1048 - Firewallblockierung oder Zeitlimitüberschreitung bei dem Versuch, Verbindung zu IBM i herzustellen F - CWBCO1008 - Verbindung zu Serveranwendung DDM nicht möglich, 10060 wurde zurückgegeben I - Verbindung zu Serveranwendung Telnet wurde erfolgreich hergestellt W - CWBCO1015 - Verbindung zu System 10.206.2.1 überprüft, jedoch Warnungen vorhanden ### Lokale Verbindung prüfen Den folgenden Befehl in einer QSH Sitzung eingeben java -cp /QIBM/ProdData/OS400/jt400/lib/jt400.jar utilities.JPing localhost Auf der Konsole werden die Ergebnisse der Prüfung angezeigt Verifying connections to system localhost... Successfully connected to server application: as-file Successfully connected to server application: as-netprt Successfully connected to server application: as-rmtcmd Successfully connected to server application: as-dtaq Successfully connected to server application: as-database Successfully connected to server application: as-ddm Successfully connected to server application: as-central Successfully connected to server application: as-signon Connection verified ### Lösung Ursache kann eine fehlerhafte Konfiguration des lokalen oder entfernten DNS Servers sein, der "localhost" zu einer falschen IP Adresse auflöst. Zusätzlich kann die Suchreihenfolge der DNS Server auf \*REMOTE statt auf \*LOCAL konfiguriert sein. ### Verwandte Artikel #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Subsystemjobs starten nicht; java.lang.UnsupportedClassVersionError ## Problem Diese Meldung deutet darauf hin, dass die JAVA Version nicht zur JAVA Version passt, mit der die i-effect Programme kompiliert wurden. Wahrscheinlich existiert eine JAVA_HOME Umgebungsvariable, die auf eine ältere JAVA Version zeigt. ## Lösung Zur Lösung muss eine neue Umgebungsvariable für i-effect gesetzt werden, die auf die korrekte JVM Version zeigt. ADDENVVAR ENVVAR('IEFFECT_JAVA_HOME') VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk626/32bit') Nach dem Ab- und wieder Anmelden kann das Subsystem erfolgreich gestartet werden. ## Verwandte Artikel ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "de" --- # Überprüfung der Netzwerkkonfiguration Zur Überprüfung der Netzwerkkonfiguration kann das IBM Tool [Administration Runtime Expert](http://www-03.ibm.com/systems/power/software/i/are/index.html) verwendet werden. Damit wird unter Anderem auch die Netzwerkkonfiguration überprüft. ## Überprüfung starten Folgenden Befehl in die QSHELL eingeben um die grundlegenden Netzwerkkonfigurationen zu überprüfen. /qibm/proddata/os/osgi/templates/bin/areVerify.sh -network Auf der Konsole erscheinen die folgenden Informationen JAVA_HOME set to /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:44:30 CEST 2021 Searching for elements Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier Running plugin Network Verifier Running plugin Network Configuration Checker Running plugin Product Verifier Network verification completed Summary report written to /home/qsecofr/network.summary Detailed report written to /home/qsecofr/network.out                         ## Ergebnis auswerten Die zwei erzeugten Protokolldateien enthalten einen Bericht über die aktuelle Netzwerkkonfiguration und eventuelle Fehler. Eine fehlerfreie Installation wird wie folgt dokumentiert IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:53:33 CEST 2021 Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier > Total number of file attribute items checked: 0 Running plugin Network Verifier Running plugin Network Configuration Checker Running plugin Product Verifier > Total number of product items checked: 1 -------------------------------------- Administration Runtime Expert completed with: Plugins run: 4 Items checked: 1 Error: 0 Warning: 0 Info: 0 Fix actions: 0 -------------------------------------- Details zu entdeckten Fehlern können in dieser ebenfalls erzeugten Datei nachgelesen werden IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:53:33 CEST 2021 Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier > A total of 1 XML rule file will be processed > Processing XML rule file (xml/FileAttr_networkConfigFiles.xml) for file attribute o Checking for existence of network configuration files in IFS - OK: No network configuration files found in IFS > Finished processing file attribute > Total number of file attribute items checked: 0 Result of running: true Running plugin Network Verifier > Retrieving local host name o Start time is Wed Apr 21 18:53:34 CEST 2021 o Local host name is TESTFP.GL.MENTEN.DE o End time is Wed Apr 21 18:53:34 CEST 2021 o Amount of time needed to retrieve local host name was 0 seconds > Checking loopback address by IP o OK: loopback address is 127.0.0.1 > Checking loopback address by name o OK: loopback address is 127.0.0.1 > Checking localhost address by name o OK: localhost address is 127.0.0.1 > Checking reverse DNS lookup of local host name o OK: Local host name and host name using reverse DNS are the same (TESTFP.GL.MENTEN.DE) Result of running: true Running plugin Network Configuration Checker > Verify TCP/IP domain information (CFGTCP option 12) o Checking for Fully Qualified Domain Name (FQDN) - OK: Host name = TESTFP - OK: Domain name = GL.MENTEN.DE # Fully Qualified Domain Name (FQDN) = 'TESTFP.GL.MENTEN.DE' o Checking DNS Settings - DNS 1 = 192.168.204.10 # OK: DNS Server available on the network - DNS 2 = 192.168.205.252 # OK: DNS Server available on the network o Checking the Host Name Search Priority - Host Name Search Priority is set to *LOCAL o Checking TCP/IP stack status - OK: TCP/IP stack status is ACTIVE o Checking values for Number of DNS Retries and Retry Interval - Number of DNS Retries is 2 - DNS Retry time interval, in seconds, is 2 o Checking Network Attributes - Verifying host name (TESTFP) is consistent in system configuration # OK: Host name in CFGTCP option 12 matches System Name in the network attributes from DSPNETA > Verify TCP/IP host table entries (CFGTCP option 10) o Searching the host table for the Fully Qualified Domain Name (FQDN) - OK: FQDN Found - Address = 192.168.200.164 # Host1 = TESTFP.GL.MENTEN.DE # Host2 = # Host3 = # Host4 = o Checking for LOOPBACK/LOCALHOST - OK: LOOPBACK/LOCALHOST found - Address = 127.0.0.1 # Host1 = LOOPBACK # Host2 = LOCALHOST # Host3 = # Host4 = > Verify TCP/IP interfaces (CFGTCP option 1) o Checking TCP/IP Interfaces - OK: Interface 192.168.200.164, which is assigned to the FQDN, exists on the system - OK: Interface 127.0.0.1, which is assigned to LOOPBACK/LOCALHOST, exists on the system o Checking TCP Interface status - OK: TCP/IP interface 127.0.0.1 is Active - OK: TCP/IP interface 192.168.200.164 has a status of Active Result of running: true Running plugin Product Verifier > A total of 1 XML rule file will be processed > Processing XML rule file (xml/Prod_dnsProduct.xml) for product > Retrieving product information for 5770SS1 option 0031 (V7R4M0) o OK: 5770SS1 option 0031 status is Installed > Finished processing product > Total number of product items checked: 1 Result of running: true --- version: "latest" language: "de" --- # Verwendete Ports Der Installer und die MapGUI verwenden den Port 449 und die Ports von 8470 bis 8476. --- version: "latest" language: "de" --- # Welche Version ist installiert? Um herauszufinden, welche Version des Produkts installiert ist, kann einer der beiden unten beschriebenen Verfahren verwendet werden. ## Grafische Oberfläche WebControl Nach Aufruf der grafischen Oberfläche von i-effect wird die derzeit verwendete Version in den Einstellungen unterhalb des Tabs **Softwareversion** angezeigt ![image2021-4-22_12-41-17.png](https://manual.i-effect.com/__attachments/a_f9e5cb85f998cf0e4e85f88a3ef6e2598fc3c3db0caab558253969e620b04bef/image2021-4-22_12-41-17.png?cb=ba54a347e47bcafaed08e8e4c94ad29e) ## Terminal / Greenscreen Aufruf des Hauptmenüs von i-effect in einer Terminalsitzung mit IEFFECT/IEFFECT Durch Drücken der ENTER Taste im Hauptmenü ohne eine Auswahl zu treffen, wird die aktuell verwendeten Version angezeigt: ![image2021-4-22_12-34-29.png](https://manual.i-effect.com/__attachments/a_e0923d574c1efdfd4e3f9abb72c45a1d81d232861e65b1c3bcd8dac8f957a9fa/image2021-4-22_12-34-29.png?cb=4fef69930539fd8f51b3420227813214) --- version: "latest" language: "de" --- # Wie ändere ich den Port des Tomcat-Servers/Service-API? Wenn Sie den Port des in i-effect verwendeten Tomcat-Servers anpassen möchten, weil z. B. ein anderes Programm diesen Port verwendet, müssen Sie zwei Schritt befolgen. 1. Port des Tomcats im Installationsverzeichnis anpassen (je nach Version lautet das Programmverzeichnis "IEFFECT310" unterschiedlich): # \IEFFECT310\base\tomcat\conf\server.xml 2. Angepassten Port auch in der Konfigurationsdatei von WebControl anpassen: # \IEFFECT310\webctrl\htdocs\module\Application\config\site.config "port_tomcat" => ":22080" // Portnummer Tomcat: immer mit Doppelpunkt angeben ! Danach das \*SERVICE-Subsystem neu starten. --- version: "latest" language: "de" --- # Wo erhalte ich neue Lizenzschlüssel Neue Lizenzschlüssel werden benötigt, wenn die Software auf einem anderen System/einer anderen Partition zum Einsatz kommen soll. Das ist regelmäßig dann der Fall, wenn neue Hardware eingesetzt wird, da sich in diesem Fall die Seriennummer ändert. Die neuen Lizenzschlüssel senden wir per E-Mail sobald wir das ausgefüllte und unterschriebene [Lizenzänderungsformular](https://www.i-effect.com/de/formulare/)erhalten haben. --- version: "latest" language: "de" --- # YUM Fehler beheben ## Problem Bei der Installation von i-effect wird angezeigt, dass YUM nicht korrekt arbeitet. Eine Überprüfung mit **yum check** zeigt Fehler wie diesen ### **Fehlermeldung von "yum check"** error: db4 error(-30974) from dbenv->open: DB_RUNRECOVERY: Fatal error, run database recovery error: cannot open Packages index using db4 - (-30974) error: cannot open Packages database in /QOpenSys/var/lib/rpm Traceback (most recent call last): File "/QOpenSys/pkgs/bin/yum", line 29, in yummain.user_main(sys.argv[1:], exit_code=True) File "/QOpenSys/pkgs/share/yum-cli/yummain.py", line 288, in user_main errcode = main(args) File "/QOpenSys/pkgs/share/yum-cli/yummain.py", line 140, in main result, resultmsgs = base.doCommands() File "/QOpenSys/pkgs/share/yum-cli/cli.py", line 440, in doCommands return self.yum_cli_commands[self.basecmd].doCommand(self, self.basecmd, self.extcmds) File "/QOpenSys/pkgs/share/yum-cli/yumcommands.py", line 1507, in doCommand header=lambda x: None): File "/QOpenSys/pkgs/lib/python2.7/site-packages/yum/__init__.py", line 1415, in _rpmdb_warn_checks for prob in self.rpmdb.check_dependencies(): File "/QOpenSys/pkgs/lib/python2.7/site-packages/yum/rpmsack.py", line 1454, in check_dependencies pkgs = self.returnPackages() File "/QOpenSys/pkgs/lib/python2.7/site-packages/yum/rpmsack.py", line 616, in returnPackages for hdr, idx in self._get_packages(): File "/QOpenSys/pkgs/lib/python2.7/site-packages/yum/rpmsack.py", line 1199, in _get_packages mi = ts.dbMatch(*args, **kwds) File "/QOpenSys/pkgs/lib/python2.7/site-packages/rpmUtils/transaction.py", line 58, in dbMatch mi = self.ts.dbMatch(*args, **kwds) _rpm.error: rpmdb open failed ## Lösung Die YUM Datenbank muss repariert werden, damit i-effect das YUM Tool verwenden kann um benötigte Programme zu installieren. Die folgenden Befehle eingeben ### **Datenbank reparieren** mv /QopenSys/var/lib/rpm/__db* /tmp/ rpm --rebuilddb yum clean all Eine anschließende Überprüfung sollte keine Fehler mehr melden. #### **Datenbank überprüfen** yum check check all ### YUM entfernen und neu installieren Lässt sich YUM nicht mit der oben beschriebenen Methode reparieren, kann YUM auch vollständig entfernt und neu installiert werden. Mit dem Entfernen von YUM müssen alle verwendeten Pakete neu installiert werden. Es ist sicher zu stellen, dass keine Anwendung /QOpenSys/pkgs verwendet, während diese Reparatur durchgeführt wird. Die von i-effect benötigten Pakete werden während der Installation automatisch geladen. Alle anderen Pakete muss der Benutzer manuell nach installlieren. #### **YUM vollständig entfernen** rm -r /QOpenSys/pkgs/ rm -r /QOpenSys/etc/yum/ rm -r /QOpenSys/var/cache/yum/ rm -r /QOpenSys/var/lib/yum/ rm -r /QOpenSys/var/lib/rpm/ ##### **Tools für i-effect installieren.** /i-effect/v2r9m0/base/tools/scripts/installTools.sh ## Verwandte Artikel * [YUM Fehler beheben](https://manual.i-effect.com/de/faq/latest/yum-fehler-beheben.md) * [Overall performance](https://manual.i-effect.com/en/faq/latest/overall-performance.md) * [The keystore is no longer displayed completely in Portecle](https://manual.i-effect.com/en/faq/latest/the-keystore-is-no-longer-displayed-completely-in-.md) * [com.menten.ieffect.mapper.db.engine.write.DataTargetException, SQL state \[38501\]; error code \[-443\]](https://manual.i-effect.com/en/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) * [Error while reading next node, Error while fetching next row from resultset](https://manual.i-effect.com/en/faq/latest/error-while-reading-next-node-error-while-fetching.md) * [Error while executing query. \ in Bibliothek für Operation ungültig.](https://manual.i-effect.com/de/faq/latest/error-while-executing-query-n-in-bibliothek-fur-op.md) * [Error while reading next node, Error while fetching next row from resultset](https://manual.i-effect.com/de/faq/latest/error-while-reading-next-node-error-while-fetching.md) * [Error while executing query. \ in library for operation invalid.](https://manual.i-effect.com/en/faq/latest/error-while-executing-query-n-in-library-for-opera.md) * [com.menten.ieffect.mapper.db.engine.write.DataTargetException, SQL state \[38501\]; error code \[-443\]](https://manual.i-effect.com/de/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) * [Subsystems do not start. Socket Connect Error](https://manual.i-effect.com/en/faq/latest/subsystems-do-not-start-socket-connect-error.md) * [Performance allgemein](https://manual.i-effect.com/de/faq/latest/performance-allgemein.md) * [YUM Fehler beheben](https://manual.i-effect.com/en/faq/latest/yum-fehler-beheben.md) * [Der Keystore wird nicht mehr vollständig in Portecle angezeigt](https://manual.i-effect.com/de/faq/latest/der-keystore-wird-nicht-mehr-vollstandig-in-portec.md) * [Subsystem jobs do not start; java.lang.UnsupportedClassVersionError](https://manual.i-effect.com/en/faq/latest/subsystem-jobs-do-not-start-java-lang-unsupportedc.md) * [org.apache.xmlbeans.XmlException: error: Unexpected element: CDATA](https://manual.i-effect.com/de/faq/latest/org-apache-xmlbeans-xmlexception-error-unexpected-.md) --- version: "latest" language: "en" --- # FAQ **Welcome!** This is the start page of the Knowledge Base area of i-effect. Here you will find a compilation of important articles on the topic groups **Instructions** and **troubleshooting articles**. Use the navigation on the left to access specific articles, or the following full-text search to search for keywords or text components in the articles. *** ** * ** *** ## Frequently asked questions * [Secure i-effect](https://manual.i-effect.com/en/faq/latest/backup-i-effect.md) * [Restore i-effect](https://manual.i-effect.com/en/faq/latest/restore-i-effect.md) ### Do you need more help? * [menten Helpdesk](https://helpdesk.menten.com/en) * [i-effect manual](https://manual.i-effect.com/en/) * [menten GmbH contact](https://www.menten.com/en/contact) ### Other resources * [IBM Support](https://www.ibm.com/mysupport/s/?language=en_US) * [i-effect](https://www.i-effect.com/en) * [menten GmbH](https://www.menten.com/en) *** ** * ** *** ## Search by topic 1. A-E * [browser]( /wiki/label/FAQmanual/browser ) * [config]( /wiki/label/FAQmanual/config ) * [connect]( /wiki/label/FAQmanual/connect ) * [console]( /wiki/label/FAQmanual/console ) * [cvtdbxls]( /wiki/label/FAQmanual/cvtdbxls ) * [db]( /wiki/label/FAQmanual/db ) * [db2]( /wiki/label/FAQmanual/db2 ) * [dns]( /wiki/label/FAQmanual/dns ) * [excel]( /wiki/label/FAQmanual/excel ) * [exitpoints]( /wiki/label/FAQmanual/exitpoints ) 2. F-K * [firefox]( /wiki/label/FAQmanual/firefox ) * [headless]( /wiki/label/FAQmanual/headless ) * [hy000]( /wiki/label/FAQmanual/hy000 ) * [ifs]( /wiki/label/FAQmanual/ifs ) * [install]( /wiki/label/FAQmanual/install ) * [installation]( /wiki/label/FAQmanual/installation ) * [ipv6]( /wiki/label/FAQmanual/ipv6 ) * [java]( /wiki/label/FAQmanual/java ) * [keys]( /wiki/label/FAQmanual/keys ) * [keystore]( /wiki/label/FAQmanual/keystore ) 3. L-P * [library]( /wiki/label/FAQmanual/library ) * [license]( /wiki/label/FAQmanual/license ) * [mapgui]( /wiki/label/FAQmanual/mapgui ) * [mapper]( /wiki/label/FAQmanual/mapper ) * [move]( /wiki/label/FAQmanual/move ) * [needs-translating]( /wiki/label/FAQmanual/needs-translating ) * [network]( /wiki/label/FAQmanual/network ) * [portecle]( /wiki/label/FAQmanual/portecle ) * [portnummer]( /wiki/label/FAQmanual/portnummer ) 4. Q-S * [qibm_qca_chg_command]( /wiki/labels/viewlabel.action?ids=1944388091&key=FAQmanual ) * [qibm_qca_rtv_command]( /wiki/labels/viewlabel.action?ids=1944388092&key=FAQmanual ) * [rename]( /wiki/label/FAQmanual/rename ) * [restore]( /wiki/label/FAQmanual/restore ) * [rpmdb]( /wiki/label/FAQmanual/rpmdb ) * [save]( /wiki/label/FAQmanual/save ) * [socket]( /wiki/label/FAQmanual/socket ) * [sqldriverconnect]( /wiki/label/FAQmanual/sqldriverconnect ) * [subsystem]( /wiki/label/FAQmanual/subsystem ) 5. T-Z * [tcp/ip]( /wiki/labels/viewlabel.action?ids=1944388089&key=FAQmanual ) * [translated]( /wiki/label/FAQmanual/translated ) * [version]( /wiki/label/FAQmanual/version ) * [webcontrol]( /wiki/label/FAQmanual/webcontrol ) * [xml]( /wiki/label/FAQmanual/xml ) * [xsd]( /wiki/label/FAQmanual/xsd ) * [yum]( /wiki/label/FAQmanual/yum ) ## Recently updated articles * [Fehler beim Importieren von Zertifikaten](https://manual.i-effect.com/de/faq/latest/fehler-beim-importieren-von-zertifikaten.md) * Feb. 12, 2026 bereitgestellt * [Error importing certificates](https://manual.i-effect.com/en/faq/latest/error-importing-certificates.md) * Feb. 12, 2026 bereitgestellt * [FAQ](https://manual.i-effect.com/de/faq/latest.md) * Jan. 14, 2026 bereitgestellt * [Subsysteme starten nicht: Error while initializing system connection for i-effect.](https://manual.i-effect.com/de/faq/latest/subsysteme-starten-nicht-error-while-initializing-.md) * Jan. 14, 2026 bereitgestellt * [FAQ](https://manual.i-effect.com/en/faq/latest.md) * Jan. 14, 2026 bereitgestellt * [Installation without GUI](https://manual.i-effect.com/en/faq/latest/installation-without-gui.md) * Jan. 09, 2026 bereitgestellt * [Installation ohne GUI](https://manual.i-effect.com/de/faq/latest/installation-ohne-gui.md) * Jan. 09, 2026 bereitgestellt * [i-effect auf ein anderes System übertragen](https://manual.i-effect.com/de/faq/latest/i-effect-auf-ein-anderes-system-ubertragen.md) * Jan. 09, 2026 bereitgestellt * [Transfer i-effect to another system](https://manual.i-effect.com/en/faq/latest/transfer-i-effect-to-another-system.md) * Jan. 09, 2026 bereitgestellt * [YUM Fehler beheben](https://manual.i-effect.com/de/faq/latest/yum-fehler-beheben.md) * Nov. 21, 2025 bereitgestellt * [How do I change the port of the Tomcat server/service API?](https://manual.i-effect.com/en/faq/latest/how-do-i-change-the-port-of-the-tomcat-server-serv.md) * Mai 12, 2025 bereitgestellt * [Wie ändere ich den Port des Tomcat-Servers/Service-API?](https://manual.i-effect.com/de/faq/latest/wie-andere-ich-den-port-des-tomcat-servers-service.md) * Mai 12, 2025 bereitgestellt * [Restore i-effect](https://manual.i-effect.com/en/faq/latest/restore-i-effect.md) * Feb. 05, 2024 bereitgestellt * [i-effect wiederherstellen](https://manual.i-effect.com/de/faq/latest/i-effect-wiederherstellen.md) * Feb. 05, 2024 bereitgestellt * [Wie kann ich die Namen der von i-effect verwendeten Bibliotheken ändern?](https://manual.i-effect.com/de/faq/latest/i-effect-auf-ein-anderes-system-ubertragen/wie-kann-ich-die-namen-der-von-i-effect-verwendete.md) * Jan. 20, 2024 bereitgestellt --- version: "latest" language: "en" --- # Backup i-effect If i-effect® is to be backed up completely, these instructions contain the processing steps necessary for this. Since the automated installation of i-effect also makes an automatic backup, the procedure described here is only to be used if another backup is to be made specifically. i-effect® must be closed before the backup is started ([Ending i-effect](https://manual.i-effect.com/en/installation/vor-der-installation/upgrade-und-update/i-effect-beenden)). ## Save the current status With the help of the following script command, the current installation with all its components can be backed up. This includes all objects used by the product such as libraries and IFS directories, as well as environment variables and settings. The backups are marked with a consecutive number. This backup is assigned the next available number. The backups made can be viewed in the IEFFSAVE library. The version and date of the backup can be read from the object description. | Object | Type | Attribut | Text | Explanation | |--------|--------|----------|--------------------------------------|--------------------------------------------------------------------------------| | APP0 | \*FILE | SAVF | APP 2.9.0-RC100 2021-03-22 16:48:01 | Backup of the application schema from version 2.9.0 from 22.3.2021, 16:48:01 | | APP1 | \*FILE | SAVF | APP 2.9.0-RC109 2021-03-22 17:12:55 | Backup of application schema from version 2.9.0 from 22.3.2021, 17:12:55 | | DB0 | \*FILE | SAVF | DB 2.9.0-RC100 2021-03-22 16:48:01 | Backup of database schema from version 2.9.0 from 22.3.2021, 16:48:01 | | DB1 | \*FILE | SAVF | DB 2.9.0-RC109 2021-03-22 17:12:55 | Backup of database schema from version 2.9.0 from 22.3.2021, 17:12:55 | | ENV0 | \*FILE | PF-DTA | ENV 2.9.0-RC100 2021-03-22 16:48:01 | Backup of environment variables from version 2.9.0 from 22.3.2021, 16:48:01 | | ENV1 | \*FILE | PF_DTA | ENV 2.9.0-RC109 2021-03-22 17:12:55 | Backup of environment variables from version 2.9.0 from 22.3.2021, 17:12:55 | | IFS0 | \*FILE | SAVF | IFS 2.9.0-RC100 2021-03-22 16:48:01 | Backup of IFS directories from version 2.9.0 from 22.3.2021, 16:48:01 | | IFS1 | \*FILE | SAVF | IFS 2.9.0-RC109 2021-03-22 17:12:55 | Backup of IFS directories from version 2.9.0 from 22.3.2021, 17:12:55 | | LNG0 | \*FILE | SAVF | LNG 2.9.0-RC100 2021-03-22 16:48:01 | Secondary language backup from version 2.9.0 from 22.3.2021, 16:48:01 | | LNG1 | \*FILE | SAVF | LNG 2.9.0-RC109 2021-03-22 17:12:55 | Secondary language backup from version 2.9.0 from 22.3.2021, 17:12:55 | | LNGS0 | \*FILE | SAVF | LNGS 2.9.0-RC100 2021-03-22 16:48:01 | Secondary language backup (SYSBAS) from version 2.9.0 from 22.3.2021, 16:48:01 | | LNGS1 | \*FILE | SAVF | LNGS 2.9.0-RC109 2021-03-22 17:12:55 | Secondary language backup (SYSBAS) from version 2.9.0 from 22.3.2021, 17:12:55 | | SYS0 | \*FILE | SAVF | SYS 2.9.0-RC100 2021-03-22 16:48:01 | Backup of SYSBAS schema from version 2.9.0 from 22.3.2021, 16:48:01 | | SYS1 | \*FILE | SAVF | SYS 2.9.0-RC109 2021-03-22 17:12:55 | Backup of SYSBAS schema from version 2.9.0 from 22.3.2021, 17:12:55 | | VER0 | \*FILE | PF-DTA | VER 2.9.0-RC100 2021-03-22 16:48:01 | Backup of version status from version 2.9.0 from 22.3.2021, 16:48:01 | | VER1 | \*FILE | PF-DTA | VER 2.9.0-RC109 2021-03-22 17:12:55 | Backup of version status from version 2.9.0 from 22.3.2021, 17:12:55 | ### **Start backup** After entering the following command in a QSH session, the current state is saved /i-effect/v2r9m0/base/tools/scripts/save2mebeff.sh -v v2r9m0 #### Protocol The following messages appear on the console during a backup: [17:34:47] *** Started at: Mon Mar 22 17:34:47 2021 [17:34:47] Check access rights... [17:34:52] Check locks... [17:35:26] Starting backup... [17:35:26] Backup with unique identification: 13 [17:36:14] *** Ends at : Mon Mar 22 17:36:14 2021set [17:36:14] *** Duration : 1 minutes and 30 seconds elapsed. [17:36:14] Backup successfully completed. #### Log file The log file /tmp/JHJJMMTT-HHMMSS-ieffect-save.log contains the extended log for this backup. ## Restore from this backup The copy made with this backup can be saved back at any time as described in [Restore](https://confluence.menten.com/display/EN/Wiederherstellen) --- version: "latest" language: "en" --- # Checking the network configuration The IBM tool [Administration Runtime Expert](http://www-03.ibm.com/systems/power/software/i/are/index.html) can be used to check the network configuration. Among other things, this also checks the network configuration. ## Start checking Enter the following command in the QSHELL to check the basic network configurations. /qibm/proddata/os/osgi/templates/bin/areVerify.sh -network The following information appears on the console JAVA_HOME set to /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:44:30 CEST 2021 Searching for elements Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier Running plugin Network Verifier Running plugin Network Configuration Checker Running plugin Product Verifier Network verification completed Summary report written to /home/qsecofr/network.summary Detailed report written to /home/qsecofr/network.out                         ## Evaluate result The two log files generated contain a report on the current network configuration and any errors. An error-free installation is documented as follows IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:53:33 CEST 2021 Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier > Total number of file attribute items checked: 0 Running plugin Network Verifier Running plugin Network Configuration Checker Running plugin Product Verifier > Total number of product items checked: 1 -------------------------------------- Administration Runtime Expert completed with: Plugins run: 4 Items checked: 1 Error: 0 Warning: 0 Info: 0 Fix actions: 0 -------------------------------------- Details of detected errors can be found in this file which was also generated IBM Administration Runtime Expert for i Version 1.6.20 Wed Apr 21 18:53:33 CEST 2021 Using template: file:/qibm/proddata/os/osgi/templates/verifynetwork.jar (1.0.2) Number of runtime elements: 25 Running with user: QSECOFR User QSECOFR has *ALLOBJ authority Running plugin File Attribute Verifier > A total of 1 XML rule file will be processed > Processing XML rule file (xml/FileAttr_networkConfigFiles.xml) for file attribute o Checking for existence of network configuration files in IFS - OK: No network configuration files found in IFS > Finished processing file attribute > Total number of file attribute items checked: 0 Result of running: true Running plugin Network Verifier > Retrieving local host name o Start time is Wed Apr 21 18:53:34 CEST 2021 o Local host name is TESTFP.GL.MENTEN.DE o End time is Wed Apr 21 18:53:34 CEST 2021 o Amount of time needed to retrieve local host name was 0 seconds > Checking loopback address by IP o OK: loopback address is 127.0.0.1 > Checking loopback address by name o OK: loopback address is 127.0.0.1 > Checking localhost address by name o OK: localhost address is 127.0.0.1 > Checking reverse DNS lookup of local host name o OK: Local host name and host name using reverse DNS are the same (TESTFP.GL.MENTEN.DE) Result of running: true Running plugin Network Configuration Checker > Verify TCP/IP domain information (CFGTCP option 12) o Checking for Fully Qualified Domain Name (FQDN) - OK: Host name = TESTFP - OK: Domain name = GL.MENTEN.DE # Fully Qualified Domain Name (FQDN) = 'TESTFP.GL.MENTEN.DE' o Checking DNS Settings - DNS 1 = 192.168.204.10 # OK: DNS Server available on the network - DNS 2 = 192.168.205.252 # OK: DNS Server available on the network o Checking the Host Name Search Priority - Host Name Search Priority is set to *LOCAL o Checking TCP/IP stack status - OK: TCP/IP stack status is ACTIVE o Checking values for Number of DNS Retries and Retry Interval - Number of DNS Retries is 2 - DNS Retry time interval, in seconds, is 2 o Checking Network Attributes - Verifying host name (TESTFP) is consistent in system configuration # OK: Host name in CFGTCP option 12 matches System Name in the network attributes from DSPNETA > Verify TCP/IP host table entries (CFGTCP option 10) o Searching the host table for the Fully Qualified Domain Name (FQDN) - OK: FQDN Found - Address = 192.168.200.164 # Host1 = TESTFP.GL.MENTEN.DE # Host2 = # Host3 = # Host4 = o Checking for LOOPBACK/LOCALHOST - OK: LOOPBACK/LOCALHOST found - Address = 127.0.0.1 # Host1 = LOOPBACK # Host2 = LOCALHOST # Host3 = # Host4 = > Verify TCP/IP interfaces (CFGTCP option 1) o Checking TCP/IP Interfaces - OK: Interface 192.168.200.164, which is assigned to the FQDN, exists on the system - OK: Interface 127.0.0.1, which is assigned to LOOPBACK/LOCALHOST, exists on the system o Checking TCP Interface status - OK: TCP/IP interface 127.0.0.1 is Active - OK: TCP/IP interface 192.168.200.164 has a status of Active Result of running: true Running plugin Product Verifier > A total of 1 XML rule file will be processed > Processing XML rule file (xml/Prod_dnsProduct.xml) for product > Retrieving product information for 5770SS1 option 0031 (V7R4M0) o OK: 5770SS1 option 0031 status is Installed > Finished processing product > Total number of product items checked: 1 Result of running: true --- version: "latest" language: "en" --- # com.menten.ieffect.mapper.db.engine.write.DataTargetException, SQL state \[38501\]; error code \[-443\] ## Problem In a mapping where datasets are written to a DB2 table, the SQL error described above may occur if there is a trigger program attached to the table that cannot be found. ## Reason The reason is the use of the "native" DB2 driver without specifying a library list in the URL. ## Solution The following change can be made in the file /i-effect/V2r9m0/mapper/db/preferences.xml": BEFORE: \jdbc:[as400://mapmam;driver=native;naming=sql;date](https://manual.i-effect.com/en/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) format=iso;translate binary=true\ AFTER: \jdbc:[as400://mapmam;naming=sql;date](https://manual.i-effect.com/en/faq/latest/com-menten-ieffect-mapper-db-engine-write-datatarg.md) format=iso;translate binary=true\ ## Related articles ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Convert numeric values with CVTDBXLS with currency symbol To convert data from a database to Excel so that the currency symbol appears, the DFNSTYLES and APPSYLES parameters are to be used as follows: (Here the OZAPROR column is formatted with the "EURO" style defined in the DFNSTYLES parameter). CVTDBFXL FROMFILE(/) TOSTMF('/tmp/test') DFNSTYLES((EURO *NO *NO *GENERAL *NONE *BOTTOM *DFT *NO *AUTOFIT *ARIAL 10 *NO *NO *NO *AUTO *NONE *AUTO *NONE *NONE *AUTO *CUSTOM *F IELD *FMT *FMT *FMT *FMT '#,##0.00€;-#,## 0.00€')) APYSTYLES((*FLDNAM OZAPROR EURO)) EXCEL(*XLSX) --- version: "latest" language: "en" --- # Create new exit points i-effect uses the exit points QIBM_QCA_CHG_COMMAND and QIBM_QCA_RTV_COMMAND. If it is necessary to recreate these i-effect exit points, the following command can be used. In the command, replace vXrYmZ with the installed version, e.g., V3R1M0**Exitpoints erstellen** ## **Create Exit Points** Enter the following command in a QSHell (STRQSH) or SSH session: /home/ieffect/current/base/tools/scripts/setup.sh --mode recreateexitpoints --version vXrYmZ ## **Messages** The following messages are displayed on the console qsecofr@MAPRM:~# /home/ieffect/current/base/tools/scripts/setup.sh --mode recreateexitpoints --version v3r1m0 *** (setup.sh) Started at: Wed Sep 16 09:01:36 CEST 2026 Remove old command exit point entries... Configure objects.. Adjusting commands... *** i-effect Mode:RECREATEEXITPOINTS operation completed. SETUP finished successfully *** (setup.sh) Ended at: Wed Sep 16 09:04:08 CEST 2026 <2 minutes and 34 seconds> qsecofr@MAPRM:~# --- version: "latest" language: "en" --- # Error importing certificates When importing certificate chains, an HTTP 400 error message may occur in the API (service subsystem). This is caused by an excessive amount of data in the HTTP header of the request. As a solution, the value "maxHttpHeaderSize" in Tomcat can be adjusted. Open the following file: \IEFFECT\V3R1M0\base\tomcat\conf\server.xml Add this line to the "Connector" block: maxHttpHeaderSize="65536" The block should then look like this: Then restart the \*SERVICE subsystem. --- version: "latest" language: "en" --- # Error while executing query. \ in library for operation invalid. ## Problem This error can occur with mappings that work with tables/databases that are not yet recorded in the journal. ## Solution Add the files to the journal with: STRJRNPF FILE(BIBLIOTHEK/FILE) JRN(IEFFECTDB/EDIJRN) IMAGES(*BOTH) ## Related articles ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Error while reading next node, Error while fetching next row from resultset ## Problem The error *com.menten.ieffect.mapper.db.DBModuleException: Error while reading next node* or *Error while fetching next row from resultset*appears if changes have been made to your database that are not yet known to the IBM i or i-effect due to an SQL package. ## Solution Enter the following command to find all SQL packages from i-effect. wrkobj *ALL/IEFF* *SQLPKG Delete the displayed SQL packages with selection 4. Exit and start the i-effect \*EDI subsystem. endeffsbs *edi streffsbs *edi ### Related articles #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # How do I change the port of the Tomcat server/service API? If you want to adjust the port of the Tomcat server used in i-effect, e.g. because another program uses this port, you must follow two steps. Adjust the port of the Tomcat in the installation directory (depending on the version, the program directory "IEFFECT310" is different): 1. # \IEFFECT310\base\tomcat\conf\server.xml 2. Also adjust the port in the WebControl configuration file: # \IEFFECT310\webctrl\htdocs\module\Application\config\site.config "port_tomcat" => ":22080" // Portnummer Tomcat: immer mit Doppelpunkt angeben ! Then restart the \*SERVICE subsystem. --- version: "latest" language: "en" --- # Installation without GUI The installation can be started directly on the system with the available installation script. The use of the graphical installer is not necessary. Especially in environments where the transmission speed to the host via e.g. a VPN connection is too slow, this method can be used to perform an installation directly on the system. In this document all possible call scenarios and the associated parameter combinations are documented. The installation is started in the directory ../2MEBEFF/scripts. In these examples, the 2MEBEFF directory was copied from the ISO to the /tmp directory of the target system ## New installation (default name) i-effect is not yet present on the system and is to be installed for the first time. The default names for libraries and directories are used |--------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW` | ## New installation (different name) i-effect is not yet present on the system and is to be installed for the first time. The default names for libraries and directories are used |--------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## New installation with migration from V2R7M0 i-effect is already available in version 2.7. This version is to be installed in parallel in new libraries and directories. The data is to be taken over from the previous version. |-------------------------------------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW -m --previous_version v2r7m0 --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## New installation with migration from V2R8M0 i-effect is already available in version 2.8. This version is to be installed in parallel in new libraries and directories. The data is to be taken over from the previous version. |-------------------------------------------------------------------------------------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type NEW -m --previous_version v2r8m0 --application_schema IEFFECT --db_schema IEFFECTDB --sysbas_schema IEFFECTSYS` | ## Replacing an existing 2.7 installation i-effect is already available in version 2.7. This version is to be replaced by the new version. |--------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type UPGRADE --previous_version v2r7m0` | ## Replacing an existing 2.8 installation i-effect is already available in version 2.8. This version is to be replaced by the new version. |--------------------------------------------------------------------| | `/tmp/2MEBEFF/install.sh --type UPGRADE --previous_version v2r8m0` | ## Updating an existing 2.9 installation i-effect is already available in version 2.9. This version is to be updated |-----------------------------------------| | `/tmp/2MEBEFF/install.sh --type update` | --- version: "latest" language: "en" --- # Instruction articles *** ** * ** *** ## How-to article Provide step-by-step guidance for completing a task. Add how-to article --- version: "latest" language: "en" --- # Firefox Port Sharing In newer versions of Firefox, some port numbers are considered insecure and are blocked. Among them are the port numbers used by ZendServer like 10080 or 10088. To set up an exception rule in Firefox for these port numbers, please do the following: * In the Firefox navigation bar, enter the URL **about:config** and confirm access. * Create a new entry of type string named **network.security.ports.banned.override**. * Enter the desired port number or a comma-separated port list. E.g. the ZendServer port number from the address bar: 10080. After that the page should work again in Firefox. --- version: "latest" language: "en" --- # WebControl licenses In the GreenScreen you can see the license information for the WebControl module with the command WRKLICINF. With options 5 and 8 you can see how many and which users are currently using a license. Per login in WebControl a license is locked and only unlocked again when this user logs off in WebControl. However, there is a function that allows a user via the session cookies to close the browser without logging out, and to continue working in the same browser without a new license query the next time WebControl is opened. However, it must really be the same browser/computer without cleared cache and the WebControl subsystem (WEBCTRL) must not be closed in the meantime. To release the license for inactive users under V2R8M0 or V2R9M0 you can use this call: select IEFFECTDB.ReleaseProductLicense('2MEBEFF','V2R9M0','5003','') from SYSIBM.SYSDUMMY1 --- version: "latest" language: "en" --- # org.apache.xmlbeans.XmlException: error: Unexpected element: CDATA ## Problem The following error may occur in an XMl conversion [2018-04-10 15:44:43.276] [ 23015813 ms] [Snr= 111] [XML SOURCE prepare Thread] [ERROR] File couldn't be parsed org.apache.xmlbeans.XmlException: error: Unexpected element: CDATA EThis could be a CCSID problem with the object file (XSD). It must be checked if it is a UTF8 encoded file. ## Solution Correction of the CCSID of the file. ## Related articles Related articles appear here based on the keywords you select. Click to edit the macro and add or change keywords. ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Overall performance ## Problem The overall performance of the application is below expectations. ## Reason The following two reasons, among others, may be considered for general impairment. ### Network configuration The basic network configuration of the system should be examined to rule out the possibility that a misconfiguration is responsible for the performance degradation. [Checking the network configuration](https://manual.i-effect.com/en/faq/latest/checking-the-network-configuration.md) ### IPV6 is enabled but not configured JVM speed may be affected if IPV6 is enabled but not configured. ### Solution If errors were found during the above described tests, only the i-effect subsystems have to be restarted after their corrections. ### Related articles #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Ports used The installer and the MapGUI use port 449 and ports from 8470 to 8476. --- version: "latest" language: "en" --- # Restore i-effect ## Restore the license program 2MEBEFF If i-effect® is to be reset to a status BEFORE installing an update or upgrade, this manual contains the necessary processing steps. Since the automated installation of i-effect performs an automatic rollback when the installation is aborted, the procedure described here should only be used if the automatic restore in the installation program fails or if you want to switch to a previous version. Before starting a restore, the installed i-effect® version must be uninstalled or deleted cleanly, otherwise the libraries and IFS directories will be partially overwritten and a corrupt installation could be the result. ### Restoring from the automatic installation backup The automatic installation creates a backup of the following objects before an update or upgrade: * Libraries (names may differ for personalized installation) * IEFFECT * IEFFECTDB * IEFFECTSYS * IFS directories * /home/ieffect/ * /i-effect/VxRxMx A backup can be restored from these objects. ### Restore to the state BEFORE the last installation With the help of the following script call, the installation can be reset to the status BEFORE the last installation, the installation objects must still be present in /tmp/2mebeff, or a new ISO must be unpacked there (see below). /tmp/2mebeff/scripts/restore2mebeff.sh -t *last The \*LAST option indicates that the last backup created is to be used. The backups are identified with a sequential number. The backup entry with the highest sequential number represents the last backup made. The backups made can be viewed in the IEFFSAVE library. The version status and date of the backup can be read from the object description. | **Object** | **Type** | **Attribut** | **Text** | **Description** | |------------|----------|--------------|------------------------------------|---------------------------------------------------------------------------------------| | APP | \*FILE | SAVF | APP 2.8.3 Wed Sep 02,2020 17:25:26 | Backup of the application schema BEFORE the last installation | | APP0 | \*FILE | SAVF | APP 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the application schema BEFORE the penultimate installation | | DB | \*FILE | SAVF | DB 2.8.3 Wed Sep 02,2020 17:25:26 | Backup of the database schema BEFORE the last installation | | DB0 | \*FILE | SAVF | DB 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the database schema BEFORE the penultimate installation | | ENV | \*FILE | PF-DTA | ENV 2.8.3 Wed Sep 02,2020 17:25:26 | Backup of the environment variables BEFORE the last installation | | ENV0 | \*FILE | PF_DTA | ENV 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the environment variables BEFORE the penultimate installation | | IFS | \*FILE | SAVF | IFS 2.8.3 Wed Sep 02,2020 17:25:26 | Backup the IFS directories BEFORE the last installation | | IFS0 | \*FILE | SAVF | IFS 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the IFS directories BEFORE the penultimate installation | | LNG | \*FILE | SAVF | LNG 2.8.1 Wed Sep 02,2020 17:25:26 | Backup of the secondary language library BEFORE the penultimate installation | | LNG0 | \*FILE | SAVF | LNG 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the secondary language library BEFORE the penultimate installation | | SYS | \*FILE | SAVF | SYS 2.8.3 Wed Sep 02,2020 17:25:26 | Backup of the sysbasema BEFORE the last installation | | SYS0 | \*FILE | SAVF | SYS 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the sysbasema BEFORE the penultimate installation | | VRM | \*FILE | PF-DTA | VRM 2.8.3 Wed Sep 02,2020 17:25:26 | Backup of the version setting BEFORE the last installation | | VRM0 | \*FILE | PF-DTA | VRM 2.8.1 Wed Aug 28,2020 14:35:12 | Index 0: Backup of the version setting BEFORE the penultimate installation | ### Deploy script The recovery is performed with the latest version of a script that must be provided beforehand: Extract the subfolder 2MEBEFF from the ISO of i-effect and copy the folder to /tmp on your IBM i system. The script is then called with this path. ### Reset to the backup with the index "1" After entering the following command in a QSH session, the desired status (different from \*last) is restored: /tmp/2mebeff/scripts/restore2mebeff.sh -t 1 ### Customization for i-effect® 2.7 If a version 2.7 was restored with this restore, the following adjustment must be made manually CHGUSRPRF USRPRF(IEFFECT) JOBD(IEFFECTSYS/IEFFECTD) GRPPRF(*NONE) ### **Protocol** The following messages appear on the console during a restore: /i-effect/v2r8m0/base/tools/scripts/restore2mebeff.sh -t *last Check access rights... Check for existing backup files... Read backup environment settings... Restoring into: Home directory:/home/ieffect Application schema:IEFFECT28 in catalog:K009777T on device:*SYSBAS System schema:IEFFECTS28 Database schema:IEFFECTDB in catalog:K009777T on device:*SYSBAS IFS directory:/i-effect/V2R8M0 Check locks.... Starting restore... Removing journals... DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. Removing current schema IEFFECT28... Removing current schema IEFFECTS28... Removing current schema IEFFECTDB... Restoring IEFFECT28 from IEFFSAVE/APPSCHEMA on device *SYSBAS... CPC3703: 1212 Objekt(e) von IEFFECT28 nach IEFFECT28 zurückgespeichert. Restoring IEFFECTS28 from IEFFSAVE/SYSSCHEMA on device *SYSBAS... CPC3703: 162 Objekt(e) von IEFFECTS28 nach IEFFECTS28 zurückgespeichert Restoring IEFFECTDB from IEFFSAVE/DBSCHEMA on device *SYSBAS... CPC3703: 355 Objekt(e) von IEFFECTDB nach IEFFECTDB zurückgespeichert. Restoring IFS directories /i-effect/V2R8M0 and /home/ieffect CPC370F: 2713 Objekte zurückgespeichert. CPCA082: Objekt kopiert. Repairing DB... *** *** *** Setting up i-effect with the following settings *** Current running version: V2R8M0 Current APP device: *SYSBAS Current APP catalog: K009777T Current APP schema: IEFFECT28 Current APP schema path: /QSYS.LIB/IEFFECT28.LIB Current IFS device: *SYSBAS Current IFS path: /i-effect/V2R8M0 Current DB device: *SYSBAS Current DB catalog: K009777T Current DB schema: IEFFECTDB Current DB schema path: /QSYS.LIB/IEFFECTDB.LIB Current LNG device: *SYSBAS Current LNG schema: *NONE Current URL: jdbc:as400://localhost/IEFFECTDB TARGET APP device: *SYSBAS TARGET APP catalog: K009777T TARGET APP schema: IEFFECT28 TARGET APP schema path: /QSYS.LIB/IEFFECT28.LIB TARGET IFS device: *SYSBAS TARGET IFS path: /i-effect/V2R8M0 TARGET DB device: *SYSBAS TARGET DB catalog: K009777T TARGET DB schema: IEFFECTDB TARGET DB schema path: /QSYS.LIB/IEFFECTDB.LIB TARGET LNG device: *SYSBAS TARGET LNG schema: *NONE TARGET URL: jdbc:as400://localhost/IEFFECTDB Mode: REPAIRDB Source: *ALL Creating temporary database IEFFTMPDB. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. Updating the database with /i-effect/V2R8M0 jdbc:as400://localhost/IEFFTMPDB IEFFECT28 IEFFTMPDB /i-effect/V2R8M0/BASE/database/changesets/master.xml Checking differences between IEFFECTDB and IEFFTMPDB. Diffing the database with /i-effect/V2R8M0 jdbc:as400://localhost/IEFFECTDB IEFFECT28 IEFFECTDB jdbc:as400://localhost/IEFFTMPDB /tmp/IEFFECTDB_IEFFTMPDB.diff.xml Applying difference to IEFFECTDB. Updating the database with /i-effect/V2R8M0 jdbc:as400://localhost/IEFFECTDB IEFFECT28 IEFFECTDB /tmp/IEFFECTDB_IEFFTMPDB.diff.xml Applying current changeset to IEFFECTDB. Recreating functions & procedures... DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. DB20000I THE SQL COMMAND COMPLETED SUCCESSFULLY. Updating the database with /i-effect/V2R8M0 jdbc:as400://localhost/IEFFECTDB IEFFECT28 IEFFECTDB /i-effect/V2R8M0/BASE/database/c hangesets/master.xml *************************************************************************************** *** Nothing changed. *** Repaired: TARGET DB device: *SYSBAS TARGET DB catalog: K009777T TARGET DB schema: IEFFECTDB TARGET DB schema path: /QSYS.LIB/IEFFECTDB.LIB TARGET URL: jdbc:as400://localhost/IEFFECTDB *************************************************************************************** Checking product installation... Restore finished successfully The log file /tmp/YYYYMMDD-restore.log contains the extended log for this restore. --- version: "latest" language: "en" --- # SQLSTATE\[HY000\] SQLDriverConnect:30137 ## Problem When logging into WebControl, an error message appears ![image2021-4-21_15-45-10.png](https://manual.i-effect.com/__attachments/a_858a1518a3f9218c228f14d043f749cd80178c65fa4d57e322e1259d8c234b90/image2021-4-21_15-45-10.png?cb=1fd314ac17bfda0c402c4c1b936c336f) ## Solution This problem is still pending. As soon as a solution is known it will be published here ## Related articles ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Subsystem jobs do not start; java.lang.UnsupportedClassVersionError ## Problem This message indicates that the JAVA version does not match the JAVA version with which the i-effect programs were compiled. Probably there is a JAVA_HOME environment variable pointing to an older JAVA version. ## Solution To solve this, a new environment variable must be set for i-effect that points to the correct JVM version. ADDENVVAR ENVVAR('IEFFECT_JAVA_HOME') VALUE('/QOpenSys/QIBM/ProdData/JavaVM/jdk626/32bit') After logging off and logging on again, the subsystem can be started successfully. ## Related articles ### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. --- version: "latest" language: "en" --- # Subsystems do not start. Socket Connect Error ## Problem The subsystems cannot be started. A socket connect error is issued. ## Solution It should be checked whether it is possible to connect to the HostServers from the outside. ### Check HostServer To do this, issue the following command on a PC with IBM Access Client installed C:\>cwbping 10.206.2.1 The generated log contains information about connection problems BM i Access für Windows Version 7 Release 1 Stufe 0 Programm zum Überprüfen von Verbindungen (64-Bit) (C) Copyright IBM Corporation and Others 1984, 2010. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Licensed Materials - Property of IBM You can cancel the CWBPING request with the CTRL-C or CTRL-UNTBR key combination I - Connection to system 10.206.2.1 is checked... I - connection to server application Central Client has been established successfully I - connection to server application network file was established successfully I - connection to server application network printing was established successfully I - connection to server application data access was established successfully I - connection to server application data queues was successfully established I - connection to server application remote command was established successfully I - connection to server application security was established successfully F - CWBCO1003 - sockets error, connect() function returned 10060 F - CWBCO1048 - firewall blocking or timeout while trying to connect to IBM i F - CWBCO1008 - unable to connect to server application DDM, function returned 10060 I - connection to server application Telnet was successfully established W - CWBCO1015 - connection to system 10.206.2.1 checked, but warnings present ### Check local connection Enter the following command in a QSH session java -cp /QIBM/ProdData/OS400/jt400/lib/jt400.jar utilities.JPing localhost The results of the test are displayed on the console Verifying connections to system localhost... Successfully connected to server application: as-file Successfully connected to server application: as-netprt Successfully connected to server application: as-rmtcmd Successfully connected to server application: as-dtaq Successfully connected to server application: as-database Successfully connected to server application: as-ddm Successfully connected to server application: as-central Successfully connected to server application: as-signon Connection verified ### Solution The reason may be an incorrect configuration of the local or remote DNS server, which resolves "localhost" to an incorrect IP address. Additionally, the DNS server search order may be configured to \*REMOTE instead of \*LOCAL. ### Related articles Related articles appear here based on the keywords you select. Click to edit the macro and add or change keywords. #### Nach Stichwort filtern Derzeit gibt es keine Elemente mit den ausgewählten Stichwörtern. [Next Page](https://manual.i-effect.com/llms-full.txt/1)