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"


Bei einer SSL-Verbindung (HTTPS) darf kein Port angegeben werden.
z.B. https://deacme02
Weitere Informationen zum Einrichten von SSL für RPGWX finden Sie auf der Seite IBM i - Wichtige Informationen rund um das Betriebssytem - Konfiguration von SSL, TLS und HTTPS.

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.

E-Mail-Protokoll anzeigen



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.