Toolmaker Produkt-Dokumentation
Grundeinstellungen
Inhaltsübersicht
Für RPGWX sind einige Grundeinstellungen vorzunehmen.
System
Unter RPGWX, Einstellungen, System werden die Grundeinstellungen vorgenommen.
Die Einstellungen werden in folgende Bereiche unterteilt: Allgemein, Adressangaben, E-Mail, Spool Konvertierung, Lizenzen, directdial
Reiter Allgemein
Hier sind allgemeine Systemeinstellungen vorzunehmen.
"Weitere Informationen im Wiki" - rechts oben - Link auf diese Seite im Wiki
Produktbibliothek
Die Produktbibliothek wird bei der Installation angelegt.
Hinweis: Die JDBC-Treiber für Java stehen in /Toolmaker/libs/java. Somit kann die JDBC-Technik auch in anderen Produkten als nur RPGWX eingesetzt werden.
IFS Pfad
Der IFS Pfad lautet standardmäßig /Toolmaker/DirectWeb.
URL zum RPGWX HTTP Server - IP-Adresse oder -Namen der IBM i plus Port angeben.
Diese Adresse wird von den Benutzern verwendet, um sich bei RPGWX auf der IBM i anzumelden.
Bei einer "normalen" HTTP-Verbindung ist der Port standardmässig 8888, kann aber mit dem Befehl CFGDIRWEB auf der IBM i geändert werden.
z.B. "http://deacme01:8888"
https://deacme02
directmedia zur URL-Anzeige verwenden - Für die directarchiv-Befehle DSPARC, DSPARCDOC bzw. DSPGLOLKN
Aktiv: Zum Aufruf von Dokumenten des Browser muss
- auf der IBM i das Produkt directmedia verfügbar sein
- auf dem Client die Client-Komponente von directmedia installiert sein
Nicht aktiv: Der Aufruf erfolgt durch STRPCCMD, der Teil des Betriebssystems ist
Benutzer automatisch registrieren
Jeder Benutzer der sich an RPGWX anmelden möchte, muss registriert sein. Bei Aktivierung kann sich jeder anmelden, der eine gültige Benutzerkennung an der IBM i hat.
Benutzer bei entfernter Anmeldung automatisch registrieren
Bei Aktivierung wird der Benutzer der sich an RPGWX entfernt anmeldet, automatisch für RPGWX registriert.
Standard Benutzer
Als Standard Benutzer können alle registrierten Benutzer der IBM i ausgewählt werden => Default Benutzer.
Sprache
Als Sprache wird standardmäßig die Systemsprache angezeigt. Alternativ können andere Sprachen, die am IBM i System installiert sind, ausgewählt werden.
Übersetzungsvorlagen automatisch erstellen
Bei Aktivierung werden Texte, die für diese Funktion vorgesehen sind, automatisch in der Tabelle registriert. D.h. es muss dann nur noch die Übersetzung der Textkonstanten ergänzt werden.
Felder, die für diese Funktion aktiviert sind, werden mit dem Symbol gekennzeichnet. In der Regel sind das Beschreibungstexte von Definitionen, Archiven, Indizes etc.
Beispiel:
Skin - Darstellung steuern
Mit Skins kann die Darstellung der RPGWX-Browserseiten gesteuert werden:
- Rahmen
- Schriftarten
Es werden fünf verschiedene Skins mitgeliefert.
Sitzungs-Timeout - Sitzungs-Timeout in Minuten
Anzahl von Minuten, die ein Benutzer keine Mausklicks durchführt, bevor die Sitzung deaktiviert wird.
Standardwert
120 Minuten
Gültige Werte
1 - 9999 Mintuen
Maximale Versuche/Benutzer - Maximale Anmeldeversuche
Anzahl der erfolglosen Versuche zur Anmeldung für einen Benutzer.
Wenn diese Zahl überschritten wird, dann wird das Benutzerprofil gesperrt, wie es im Parameter Benutzer sperren angegeben ist.
Standardwert
5
Gültige Werte
1 - 999
Benutzer sperren - Dauer der Sperre nach n erfolglosen Anmeldeversuchen in Minuten
Wenn die Anzahl der maximalen Anmeldeversuche (vorheriger Parameter) überschritten wurde, dann wird dieses Benutzerprofil für eine bestimmte Zeit gesperrt und kann sich nicht anmelden.
Standardwert
60 Minuten
Gültige Werte
1 - 99999 Minuten
Maximale Versuche/IP-Adresse - Maximale Versuche
Anzahl der erfolglosen Versuche zur Anmeldung für einen TCP/IP-Adresse.
Wenn diese Zahl überschritten wird, dann wird die TCP/IP-Adresse gesperrt, wie es im Parameter IP-Adresse sperren angegeben ist.
Standardwert
10
Gültige Werte
1 - 999
IP Adresse sperren - Dauer der Sperre nach n erfolglosen Anmeldeversuchen in Minuten
Wenn die Anzahl der maximalen Anmeldeversuche (vorheriger Parameter) überschritten wurde, dann wird dieses Benutzerprofil für eine bestimmte Zeit gesperrt und kann sich nicht anmelden.
Standardwert
60 Minuten
Gültige Werte
1 - 99999 Minuten
EIM DN (cn=administrator) - Kerberos Anmeldung
EIM = Enterprise Identy Mapping ist ein Service der IBM i, der eine Umsetzung von IBM i Benutzer-IDs nach Kerberos Benutzer IDs erlaubt.
EIM Kennwort - Kennwort für Kerberos-Anmeldung
Der EIM Service benötigt eine Anmeldung. Diese wird in diesen Parametern angegeben.
Reiter Adressangaben
Mit den Angaben in diesem Reiter wird die Darstellung des Adresskopfes gesteuert.
Der Adresskopf ist ein Balken, der im Anmelde-Bildschirm oberhalb der Eingabefelder für Benutzerprofil und Kennwort angezeigt wird.
Dieser Adresskopf ist mit folgenden Parametern änderbar:
Firmenname - Eingabe des Firmennamens (max. 60 Zeichen). Diese Eingabe ist eine Pflichteingabe.
Straße - Eingabe der Straße (max. 60 Zeichen).
Ort - Eingabe des Ortes (max. 60 Zeichen)
Telefon - Kommunikationszeile 1
Hier kann z.B. eine E-Mail-Adresse oder ähnliches hinterlegt werden. Das System schreibt NICHT automatisch irgendetwas vor den Inhalt dieses Feldes, wenn also z.B. "E-Mail:" dort stehen soll, muss es hier mit eingegeben werden.
Es stehen max. 60 Stellen zur Verfügung
E-Mail - Kommunikationszeile 2
Hier kann z.B. eine E-Mail-Adresse oder ähnliches hinterlegt werden. Das System schreibt NICHT automatisch irgendetwas vor den Inhalt dieses Feldes, wenn also z.B. "E-Mail:" dort stehen soll, muss es hier mit eingegeben werden.
Es stehen max. 60 Stellen zur Verfügung
Kopfgrafik - Die Kopfgrafik (z.B. Firmenlogo) kann hier eingebunden werden
Die Kopfgrafiken werden unter /Toolmaker/DirectWeb/htdocs/icons abgelegt.
Hintergrundfarbe des Seitenkopfes - Die Hintergrundfarbe des Seitenkopfes ist fest codierbar
Sie wird in HTML-Farbcodes angegeben. Weitere Informationen dazu finden Sie auf der Seite Farben in RPGWX.
Schriftfarbe des Seitenkopfes - Die Schriftfarbe des Seitenkopfes ist fest codierbar
Sie wird in HTML-Farbcodes angegeben. Weitere Informationen dazu finden Sie auf der Seite Farben in RPGWX.
Anzeigenlayout änderbar - Mit diesem Parameter wird gesteuert, ob das Anzeigenlayout änderbar ist oder nicht
Bei Aktivierung werden die schmalen Balken zum Ändern der Panels breiter bzw. sind vorhanden.
Hinweis: Die Performance der Anzeige wird durch diesen Parameter erheblich beeinflusst, da mehr JavaScript ausgeführt werden muss. Es ist empfehlenswert, das Anzeigenlayout nicht änderbar zu machen, falls dies nicht erforderlich ist. Die Anzeige ist mit dieser Funktion um einiges langsamer.
Adresskopf verbergen - Mit diesem Parameter wird gesteuert, ob der Adresskopf angezeigt wird oder nicht
Wenn er aktiv ist, dann werden im Anmeldebildschirm lediglich zwei Felder angezeigt: Benutzerprofil und Kennwort.
Reiter E-Mail
Fehlermeldungen beim Archivieren von Dokumente können an ein E-Mail System angebunden und auch automatisch versendet werden.
- Wenn das Toolmaker-Produkt directmail installiert ist, dann kann eine directmail-Mailbox für den Versand verwendet werden.
- Wenn directmail nicht verfügbar ist, dann kann RPGWX selbst mit einem SMTP-Server kommunizieren
Status des E-Mail-Dienstes - Job DIRWEBEML aktiv oder nicht
Der E-Mail-Dienst wird im Regelfall automatisch mit dem Befehl STRDIRMAIL
gestartet. Wenn er aktiv ist, dann ist auf dem System IBM i ein Job mit dem Namen DIRWEBEML aktiv.
Hier wird angezeigt, ob er aktiv ist, oder nicht.
grün: der Job ist aktiv
rot: der Job ist nicht aktiv
E-Mail-System - Zum Senden von Mails verwendetes System
Als Email System stehen "SMTP" bzw. "directmail Mailbox" zur Auswahl.
Je nach dem gewählten System werden im weiteren unterschiedliche Parameter angezeigt.
Angaben beim Versand über eine directmail - Mailbox
directmail Mailbox - Name einer Mailbox von directmail
Wenn das Produkt directmail installiert ist, dann kann hier eine Mailbox dieses Produktes (WRKMBX
) ausgewählt werden.
Beim Senden von Mails verwendet RPGWX dann die Funktionen von directmail. Eigene Angaben zu SMTP-Server, etc. sind nicht erforderlich. Es werden die in directmail konfigurierten Werte verwendet.
Angaben bei dem Versand direkt über SMTP
E-Mail-Absendername - Klarname des Absenders
Zur eindeutigen Identifizierung des Email Absenders ist empfohlen RPGWX anzugeben. Es kann hier jederzeit ein anderer gültiger Email Absender Name eingetragen werden.
E-Mail-Absenderadresse - E-Mail-Adresse des Absenders
Zur eindeutigen Identifizierung der Email Absender Adresse ist hier die komplette Adresse einzutragen.
SMTP Server - Name oder IP-Adresse des SMTP Servers.
TCP/IP Port für SMTP - Port, über den der RPGWX-SMTP-Client mit dem SMTP-Server kommunizieren soll
Der Wert dieses Parameters muss mit dem Verwalter des SMTP-Servers abgestimmt werden
Gültige Werte
25 - bei Kommunikation ohne SSL
465 - bei Kommunikation mit SSL
587 - bei Kommunikation mit TLS/STARTTLS
<anderer Wert> - in Abstimmung mit dem Betreiber es SMTP-Servers
SSL verwenden - Soll SSL verwendet werden
Der Wert dieses Parameters muss mit dem Verwalter des SMTP-Servers abgestimmt werden
SMTP Server Timeout - Zeit in Sekunden, die der SMTP-Client auf eine Antwort vom SMTP Server wartet
SMTP Authentifizierung - Anmeldeverfahren beim SMTP-Server
Einige SMTP Server erfordern eine Authentifizierung vor dem Versand von E-Mails. Dies kann hier aktiviert werden.
Der Wert dieses Parameters muss mit dem Verwalter des SMTP-Servers abgestimmt werden
Gültige Werte für diesen Parameter:
Keine Authentifizierung- Keine Authentifizierung notwendig
LOGIN Verfahren - Login (unverschlüsselt)
Verfahren automatisch ermitteln - Automatische Erkennung (unverschlüsselt)
PLAIN Verfahren - Login (unverschlüsselt)
CRAM MD5 Verfahren - verschlüsselt
Schlund Verfahren - Plain mit Password (unverschlüsselt)
SMTP Benutzer - Benutzerprofil für die Anmeldung beim SMTP-Server
Der Wert dieses Parameters muss mit dem Verwalter des SMTP-Servers abgestimmt werden
SMTP Kennwort- Kennwort des SMTP-Benutzerprofils für die Anmeldung beim SMTP-Server
Der Wert dieses Parameters muss mit dem Verwalter des SMTP-Servers abgestimmt werden
Trace aktiviert - Traces schreiben
Bei Aktivierung erfolgt das Mitschreiben eines Traces. Der Trace wird im IFS in /Toolmaker/DirectWEB/Debug abgelegt.
Er enthält Informationen über
- die SMTP-Kommunikation mit Mail-Servern
- Detailinformationen über angeforderte URL's der jeweiligen Sitzungen
- den Ablauf jedes einzelnen E-Mail-Sendevorganges
Keine automatische Bereingung der Traces
Eine automatische Bereinigung des Debug-Verzeichnisses erfolgt nicht. Der Trace sollte deshalb nur für Analysezwecke eingeschaltet und dann auch wieder ausgeschaltet werden.
Reiter Spool Konvertierung
Anwendung zur Spoolkonvertierung - Auswahl der zu verwendenden Software
In der mitgelieferten RPGWX-App "IBM i" ist es möglich, Spoolausgaben auf dem PC anzuzeigen.
Die Konvertierung in ein auf dem PC anzeigbares Format kann mit verschiedenen Produkten durchgeführt werden:
Mögliche Auswahlen
RPGWX selbst ("DirectWeb")
directmail, wenn es auf der IBM i installiert ist
directview, wenn es auf der IBM i installiert ist
Gumbo Spool-a-matic, wenn es auf der IBM i installiert ist
Anwendung zur Spoolkonvertierung - Welche Anwendung soll zur Spoolkonvertierung verwendet werden
Wenn neben RPGWX noch andere Produkte auf der IBM i installiert sind, mit denen eine Konvertierung von SPLF in PC-Formate möglich ist, dann werden diese hier zur Auswahl angeboten
Gültige Werte sind:
directweb Die Spoolkonvertierung findet in RPGWX statt, d.h. die Anzeige der Druckausgabe erfolgt als HTML.
directmail - wenn auf der IBM i installiert - die Spoolkonvertierung findet in directmail statt und es kann zusätzlich noch das Ausgabeformat angegeben werden
directview - wenn auf der IBM i installiert - die Spoolkonvertierung findet in directview statt und es kann zusätzlich noch das Ausgabeformat angegeben werden
Gumbo Spool-A-Matic - wenn auf der IBM i installiert - die Spoolkonvertierung findet mit dem Produkt Gumbo SPLAMATIC statt.
Wird die Anzeige auf "DirectWeb" gestellt, so erfolgt die Anzeige der Druckausgabe als HTML.
Bei der Auswahl von "directmail" stehen noch weitere Ausgabeformate zur Verfügung, die in der Option "Format für Spoolanzeige" ausgewählt werden können.
Format für Spoolanzeige - Auswahl eines PC-Ausgabeformates
Nur verfügbar, wenn als "Anwendung zur Spoolkonvertierung" (vorherige Option) directmail gewählt ist.
Es werden verschiedene PC-Formate angeboten, in die die IBM i SPLF konvertiert werden können.
Grüne Balken anzeigen - Der besseren Lesbarkeit halber können grüne Balken hinterlegt werden.
Seitentabelle anzeigen - Bei Aktivierung wird die Seitentabelle mit angezeigt.
„No print area" für Briefversand -
Bei Aktivierung wird bei Briefversand der nicht bedruckbare Bereich bei der Skalierung berücksichtigt und nicht bedruckt. Somit wird verhindert, dass wichtige Dokumentinformationen überschrieben werden können (z.B. Informationen wie „Geschäftsführer")
Schriftart - Auswahl einer Schriftart
Nur verfügbar, wenn als "Anwendung zur Spoolkonvertierung" (vorherige Option) directweb gewählt ist.
Schriftgrösse - Grösse der Schrift
Nur verfügbar, wenn als "Anwendung zur Spoolkonvertierung" (vorherige Option) directweb gewählt ist.
Reiter Lizenzen
RPGWX nutzt für verschiedenen Funktionen Produkte anderer Hersteller, die z.T. lizenziert werden müssen:
Cryptlib:
- Verschüsseln von E-Mails, die mit directmail versendet werden
- Verschüsseln von E-Mails, die mit directfax versendet werden
- Verschlüsseltes Archivieren von Dokumenten
TETLib:
- Extraktion von Texten aus PDF-Dateien
In diesem Register können die entsprechenden Lizenzkeys eingetragen werden.
CryptLib Lizenzkey - Eingabe des Lizenzschlüssels der CryptLib.
Lizenzschlüssel für die Crypto APIs. Dieser Lizenzschlüssel ist bei Toolmaker anzufordern.
TETLib Lizenzkey - Eingabe des TETLib Lizenzschlüssel.
Lizenzschlüssel für die Text Extraction Tools (TET) - Lib. Dieser Lizenzschlüssel ist bei Toolmaker anzufordern.
Reiter directdial
Landesvorwahl
Als Land wird eingetragen, in dem die IBM i steht.
Bei der Telefonie-Integration über directdial werden Wird beim Wählen die Landesvorwahl (z.B. 0049 oder +49) weggelassen, wenn der Anruf national ist.
Ortsvorwahl - Ort, an dem die IBM i steht
Bei der Telefonie-Integration über directdial werden Wird beim Wählen die Ortsvorwahl weggelassen, wenn der Anruf innerhalb desselben Ortsnetzes ist.