Grundlegende Information

Aktuelle Version

Installationsvoraussetzungen

• IBM i V7R1 mit Option 39 - "International Components for Unicode"  - Weitere Informationen zu Option 39 finden Sie hier
• Toolmaker Installation Manager (TIM) - Weitere Information zu TIM finden Sie hier
• Toolmaker WOPiXX Version 2.34 - Weitere Informationen zu WOPiXX finden Sie hier
  
  
• Für das Versenden und Empfangen von E-Mails muss Ihr System IBM i mit einem Mailserver (SMTP und/oder POP) verbunden werden. Das kann sein
  • ein interner Mailserver (z.B. ein Exchangeserver) in Ihrem LAN
  • ein Mailserver bei einem Provider (Telekom, vodafone, 1&1, etc.)

Die bei Ihnen installierte Version können sie ermitteln:

Software-Downloads

Aktuelle Version

Installation

Erst-Installation

Die Installation erfolgt über den Toolmaker Installation Manager (TIM)

• Der Auftrag lautet INSTALL_PRODUCT
• Als Produkt ist anzugeben: DIRMAIL

Aktualisierung

Die Aktualisierung des Produktes läuft auch über den Toolmaker Installation Manager (TIM).

Dabei gibt es zwei Varianten:

• den Versions-Update
• den PTF-Update

Welche Art des Updates auszuführen ist, ergibt sich aus den Versionsnummern von / nach: die Versionsnummern von directmail (sowie directspool, directview und pdfenhancer) bestehen aus drei Teilen:

Version, Release, PTF-level. Zum Beispiel: 5.60.13.

Versions-update

Änderungen in den ersten beiden Teilen der Versionsnummer werden als "Versions-update" bezeichnet. Der PTF-level ist hier egal.

Zum Beispiel

• 5.50.xx → 5.51.yy = Versionsupdate
• 5.51.xx → 5.60.xx = Versionsupdate

Neue Versionen werden auch mit dem Befehl INSTALL_PRODUCT für das Produkt DIRMAIL installiert.

PTF-update

Wenn sich nur der dritte Teil der Versionsnummer ändert, dann ist es ein "PTF-update":

• 5.50.07 → 5.50.08 = PTF-update

PTFs werden mit dem Befehl INSTALL_PTF für das Produkt DIRMAIL installiert.

PTF-updates sind kumulativ, man kann also immer das höchste PTF für die installierte Version nehmen.

Spool-a-Matic (2A55SAM)

Das Produkt Spool-a-Matic wird auf demselben Wege aktualisiert, wie zur Installation. Siehe: Installation Spool-a-Matic.

IBM i - Releasewechsel oder dem Wechsel auf ein neues IBM i - System

Nach einem Releasewechsel des IBM i - Betriebssystems oder nach dem Wechsel auf ein neues IBM i - System sind die folgenden Schritte durchzuführen:

Schritte nach einem IBM i Releasewechsel oder Wechsel der IBM i Hardware

Bei Wechsel der IBM i Hardware: Lizenz für das Produkt Spool-A-Matic (2A55SAM) erneuern, wenn installiert

Bibliotheken und IFS-Verzeichnisse (bei der Datensicherung berücksichtigen)

Daten von directmail werden sowohl in native IBM i-Dateien in der Bibliothek, als auch im integrierten Dateisystem der IBM i, dem IFS abgelegt. Folgende Strukturen werden innerhalb des IFS für directmail/400 benutzt:

Bibliotheken auf IBM i

• DIRMAIL

IFS-Verzeichnis auf IBM i

Das Root Verzeichnis für directmail befindet sich im IFS der IBM i und heisst standardmässig /Toolmaker/DirectMail400. Es kann über CFGDIRMAIL, Parameter MAILPATH geändert werden.

Das Root-Verzeichnis enthält die folgenden Unterverzeichnisse:

../Debug - Trace-Dateien von SMTP, POP und directspool(Automail), wenn im Befehl CFGDIRMAIL der Parameter TRACE(*YES) gesetzt ist.

../Certs- Ablageverzeichnis für digitale Zertifikate

../Fonts- Fonts für Unicode PDF-Konvertierung

../Forms- Formularvorlagen für directmail ("der Formular-Ordner")

../Graphics - Speicherung von Grafikdaten

../Mailboxes - Gespeicherte E-Mails im .eml-Format für die Anzeige mit DirectMedia

../Sent - Gesendete E-Mail Dateien im Mime format

../Received - Gesendete E-Mail Dateien im Mime format

../Temp - Temporäre directmail Dateien

../Temp/Automail - Temporäre Dateien für Automail

../Temp/Convert - Temporäre Dateien für Konvertierungen

../Temp/MimeSnd - Temporäre MIME Dateien für Versand

../Temp/MimeRcv - Temporäre MIME Dateien für Empfang

Sowie natürlich die Bibliotheken und Verzeichnisse von WOPiXX.

Weitere Dokumentation zu directmail

Das aktuelle Handbuch zu directmail finden Sie auf dieser Seite: Weitere Dokumentation zu directmail.

Fehlersuche und -behebung für directmail

Informationen hierzu finden Sie auf dieser Seite: Fehlersuche und -behebung für directmail.

Versionen und Kompatibilität

directmail / directspool / directview / pdfenhancer

SplAmatic

Das Produkt SplAmatic der Firma Gumbo Software, das unter bestimmten Bedingungen in directspool "embedded" ist, ist mit allen IBM i Version ab V7R1 und später kompatibel, auch mit V7R5.

Weitere Informationen auf der Webseite des Herstelliers: https://www.gumbo.com/KnowledgeBase/LicpgmFaq.html

Schritte nach einem IBM i Releasewechsel oder Wechsel der IBM i Hardware

Nach einem Releasewechsel müssen 2 Schritte gemacht werden, um die Verbindung des Produkts mit Objekten in IBM Bibliotheken wiederherzustellen.

1. Befehle in QSYS/QUSRSYS bereitstellen:
   ADDLIBLE DIRMAIL
CHGDMLLNG F4
Sprache wählen, z. B. DEU
Enter
2. Konfiguration fahren:
   CFGDIRMAIL F4 und Enter

Diese Reihenfolge ist unbedingt einzuhalten.

Darauf achten, dass nach jedem IPL das Subsystem DIRMAIL gestartet wird:

1. ADDLIBLE DIRMAIL
2. STRDIRMAIL (oder STREMLMON)
3. wenn der IFS-Monitor in Verwendung ist: STRMAILIFS

Bei Wechsel der IBM i Hardware: Lizenz für das Produkt Spool-A-Matic (2A55SAM) erneuern, wenn installiert

Wenn die Option "AFP-SPOOL-Umwandlung (Gumbo SPOOL-A-MATIC)" installiert ist, dann ist für dieses Produkt auch die Lizenz zu erneuern.

Das Produkt hat eine Karenzzeit von 30 Tagen, wird also 30 Tage lang nach dem Maschinenwechsel noch laufen, dann aber mit einem Lizenzfehler enden.

Bitte prüfen, ob die Software installiert ist:

1. GO LICPGM, Auswahl 10, F11
2. Vorwärtsblättern: erscheint das Liizenzprogramm "2A55SAM"?

Wenn ja, dann bitte ein E-Mail mit der Angabe des installierten Releases schicken an licenses@toolmaker.de!

Hinweis: Die Lizenz für Spool-A-Matic ist nicht in den Toolmaker-Lizenzdateien enthalten, sondern  muss mit den Befehlen ADDLIBLE SPLAMATIC, CHGSAMAUT AUT(...) eingegeben werden. Das E-Mail mit der Lizenz enthält diese Befehle auch.

Hinweise zur Lizenzierung

directmail ist in verschiedenen Ausbaustufen mit mehr oder weniger Funktionalität einsetzbar. Die Funktionalität wird über Lizenzmodelle realisiert. Durch Eingabe der entsprechenden Lizenz wird die Funktion freigeschaltet.

Nach der Erstinstallation kann directmail für maximal 30 Tage ohne Lizenzierung getestet werden.Weitere Information dazu finden Sie auf der Seite Lizenzdatei.

Aktive Lizenzen und Optionen anzeigen

Welche Lizenzen und Optionen auf Ihrem System aktiv sind wird mit diesen Befehlen angezeigt:

ADDLIBLE DIRMAIL
DSPLICINFO *FULL  (ab Version 5. In vorhergehenden Versionen hiess der Befehl "DSPLICINF")


API zur Nutzung der Batch- und SPL-APIs: Aufruf von Funktionen sowie zum Erstellen von E-Mails direkt aus Ihren Anwendungen heraus

ARCH  Archiv-Schnittstelle

ATM Automail (bzw. Spoolmail)

BASE Lizenz für die kostengünstige Grundversion mit eingeschränktem Funktionsumfang

BCD ELP Barcodes

CRY Ermöglicht die Verschlüsselung ausgehender E-Mails nach dem SMIME-Standard sowie die Verschlüsselung von PDF-Dateien.

CVT Konvertzierung von SCS-Spooldateien, Datenbankkdateien in TXT,HTML,PDF,EPDF,CSV,TIFF

DIST Lizenz zur Freischaltung des E-Mail Eingangsasisstenten bei BASE

DSP Anzeige von E-Mails über den PC mit directview

EML Vollversion ohne Begrenzung der Mailboxen. Zu EML gehört auch der E-Mail-Eingangsassistent (Option DIST)

IFS Unterstützung IFS-Monitor.

LIT Lizenz nur zum Versenden von E-Mails mit nur 1 (eine) Mailbox (Lite-Version)

MBX Lizenz zur Steuerung weiterer Mailboxen bei der BASE Version

MDT

OBJ Lizenz zur Steuerung von Befehl SNDOBJEML, wenn keine APIs vorhanden sind

OVL

PCL Konvertieren von PCL5-Spooldateien

PDA

XML  Append - XML-Datei an PDF-Datei anhängen

XMR  Retrieve - Auswertung von PDF/A-3 Dateien mit XML Daten (FeRD)

Verfügbare Features (Optionen) für directmail

Directmail wird in 3 verschiedenen Basisversionen lizenziert:

• Vollversion mit allen Grund-Features
• BASE - Version mit eingeschränkter Funktion
• LITE - nur eine Mailbox

Zu diesen Basisversionen können Sie je nach Bedarf verschiedene Optionen lizenzieren:

Lizenzierung von integrierten Produkten anderer Hersteller

SplAmatic - Umwandeln von AFPDS/IPDS-SPLF

Der Hersteller liefert einen Lizenzkey, der mit diesen Befehlen einzugeben ist:

1. ADDLIBLE SPLAMATIC
2. CHGSAMAUT

Der Lizenzkey ist abhängig von der SplAmatic-Version. Diese muss also beim Anfordern der Lizenz bekannt gegeben werden und nach einem SplAmatic-Versionswechsel aktualisiert werden.

• Ermitteln der SplAmatic-Version: GO LICPGM, Auswahl 10, F11, Blättern bis zum Produkt 2A55SAM

Option CRY - Kryptographie mit Cryptlib

Der Hersteller liefert einen Key, der auf der letzten Seite des Befehls CFGDIRMAIL, im Parameter CRYPTLIC einzugeben ist.

PDFLIB

Der Hersteller liefert einen Key, der auf der letzten Seite des Befehls CFGDIRMAIL, im Parameter PDFLIBLIC einzugeben ist.

Deinstallation der IBM i-Software

Wollen Sie directmail auf Ihrem System nicht länger nutzen, müssen Sie zunächst alle Aktivitäten mit directmail einstellen.

Falls Sie den Bibliotheksnamen DIRMAIL in Jobbeschreibungen (JOBD) oder Systemwerten (z.B. QUSRLIBL) eingegeben haben, ist er dort zu entfernen.

Danach melden Sie sich ab und als QSECOFR wieder an. Mit dem folgenden Befehlen

ADDLIBLE DIRMAIL
ENDSBS DIRMAIL
RMVDML

wird das Löschen der im System befindlichen directmail Objekte und der Bibliothek DIRMAIL gestartet.

Das Löschen ist nur erfolgreich, wenn kein Job die Bibliothek DIRMAIL benutzt (Menü zuvor verlassen!).

Backup, Spiegelung und Hochverfügbarkeit - bitte beachten

Kurzzeitige Sperren im IFS

Bitte beachten Sie, dass es während Ihrer Datensicherung kurzzeitig zu Sperren an Dateien in DIRMAIL und im IFS kommt. Dies kann zu Fehlern bei der Ausführung von Programmen führen. Es wird daher empfohlen, die Aktivitäten von directmail vor der Datensicherung zu beenden und hinterher wieder zu starten (ENDEMLMON, STREMLMON).

Lizenzcodesicherung bei Hochverfügbarkeit, Spiegelung

Die Zertifikatsdatei (z.B. License_DIRMAIL_05_65481XX.txt) wird IFS-Verzeichnis  /Toolmaker Ihrer IBM i gespeichert. Da der Dateiname die Serien-Nr. des zugehörigen Systems enthält, ist hier bei der Spiegelung keine besondere Maßnahme erforderlich. Die Lizenzdateien der Produktions- und Backupmaschine können in das selbe Verzeichnis /Toolmaker gestellt werden.

Arbeitsdaten von directmail im IFS

Das IFS-Verzeichnis /Toolmaker/DirectMail400 enthält je nach Konfiguration und Ihren Nutzungsgewohnheiten ebenfalls wichtige directmail Daten. Bitte berücksichtigen Sie dies bei Ihrer täglichen Datensicherung.