/
Neuerungen directmail/directspool/pdfenhancer

Toolmaker Produkt-Dokumentation

Neuerungen directmail/directspool/pdfenhancer

Inhaltsübersicht

 

Dieses Kapitel beschreibt für jede Version die jeweiligen Erweiterungen, Fehlerkorrekturen und Nachbesserungen, sowie die Inhalte der verschiedenen PTFs.

Von Version zu Version erfolgt ein update mit dem Toolmaker Installation Manager (TIM) über eine INSTALL_PRODUCT order.

Innerhalb einer Version werden zwei verschiedene Arten von PTFs zur Verfügung gestellt:

  • Kumluative PTFs (auch "reguläre PTF" genannt). Diese werden mit dem Toolmaker Installation Manager installiert. Folgen Sie dafür der Anleitung Installation von PTFs über TIM. Bitte beachten Sie evtl. zusätzliche Informationen im PTF-readme PDF Dokument für das jeweilige PTF.

  • HOTPTF. Für diese erhalten Sie von der Hotline individuelle download-links und Anleitungen.

Aktuelle Version 5.60

Funktionale Neuerungen und Korrekturen

Hintergrundfarbe in HTML-Ausgaben

Bis zu dieser Version wurde die Einstellung für den Hintergrund (CFGDIRMAIL, Parameter COLORS() ) bei bestimmten Ausgaben ignoriert.

Das betraf z.B. die Ausgabe von HTML- oder EPDF-Anhängen mit dem Befehl WRTEMLAPI. Das korrigiert, es ist aber erforderlich, die Funktion zu aktivieren, mit dem Befehl

CHGDTAARA DTAARA(DMDTAARA (1234 1)) VALUE('1')

Barcodes/QR Code

Die Länge des Textes, der als Barcode mit der directspool-Funktion ^bcd() ausgegeben werden kann wurde von 50 auf 200 Stellen verlängert.

Neue Konvertierungsbefehle für PDF: CVTPDFA und CVTADDOVL

Die Befehle CVTPDFA und CVTADDOVL wurden bezüglich der Lizenzprüfung geändert. Zu deren Nutzung müssen jetzt die Komponenten PDA bzw. OVL freigeschaltet werden. Diese Befehle funktionieren, ohne dass in DirectSpool andere Komponenten freigeschaltet sein müssen.

CVTPDFA erzeugt aus einer normalen PDF-Datei eine PDF/A Datei, welche den Ansprüchen einer Langzeit Archivierung entspricht.

CVTADDOVL fügt zu einer normalen PDF-Datei ohne Layout ein Overlay hinzu. Sollte die Ursprungs-PDF schon ein Layout enthalten, wird das alte Layout nicht ersetzt und das neue Overlay kann verdeckt (unsichtbar) sein.

Syntaxfehler in Emailadresse melden

Directspool spoolmail wurde um eine Funktion erweitert, die es erlaubt, ein E-Mail mit einer falschen Adresse in den Ausgangs-Postkorb zu stellen und dort manuell zu korrigieren.

Die Konfiguration und Anwendung dieser Funktion ist im Abschnit Fehlertoleranz für Syntaxfehler ihn E-Mail-Adressen konfigurieren auf der Seite directspool - Konfiguration beschrieben.

PTF 18 vom 19.02.2026 – Zugferd mit intelligenten Definitionen

Das PTF 18 erfordert mindestens IBM i V7R3M0

Es gab eine Vor-Version des PTF 18 im Januar 2026.

Wenn das PTF 18 vor dem 2026-02-19 bereits installiert worden ist, dann muss es ersetzt werden.

Vorgehen:

  1. GO TIM Punkt 21. Download Toolmaker Infodateien ausführen

  2. GO TIM Punkt 26. Subsystem TIM starten

  3. Die Order DIRMAIL Install PTF 056018 falls die in GO TIM 1 noch vorhanden ist, löschen.

  4. F11 REMOVE_PTFSAVF Remove old PTF save file ... (die Auswahl ist erst nach 1x Blättern sichtbar) mit 1 auswählen und so die SAVF 18 und ältere PTF SAVFs löschen.

  5. F11 INSTALL_PTF aufrufen erst DIRMAIL und dann PTF 18 auswählen

dann geht es wie bekannt normal weiter.

Erweiterungen

Felder ohne Wert aus der XML-Datei entfernen (mit XSLT)

Jan. 2026 - Pgm-DMCVTCX

Es gibt Fälle, in denen für einen Business Term in den X-Struktur Zuordnungen (F9-ZU) kein Wert gefunden wird. Wenn dieser Wert nur optional ist, ist das eigentlich kein Problem. Es gibt aber Validierungsportale, die in diesem Fall die XML-Datei zurückweisen.

Dafür wurde die die XSLT-Transformation eingeführt. Diese entfernt alle Werte aus der XML-Datei, die keinen Wert haben.

Diese Funktion ist hier beschrieben: https://toolmaker.atlassian.net/wiki/spaces/DOKU/pages/590479362/directmail+directspool+pdfenhancer+und+ZUGFeRD#XLST-Konvertierungen-der-erstellten-Zugferd-XML-Datei

APFDS-Spooled Files (Ausgabeformat *GUMBO) - Einbetten aller Fonts für ZUGFeRD-Ausgaben

Feb. 2026

Nur für directspool-(Automail)-Definitionen bei denen in F9-AF im Feld Ausgabeformat der Wert *GUMBO angegeben ist.

Die ZUGFeRD-Regeln verlangen, dass in der PDF-Datei alle Fonts eingebettet werden, die im Dokument verwendet werden. Das wird jetzt automatisch berücksichtigt.

PTF 17 vom 22.12.2025 –Korrekturen und Erweiterungen für ZUGFeRD/X-Rechnung in directspool

Das PTF 17 erfordert mindestens IBM i V7R3M0

Es gab eine Vor-Version des PTF 17 im November 2025.

Wenn das PTF 17 vor dem 2025-12-22 bereits installiert worden ist, dann muss es ersetzt werden.

Vorgehen:

  1. GO TIM Punkt 21. Download Toolmaker Infodateien ausführen

  2. GO TIM Punkt 26. Subsystem TIM starten

  3. Die Order DIRMAIL Install PTF 056017 falls die in GO TIM 1 noch vorhanden ist, löschen.

  4. F11 REMOVE_PTFSAVF Remove old PTF save file ... (die Auswahl ist erst nach 1x Blättern sichtbar) mit 1 auswählen und so die SAVF 17 und ältere PTF SAVFs löschen.

  5. F11 INSTALL_PTF aufrufen erst DIRMAIL und dann PTF 17 auswählen

dann geht es wie bekannt normal weiter.

Erweiterungen

Virtuelle Positionsnummern - wenn in der Datenbank keine Positionsnummer verfügbar ist

Juli 2025: Das Programm DMCVTXCO betreffend Zugferd und XML-Dateien (bisher als HOTPTF verfügbar) wurde zwischenzeitlich erweitert und korrigiert und in das PTF 17 übernommen.

Wenn bei Zugferd mit Ausgabe einer XML-Datei eine Rechnung verarbeitet werden soll, die keine nummerierten Postenzeilen enthält, d.h. Artikelpositionen ohne Ziffer in der linken Spalte, kann das jetzt trotzdem verarbeitet werden.

Diese Funktion ist hier beschrieben: https://toolmaker.atlassian.net/wiki/spaces/DOKU/pages/590479362/directmail+directspool+pdfenhancer+und+ZUGFeRD#Virtuelle-Positionsnummern

Korrekturen

Deutsche Sonderzeichen (ÄÖÜß) in der XML-Datei

Oktober 2025 - Pgm-DMCVTXCO

Deutsche Sonderzeichen/Umlaute ÄÖÜßäöü im Datenstrom der XML Datei werden durch Alternativen (AE, OE, ss, ae, oe, ue) ersetzt.

Zuvor wurden die Zeichen teilweise als Hieroglyphen in der XML-Datei ausgeliefert.

Falls dieses Programm ausnahmsweise unter V7R1 benötigt wird, kann ein HOTPTF geliefert werden, das auf PTF 14 basiert, ansonsten ist es im kumulativen PTF 17 auf Basis von V7R3 vorhanden.

DMATMEXC - Zeichen & in einem Indexwert

Oktober 2025 Pgm-DMATMEXC

In einer directspool-(Automail-)Definition wird das kaufmännische Und (&) als Start-Zeichen für einen Index verwendet.

Es gibt jedoch Situationen, in denen das & unverändert übernommen werden muss:

  • allein stehende & in einem Indexwert werden als Buchstaben akzeptiert

  • und eine Kombination &234 als einen normalen String (ohne Indexfunktion)

Das wird jetzt respektiert. Zuvor wurde der String ab dem & abgebrochen.

PRTPDF verwendet jetzt PDFLIB Version 10.0.3

Dezember 2025 - Pgm-DMPRTPDF, Cmd-PRTPDF

Das im Juli 2025 korrigierte Programm DMPRTPDF des Befehls PRTPDF basiert aktuell auf dem Serviceprogramm DMPDFLIBA3. Das PTF 17 musste erneut erstellt werden, da das Serviceprogramm in der Auslieferung gefehlt hat. Upload erfolgte am 19.12.25 13:10 Uhr.

Programm DMPRMPTF wurde korrigiert

2025-12-22 Pgm-DMPRMPTF
Es versorgt die Datei DMPRMCTL mit neuen (zusätzlichen) Datensätzen von Toolmaker. Der Installationsfehler bestand seit Mitte Januar 2025 in PTF 15. Das PTF 5.60.17 wurde erneut erstellt und hochgeladen.

PTF 16 vom 26.06.2025

Das PTF 16 erfordert mindestens IBM i V7R3M0

Die maximale Anzahl von Indizes in Automail- (Spoolmail-) Definitionen wurde von 200 auf 500 erhöht (2025-05-13)

Das Programm DMATMEXC wurde bezüglich der max. Anzahl von Index Einträgen von bisher DIM(200) auf DIM(500) geändert.

Grund war, dass bei Kombination von umfangreichen Steuerungen bezüglich Sprachen und großen Mengen an ZUGFeRD Einträgen insgesamt mehr als 200 Indizes auftraten.

Neuer Befehl RTVXML (2025-06-26)

Mit dem Befehl RTVXML kann man einen XML-Anhang aus einer PDF-Datei im IFS in ein IFS Verzeichnis exportieren. Es ist eine Toolmaker ZUGFeRD XMR Lizenz erforderlich.

PTF 15 vom 20.01.2025 - Erweiterungen und Korrekturen - vor allem MS365 und ZUGFeRD

Das PTF 15 erfordert mindestens IBM i V7R3M0

 

Seit 10/2022 wurden einige spezielle Erweiterungen und Korrekturen gemacht, die nur an die betroffenen Kunden als HOTPTFs ausgeliefert wurden. Diese sind jetzt hier in PTF 15 enthalten.

Bereich MS365 Emailfunktion mit XOAUTH2 Autorisierung

Hierzu bitte auch die Infos oben bei PTF 09 und den Eintrag im Toolmaker WIKI lesen. LINK:

POP mit XOAUTH - Konfiguration in MS 365 und Azure - Produktdokumentation - Confluence

  • Neuer Befehl CFGOAUTH F4 und zugehöriges CL-Programm DMOAUCFG und neues DTAARA DMOAUTH (Erstellen und Ändern erfolgt mit Befehl CFGOAUTH).

  • Erweitertes Programm DMRCVPOP (Emailempfang)

  • Erweitertes Programm DMSNDSMT (Emailversand)

  • In der Datei DMPRMCTL mit Steuerparametern wird ein Datensatz X=XOAUTH2 hinzugefügt:
    SMTPAUTTYP RC    X                    XOAUTH2 Autorisation…

Sonstige Korrekturen

Für den Bereich XRechnungen und Zugferd wurden 2 IFS-Dateien in das Verzeichnis /Toolmaker/Directmail400/Zugferd eingefügt:

  • ##ZUG22BSP.xml ist eine wichtige Layout Datei für das Erstellen von Zugferd PDF-Dokumenten. Es handelt sich um eine Vorlage, die sich eng an die Namensgebung von Zugferd hält. Sie kann als Basis verwendet werden.

  • ZUGFERD_##ZUG22BSP_INFO.XLSX ist eine Excel Datei mit einer Anleitung zur Nutzung der directmail Zugferd Funktion und basiert auf dem Layout ##ZUG22BSP.xml

Programm  DMIFSMON

Es wurde ein Fehler behoben, der sich im Browser bei der Verwaltung von definierten Monitoraufgaben zeigte. Der aktuelle, aktive Job des jeweiligen Monitors wurde immer als beendet angezeigt, unabhängig vom tatsächlichen Status des Jobs auf der IBM i.

PTF 14 vom 10.08.2021 bis 25.10.2022  -  Zahlreiche Korrekturen

Korrekturen an den Programmen DMCVTXCO und DMCVTENH um exotische Fehler abzufangen


Kurz vor und nach der Auslieferung des PTF 13 hatten sich bei einigen anderen Programmen Fehler in der Lizenzprüfung eingeschlichen, die möglicherweise auch negative Auswirkungen für die Auslieferung von HOTPTFs nach dem 05.03.21 hatten. Hier ist allerdings keine konkreter Fall bekannt.


Neue Funktion "Mailstatus Feedback an die Anwendung"

Die neue Funktion erlaubt es, den aktuellen Mailversandstatus per EXIT Programm direkt in eine kundeneigene Datenbank zu schreiben. Dadurch kann der Benutzer den Emailversand in seiner Anwendung kontrollieren.

Voraussetzung für die Nutzung ist eine Lizenz für directspool (früher Automail) oder eine Lizenz für die Batch- und Spool-APIs im Zusammenhang mit dem Versand von SPLFs als PDF-Anhang.

Es ist ein wenig Programmieraufwand zur Anpassung des EXIT Beispielprogramms beim Kunden vor Ort einzuplanen.

Weitere Informationen zu dieser Funktion stehen auf der Seite Mailstatus Feedback - Exitprogramm.

Meldung von Fehlern bei der Spooldateikonvertierung

Die automatischen, für den Benutzer nicht sichtbaren Vorgänge beim Erstellen einer Email mit einer PDF-Datei im Anhang können scheitern, wenn die zu konvertierende Spooldatei (SPLF) z.B. nicht zu finden oder leer ist, die SPLF kann auch noch im Aufbau begriffen oder von einem Benutzer bzw. einer anderen Anwendung geöffnet und blockiert sein.

Diese Art Fehler werden zwar gemeldet, aber es hängt von der Anwendung ab, ob der Fehler nur abgefangen oder auch so weitergemeldet wird, dass eine geschulte Person sie erhält und weiß, was zu tun ist.

Das Produkt wurde jetzt im Zusammenhang mit dem Feedback des Mailstatus an die Anwendung so erweitert, dass der Kunde die Kontrolle behält, d.h. die Email nicht ohne Anhang versendet wird.

Das PDF Dokument aus dem obigen Link enthält auch zu dieser Erweiterung eine genaue Beschreibung (erkennbar ist der Abschnitt an der identischen Überschrift).

&INDEX bei OUTQ Namen freigeschaltet (19.08.2021)

In besonderen Fällen kann jetzt in WRKATMDEF - Mit Automail Definitionen arbeiten bei der Angabe von OUTQ Namen eine Indexvariable angegeben werden. Damit ergibt sich mehr Flexibilität bei der Verarbeitung und Ausgabe von Spooldateien.

Nachteil ist allerdings, dass die Existenzprüfung der OUTQ nicht mehr beim Definieren möglich ist. Der Name wird erst in der Ausführungsphase ermittelt und kann dann auch falsch sein: Im Falle der Verschiebung einer SPLF in eine andere OUTQ würde die SPLF in der bisherigen OUTQ verbleiben.

Korrekturen in der Lizenzprüfungsroutine (24.11.2021)

Einige Programme mussten neu umgewandelt werden, da sich in der Lizenzprüfung etwas geändert hatte.

Das PTF 14 wurde aktualisiert.

Performanceproblem beim Versand (08.12.2021)

Bei der Konfiguration von mehr als einem Email Sendejob konnte es dazu kommen, dass sich die Programme gegenseitig behindert haben. Das Programm DMSNDITM wurde korrigiert.

Das PTF 14 aktualisiert.

Div. kleinere Korrekturen aus HOTPTFs (23.06.2022)

  • 14.03.2022 DMDSPSPL Recompiled / LIC-Problem

  • 28.04.2022 DMCVTXCO SQL Cursor Problem behoben

  • 19.05.2022 DMPRTATMSP Feld JOBID prüfen statt SHFIL)

  • 07.06.2022 DMATMEXC QTEMP/DMTARA Parallel Processing Fehler

Das PTF 14 wurde aktualisiert.

Div. kleinere Korrekturen aus HOTPTFs (22.07.2022)

  • 05.07.2022 CVTADDOVL+DMADDOVL Parameter Rotation hinzu

  • 12.07.2022 DMSTRPGM+DMWRKMON Restart Work Monitor DMATMxx

Das PTF 14 wurde aktualisiert.

Weitere Korrekturen (07.10.2022)

Das directmail Reorganisationsprogramm DMRGZ wurde korrigiert, weil bisher trotz richtiger Konfiguration der folgenden Parameter in CFGDIRMAIL

Uhrzeit für Reorg . . . . . . . 0100
RGZPFM bei Reorg ausführen . . . *YES
Attachments reorganisieren . . . *YES
Reorg löscht Emails permanent . *YES

einige Dateien beim automatischen Reorg in der Nacht nicht bereinigt wurden.

Bei manueller Ausführung des Befehls RGZDIRMAIL mit folgenden Parametern

RGZPFM bei Reorg ausführen . . . *YES
Attachments reorganisieren . . . *YES

werden dagegen alle Dateien berücksichtigt.

Die Funktion Mailstatus Feedback wurde so geändert, dass die Datei DMSPLMID nur dann mit Spool- und Emailinformationen gefüllt wird, wenn auch ein EXIT-Programm angegeben wurde. Grund ist, dass die Datei nach längerer Nutzung zu voll wurde und es zu unerwarteten Meldungen an QSYSOPR kam. Dies Problem ist auch im Zusammenhang mit dem zuvor beschriebenen Reorg-Thema zu sehen. Die Programme DMATMEXC und DMOPNAPI wurden korrigiert.

Das PTF 14 wurde aktualisiert.

Korrektur Lizenzprüfung und Jobs auf MSGW (18.10.2022)

Das Programm DMOPNAPI wurde wg. der geplanten Funktion 2FA bezüglich der Lizenzprüfung geändert.

Das Programm DMCHKSRV zur Prüfung der Jobaktivitäten im directmail Subsystem DIRMAIL wurde überarbeitet. Es konnte passieren, dass ein Job DMATMxx auf MSGW stehen blieb und die Befehle ENDDIRMAIL bzw. ENDEMLMON das Subsystem nur noch mit *IMMED beenden konnten. Bei Beendigung mit *CNTRLD und anschließendem STR wurden doppelte gleichnamige Jobs gestartet, die sich gegenseitig behinderten.

Das PTF 14 wurde aktualisiert.

MSGW incl. Restart (25.10.2022)

Für das Abfangen und das automatische Restarten von Jobs auf MSGW ist eine Funktion ABORTJOBONMSGW in TIM Version 02.86.91 BETA verfügbar. Dazu gibt es eine spezielle Beschreibung, die nach Rücksprache mit Woidt/Hotline zu bekommen ist.

Die oben bereits erwähnte Funktion 2FA (2-Factor-Authorization) kann die directmail Batch- und Spool-APIs zur Erstellung einer speziellen Email verwenden, ohne dass eine API-Lizenz vorhanden ist. Dabei gelten Einschränkungen bezüglich Länge von Betreff und Text auf je 20 Stellen sowie die Verwendung nur eines Empfängers. Mit WRTEMLAPI können keine Anhänge eingesteuert werden. Hierzu wurden die drei API Programme OPN-, WRT- und CLS-API nochmals angepasst.

PRTPDF mit Rotation (25.10.2022)

Der directmail Druckbefehl PRTPDF, der es erlaubt, erzeugte PDFs über einen IBM i Drucker zu Papier zu bringen, wurde um eine Funktion Rotation erweitert. Bisher gab es erhöhten origanisatorischen Aufwand, wenn Querformulare und Querseiten (90° gedreht) auch so ausgedruckt werden sollten. Bei Verzicht auf den Dreh-Aufwand bei SPLF und Formular kamen die Seiten A4-hoch heraus und waren unvollständig.

Jetzt besteht über den Parameter Formularart die Möglichkeit, mit dem Code *R*STD eine Drehung um 90° auszulösen:

Formularart . . . . . . . . . . FORMTYPE *R*STD

  • *R steht für Rotation und *STD wird einfach 2 Stellen nach rechts verschoben.

Das PTF 14 wurde aktualisiert.

 

PTF13 vom 13.04.21 – Weitere Korrekturen bei Zugferd und XML, sowie MCH1210 in DMAFPSPLF

Mehrere der in den vorherigen PTFs 11+12 angesprochenen Programme wurden erneut geändert. Es sind neue Templates für Zugferd hinzugekommen.

Die Programme DMCVTXCO und DMCVTENH wurden angepasst, da der Name der XMP-Datei im PDF Dokument jetzt variabel eingesteuert wird (vorher war es eine Konstante).

Im Bereich der Templates für XML (Zugferd u.a.) werden für die Auslieferung an den Kunden div. neue Vorlagen im IFS Verzeichnis /Toolmaker/Directmail400/Zugferd installiert, wenn die Namen dort noch nicht existieren. D.h. bestehende, alte oder vom Kunden geänderte Templates werden nicht überschrieben.

Liste der ausgelieferten Templates:

  • ZUG.xml

  • ZUG.xmp

  • ZUGB.xml

  • ZUGB.xml

  • ZUGC.xml

  • ZUGE.xml

  • ZUGT.xml

  • ZUGTT.xml

  • ZUGX.xml

  • ZUGFeRD.xml

  • ZUG_sav.xml

  • ZUG_Default.xml

  • example.txt

Die Installation der Dateien im Unterverzeichnis /Zugferd erfolgt mit dem Programm DMIFSZUG, welches die SAVF DMIFSZUG entpackt. Beide Objekte werden mit dem PTF nach Bibliothek DIRMAIL zurückgespeichert.

Will man in einem Ausnahmefall auch die bestehenden Dateien ersetzen, kann man die Installation der Dateien mit einem manuellen Aufruf des Programms durchführen: CALL PGM(DIRMAIL/DMIFSZUG) PARM(*REPLACE)

09.02.21 MCH1210 in DMAFPSPLF (Feldüberlauf) korrigiert

In bestimmten Situationen fand sich in der MSGQ-QSYSOPR die Fehlermeldung: Abbruch MCH1210 in DMAFPSPLF bei 2030, Ziel für numerische Operation zu klein.

Das Programm DMAFPSPLF wurde geändert, da in besonderen Fällen beim Einfügen einer Grafik ein Feldüberlauf auftreten kann. Drei Arbeitsfelder wurden vergrößert.

PTF 12 vom 11.11.20 – Korrekturen bei Zugferd und XML

Mehrere der in PTF 11 angesprochenen Programme wurden erneut geändert.

In einem Hotlinefall trat im Joblog der folgende Fehler auf, wenn in der Automaildefinition als PDF Ausgabeformat *ZUGFERD angegeben war:

"PDFlib Error 2100 in PDF_end_item()
Function must not be called in 'object' scope."

20.11.20 Problem im Bereich Email Versand behoben

Bei intensiver Nutzung des Emailversands kann es zu einem Speichermangel im Job DMSND01 (02…) kommen. Dieser Fehler war bisher von außen nicht sichtbar. Die betroffenen Emails wurden nicht versandt, sondern in den Ordner Fehler gestellt. Von hier aus konnte man sie mit Auswahl 98 vor Ordner Fehler zurück in den Ordner Ausgang verschieben. Es wurde eine Prüfung hinzugefügt, die den Speichermangel erkennt und den Job autom. neu startet. Dieser Restart wird an QSYSOPR je nach Erfolg positiv oder negativ angezeigt:

Info DIRECTMAIL Job DMSND01 restarted (less heap space memory)

Note: DIRECTMAIL Job DMSND01 restart failed!

Die Programme DMOUTMON, DMRCVMON und DMSTRPGM wurden angepasst.

25.11.20 Startprogramm DMSTRMON korrigiert

Bei einem automatischen Start des directmail Subsystems im Anschluss an ein IPL ist ein Fehler CPF0001 bei SNDPGMMSG gekommen. Die Ursache konnte mangels Joblog nicht geklärt werden. Als Korrektur wurde in Programm DMSTRMON lediglich ein MONMSG hinzugefügt.

16.12.20 Korr. an den ZUGFeRD und XFILE Funktionen

Umlaute kommen jetzt korrekt in das XML File. Zugferd hat das Format UTF-8 und enthält damit alle Zeichen, nur die XML spezifischen Zeichen <> werden substituiert. Die Umlaute kommen korrekt.

Gezonte Felder werden jetzt mit Kommazahlen korrekt übernommen. X-File für AFP ist jetzt möglich.

Geändert wurden die Programme DMCVTENH, DMCVTXFI, DMCVTZUX. Programm DMCVTXCO ist neu.

16.20.20 Memory Leak bei Email-Empfang und –Versand behoben

Die Ursache für den unnötig hohen Verbrauch von temporärem Speicher in den Jobs DMRCV und DMSNDxx wurde jetzt beseitigt. Die zuvor eingebauten automatischen Restarts bei Erreichen der Speichergrenze werden vorerst beibehalten. Programme: DMRCVPOP, DMSNDSMT.

16.12.20 Auswahl *XFILE für directspool (Automail)

Die Auswahlmöglichkeit *XFILE wurde der Datei DMPRMCTL hinzugefügt.

PTF 11 vom 25.09.20 – Erweiterungen und Korrekturen

Bei directspool (Automail) ist jetzt auch die Angabe eines Overlay (Layout) möglich, wenn als Ausgabeformat *GUMBO und als Gumbo Ausgabeformat *ZUGFERD definiert sind (siehe dazu auch Hinweise bei PTF 10).

Die Angabe eines Layouts ist also jetzt nicht nur auf das Ausgabeformat *EPDF beschränkt. Die Layout Datei muss im IFS der IBM i im Verzeichnis /Toolmaker/DirectMail400/FORMS abgelegt sein.

Als Dateiart für das Layout ist PDF zugelassen, aber es wird die Verwendung einer JPG Datei empfohlen. Der Grund ist, dass eine Layout Datei im PDF Format die gleiche PDF Version wie die zu erstellende PDF Datei haben muss. Soll z.B. eine Datei im PDF/A Format erstellt werden, muss auch die Layout Datei das PDF/A Format haben. Beim Einsatz einer JPG Datei ist die PDF Version für das Einmischen nicht von Bedeutung.

Bei *ZUGFERD wurde das Speicher Management im ZUGFERD API optimiert.

Geändert wurden für PTF 11:

Die Quelle des Programms DMWRKZUX Demo API (siehe dazu nach Installation des PTF ein Beispiel in Datei QRPGLESRC in Bibliothek DIRMAIL)

Die Objektprogramme DMCVTENH, DMCVTZUX, DMWRKZUA, DMATMEXC, DMCVTGMB.

PTF 10 vom 02.09.20 – *GUMBO und *ZUGFERD

Directspool (Automail) wurde erweitert. War es bisher erforderlich, eine SCS SPLF als Basis für die Ausgabe einer Rechnung im PDF/A-3 Format incl. XML Zusatz (Thema ZUGFeRD) zu verwenden, kann jetzt eine IPDS oder AFPDS SPLF verwendet werden.

Als Ausgabeformat in der directspool Definition ist dann *GUMBO und bei dem Gumbo Ausgabeformat *ZUGFERD anzugeben.

Ausgabeformat . . . . . . . . .  *GUMBO

Bei *GUMBO:
  Gumbo Ausgabeformat . . . . .  *ZUGFERD     

Folgende Programme waren von der Erweiterung betroffen: DMATMEXC, DMCVTZUX, DMCVTGMB.

Hinweise: Für die Konvertierung von IPDS und AFPDS Spooldateien ist das Zusatztool Gumbo Splamatic erforderlich. Für die Ausgabe von PDF incl. XML Zusatz ist eine Lizenz für die Komponente ZUGFeRD erforderlich (Code XML).

PTF 09 vom 26.08.2020 - Exchange 365 und STARTTLS

Unterstützung des Microsoft (Office) 365 Mailservers (29.07.2020)

Das bisher als Office 365 bezeichnete Produkt von Microsoft erlaubt den Email Versand nur, wenn bei dem Parameter From: sowohl in der SMTP Kommunikation als auch im MIME Code die gleiche Email-Absender-Adresse angegeben wird. Im Folgenden wird dies als neue Methode bezeichnet.

Wird dies nicht beachtet, tritt folgender SMTP Fehler auf:

554 5.2.0
STOREDRV.Submission.Exception:SendAsDeniedException.MapiExcept

Um die Besonderheit bei MS 365 zu unterstützen, wurden zwei Programme so geändert, dass die Absender-Adresse aus der Mailbox immer als Parameter für From: verwendet wird.

Damit der Empfänger auf die Email an die Ansprech-Person direkt antworten kann, wird für den Benutzer im MIME Code eine Zeile Reply-To: mit der Antwort-Adresse eingefügt. Diese wird aus den API Parametern entnommen. Wird dort nichts gefunden, wird die Absender-Adresse aus der Mailbox für die Antwort verwendet.

Bei der alten (bisherigen) Methode wurde die Email-Absender-Adresse des Benutzers für From: verwendet. Nur wenn keine Benutzeradresse übergeben wurde, kam die Email-Adresse der Mailbox zum Einsatz. Der Parameter Reply-To: wurde im MIME Code bisher nicht verwendet.

Nach Installation des PTFs wird die neue Funktion beim Emailversand sofort und allgemein gültig wirksam. Es muss nichts umkonfiguriert werden.

De-Aktivierung der Funktion, falls erforderlich

Sollte es bei Nutzung anderer Mailserver (also bei nicht 365 Servern) zu Fehlern oder beim Empfänger zu Irritationen kommen, kann mit einer kleinen Änderung in einem Datenbereich die alte Technik reaktiviert werden:

CHGDTAARA DTAARA(DIRMAIL/DMDTAARA (1279 2)) VALUE('3F')

Mögliche Codes im Datenbereich: _ entspricht einem Blank

  • 3F Mailboxen mit dem Server smtp.office365.com werden automatisch an der Zahl 365 erkannt und nach der neuen Methode bedient. Andere Mailboxen werden wie bisher nach den alten Regeln verarbeitet.

  • _F Alle Mailboxen werden wie bisher nach den alten Regeln verarbeitet.

  • __ Default, d.h. kein Eintrag im Datenbereich (=2 Blanks). Alle Mailboxen werden nach der neuen Methode bedient.

Da nicht auszuschließen ist, dass künftig andere Mailserver die strengen Regeln von MS verlangen, aber trotzdem ein Mischbetrieb erforderlich ist, kann mit dem Code 3F im Datenbereich und einer Markierung *MS365 im Beschreibungstext der Mailbox gearbeitet werden.

Die hier als neue Methode beschriebene Steuerung sollte, wie oben schon erwähnt, bei allen Mailservern funktionieren.

HOTPTF verfügbar für ältere Versionen vor 5.60

Für Kunden mit älteren Versionen als 5.60 ist ein HOT PTF für die Unterstützung bezüglich MS 365 verfügbar. Der Link wird von der Hotline auf Anfrage geliefert, wenn die sonstigen Voraussetzungen abgeklärt wurden. Versionen, die älter als directmail 5.28 sind, werden von diesem HOT PTF nicht unterstützt. Derzeit sind keine Fälle bekannt, bei denen Versionen 5.28 bis 5.50 zusammen mit diesem HOT PTF verwendet wurden.

SSL und Start TLS 1.2

Verschlüsselte Kommunikation ist bei MS 365 in Kombination mit TLS 1.2 aus Sicherheitsgründen erforderlich. SSL ist schon seit Version 5.01 in directmail unterstützt. TLS 1.2 ist seit PTF 5.50.05 unterstützt.
Geänderte und zusätzliche Programmobjekte

Die Programme DMSNDITM und DMSNDSMT wurden geändert. Zusätzlich sind die Serviceprogramme DMHTTP1 und DMEXPAT1 erforderlich.

Nachträgliche Korrektur DMCHGATM (26.08.2020)

Das PTF 09 wurde neu gepackt und veröffentlicht, da das Programm DMCHGATM für das Editieren einer directspool Definition nachträglich geändert werden musste.

Die Verwendung eines Indexnamens wie z.B. &LOGO im Menü Email, Punkt Formular/Papier, Bild Formularangaben, bei den Parametern Formularname Erste Seite und Folgeseite war nur beim Ausgabeformat *EPDF freigeschaltet. Dies wurde nun auch bei den Formaten *TIFF und *GUMBO zugelassen.

PTF 07 vom 06.05.2020 und PTF 08 vom 29.05.2020

Neue Auswahl 7=Layout Test

DirectSpool (Automail) wurde um die Funktion Layout Test erweitert. Diese erleichtert erheblich die Definitionsarbeit für die Verarbeitung einer Spooldatei (SPLF mit SCS Datenstrom).

Nach Aufruf des Befehls WRKATMDEF kann mit der neuen Auswahl 7 das Ergebnis der Verarbeitung der Muster SPLF am PC angezeigt werden.

Die detailllierte Beschreibung der Auswahl 7=Layout Test finden Sie auf der Seite Mit directspool-Definitionen arbeiten.

Neue Auswahl 5=ursprünglich geladene Muster-SPLF einer Automail-Definition anzeigen

Nach Aufruf des Befehls WRKATMDEF kann mit der neuen Auswahl 5=Spool die Muster SPLF der Automail Definition native angezeigt werden. Das ist sozusagen die SPLF vor der Konvertierung.

Den Trace "on-the-fly" aktivieren

Der Trace schreibt ausführliche Information in das IFS in Verzeichnis /Toolmaker/DirectMail400/debug:

  • Den SMTP- und POP-Datenverkehr dem Server

  • Den Ablauf der Verarbeitung von spoolmail

Der Trace wird mit dem Befehl CFGDIRMAIL eingeschaltet: F4 und F9 drücken, dann auf der letzten Seite TRACE(*YES) angeben. Bislang musste nach dieser Änderung directmail durchgestartet werden (ENDDIRMAIL und STRDIRMAIL). Erst dann wurden die Trace-Dateien geschrieben.

Ab PTF 08 wird der Trace sofort eingeschaltet, wenn der Befehl Trace auf die oben beschriebene Weise gestartet wird ("on-the-fly"). Die Trace-Dateien werden sofort beim nächstmögichen Sendeversuch geschrieben.

Weiere Informationen finden in der Beschreibung des Befehls CFGDIRMAIL.

Neue Auswahl 22=Resend immed. in WRKMBX

Die neue Auswahl 22 bezieht sich auf die Umgehung von Problemen im Bereich "Fehler beim Emailversand". (Siehe Hinweise dazu auch in den vorherigen Absätzen.)

Sie funktioniert ähnlich wie Auswahl 11-Erneut senden. Der einzige Zweck der Auswahl 22 ist es, eine Email im Ordner Gesendet nochmals im Ordner Ausgang zu erstellen und einen neuen Versand durchzuführen - natürlich in der Hoffnung, dass das eigentliche Problem auf dem Mailserver oder in der directspool Jobumgebung behoben wurde. Die ursprünglich gescheiterte Email bleibt bestehen.

Die Auswahl 22 reagiert nach Enter sofort, ohne nochmals eine Bestätigung zu verlangen. Daher ist sie gut geeignet, schnell einen Reset durchzuführen, wenn viele Einträge betroffen sind.

Erkennbar sind solche Fälle im Ordner Gesendet, wenn bei Auswahl 25 keine Versandinformationen angezeigt werden, während bei älteren Emails der Versand mit OK bestätigt wurde.

Neue Funktion X-FILES (Ausgabeformat *XFILE) (15.06.20)

X-File ist eine Verallgemeinerung von ZUGFeRD. Damit ist es möglich, beliebige Transformationen in directspool zu erstellen (nicht nur ZUGFeRD).

Die Transformation erzeugt ein beliebiges File, das nicht in PDF eingebettet ist. Angesteuert wird dies über das Ausgabeformat (*XFILE).

Ansonsten gilt, bei nicht *XFILE und nicht *ZUGFERD bleibt die Funktionalität wie bisher bestehen.

In den XFILE Einstellungen kann man die Transformation analog ZUGFeRD eingeben.

Die Transformation wird auf die Spooldatei angewendet und es wird eine Datei erstellt. Bei X-ADD kann man noch ein optionales Include für den X-File erstellen.

Das erzeugte X-File kann je nach directspool Definition ausgegeben oder als Anhang versendet werden.

Mit der X-File Transformation können beliebige Ausgabeformate erzeugt werden. Z.B. TXT, XML, Word, XLS. Das Verfahren ist analog zu ZUGFeRD: Zuweisung von Indexwerten und Konstanten zu Header und Positionen.
Die Endung für die X-Files ist frei wählbar.

Eine Beschreibung der X-File und ZUGFeRD Funktionalität mit Beispielen und Screenshots ist in Vorbereitung.

Problem im Bereich Email Empfang behoben (17.06.20)

Bei intensiver Nutzung des Empfangs von Emails incl. autom. Verarbeitung über den directmail Eingangsassistenten kann es zu einem Speichermangel im Job DMRCV kommen. Es wurde eine Prüfung hinzugefügt, die den Mangel erkennt und den Job autom. neu startet. Dieser Restart wird an QSYSOPR angezeigt.

Die Programme DMRCVMON und DMSTRPGM wurden angepasst.

Serviceprogramm DMBCDLIB (Barcodes) (25.06.20)

Das Programm wurde so geändert, dass es bei der Ausführung in einer interaktiven Sitzung keine Infos mehr zu dem gerade generierten Barcode einblendet.

RNQ0100 Fehler in DMSNDSMT abgefangen (30.06.20)

Seltene Fehler beim Versand von Emails, wie z.B. ein Timeout, werden jetzt in den Trace geschrieben. Vorher waren sie lediglich als Fehler RNQ0100 Länge oder Position falsch im Joblog von DMSND01 etc zu sehen, wobei das Programm DMSNDSMT abgebrochen wurde.

Jetzt wird die Fehlermeldung ERR0262 SMTP Server Timeout beim Senden von Mail … ausgegeben. Sollte der Fehler häufig auftreten, sollten die Einstellungen in der Mailbox bzw. im Konfig.-Befehl CFGDIRMAIL F4 bei den Parametern für SMTP Server Timeout geprüft werden. Standardwert ist 20 Sekunden.

Möglicherweise entstehen Fehler dadurch, dass der entfernte Mailserver oder das Netzwerk überlastet sind oder die (eigene) Absenderdomäne beim Empfänger gesperrt ist (Spamschutz). Sollte der Fehler im Rahmen der automatischen Sendewiederholung mehrfach auftreten, wird die Email in den Fehler Ordner der Mailbox verschoben.

PTF 06 vom 20.04.2020

DirectSpool (Automail) wurde um die Funktion XRTVPDF erweitert. Damit werden PDF Dokumente anhand von Merkmalen aus der SPLF adhoc aus einem Archiv ins IFS gestellt, um als zusätzliche Mailanhänge ausgeliefert zu werden. Dies ist z.B. nützlich, wenn man bei einer Zahlungserinnerung die angemahnten Rechnungen als PDF Kopien anhängt. Die detaillierte Anleitung, die auch zeigt, wie man das Anschreiben als Mailbody im HTML Format incl. einer Tabelle der Rechnungen und Beträge mit alternativer Anzeige einrichten kann, finden Sie auf der Seite Die XRTVPDF-Funktion - archivierte PDF-Dokumente anhängen

Bei den ZUGFeRD Funktionen wurden Korrekturen durchgeführt. Die Programme DMCVTENH und DMWRKZUG sind betroffen

PTF 02 bis 05  - Erweiterungen und Korrekturen

Die in DirectMail enthaltene Funktion ZUGFeRD wurde bezüglich der Verarbeitung großer Mengen an Indizes in einem Dokument erweitert. Es können jetzt auch eigene Templates mit Parametern erstellt werden.

Bei manchen Installationen zeigte sich, dass das IFS Verzeichnis \Toolmaker\DirectMail400\directweb\templates leer war. Das PTF fügt jetzt die fehlenden 7 HTML Dateien hinzu.

Bei dem neuen Befehl SNDOBJEML wurden die Namen der Parameter korrigiert. Falls Sie diesen Befehl schon in CL-Programmen verwenden, ist eine Anpassung erforderlich.

Am 04.03.20 wurde ein Fehler im Programm DMCVTENH korrigiert, der die Erstellung der XML-Daten in der PDF-Datei betrifft. Außerdem wurde die Ausgabe einer Fehlerwarnung an QSYSOPR bezüglich ZUGFeRD XML abgestellt.

Am 08.04.20 Fehler bei Auslieferung der Datei DMATMMDT (Mandantensteuerung) behoben (PGM SAVTM). Die Datei muss leer bereitgestellt werden.

Am 08.04.20 Fehler im Bereich der ZUGFeRD Dateien DMATMZUA, DMATMZUD und DMATMZUG behoben. In der Vergangenheit wurden die Dateien incl. Daten ausgeliefert, was bei DMATMZUG nicht richtig war. Zur Lösung dieses Problems wurde das Programm DMCLRZUG erstellt, welches bei der PTF-Installation ausgeführt wird und alle Sätze in DMATMZUG löscht, die keinen Kopfsatz in DMATMHDR haben.

Datensätze in Datei DMATMZUG wurden nach der Installation des Produkts nicht von der Sicherungsbibliothek DIRMAILOLD in die erneuerte Produktbibliothek DIRMAIL transferiert. Es bestand die Gefahr, dass ATM-Definitionen in Bezug auf ZUGFeRD Zuordnungen nicht mehr funktionieren. Das Problem wurde behoben. Der negative Effekt betraf auch die Datei DMATMMDT aus der Mandantensteuerung.

Da die Version 5.60 erst einige Monate verfügbar ist, wurden die Installationsprogramme INS_FILDML und INS_PTFDML angepasst und über INST_DIRMAIL_056000_INSCOR.SAV im Download von DirectMail 5.60 verfügbar gemacht. Es wurde kein neuer Master erstellt.

Da das neue IFS Unterverzeichnis …/Zugferd nach einer Installation leer blieb, wurde das zuständige Programm DMIFSZUG korrigiert und zusammen mit PTF 05 ausgeliefert.

 

PTF 01 (wird gemeinsam mit Version 5.60 installiert)

ZUGFeRD-Funktionen aktualisieren

Das PTF sorgt dafür, dass die Funktionen in ZUGFeRD angepasst werden, wenn ZUGFeRD bereits in einer älteren Version in Bibl. DIRMAIL vorhanden war.

Version 5.50

Funktionale Neuerungen

Umfangreiche Erweiterungen im Bereich Konvertierung SCS SPLFs in PDF wurden eingefügt. Basis ist jetzt PDFlib 9.0.5, welche auch die Verwendung von ZUGFeRD Funktionen erlaubt (Format PDF/A-3).

Weitere Informationen zu ZUGFeRD finden Sie auf der Seite directmail und ZUGFeRD.

PTF 12 vom 17.07.19

Barcodes - neue und entfernte (Funktion ^bcd() )

Die folgenden Barcodes werden jetzt neu unterstützt:

  • QRCODESWISS Ein in der Schweiz erforderlicher QR Code

  • QRCODE1 Ein allgemeiner QR Code

Die folgenden Barcodes wurden entfernt:

  • CODE11_C

  • CODE11_CK

Die aktuelle Liste der unterstützen Barcodes finden Sie hier: directspool-Definitionen bearbeiten

 

Erweiterung ZUGFeRD

Diese Funktion wurde um eine universell verwendbare Steuerung zum Einfügen von Dateianhängen (nicht nur XML) in PDF-Dateien erweitert.

In WRKATMDEF kann mit Taste F7 die Verwaltung von ZUGFeRD u.a. Vorlagen erreicht werden.

Die Vorlagen für ZUGFeRD liegen in folgendem IFS Verzeichnis:

/Toolmaker/DirectMail400/Zugferd

In der Quellendatei QRPGLESRC2 in Bibliothek DIRMAIL wird ein API für Programmierer mitgeliefert, welches zum Einfügen von PC-Dateien in ein fertiges PDF-Dokument geeignet ist.

Es handelt sich hier um eine komplexe Erweiterung, für die noch keine Erfahrungen im Produktionsbetrieb vorliegen.

Eine detaillierte Beschreibung ist in Vorbereitung.

SNDSPLEML

Im Befehl SNDSPLEML ist jetzt im Parameter FILE (Name der Spooldatei) der Wert *NONE zugelassen. Dies erlaubt das Senden einer einfachen Email ohne Anhang und ohne, dass eine Dummy-SPLF vorhanden sein muss.

Alle Parameterangaben, die sich auf eine SPLF beziehen, werden ignoriert.

Da dieser Befehl als Kopie auch in Bibliothek QSYS vorhanden sein muss, sollte der Originalbefehl aus DIRMAIL nach Installation des PTFs manuell nach QSYS kopiert werden.

Weitere Informationen zum Befehl SNDSPLEML finden Sie hier: Der Befehl SNDSPLEML

DMRCVITM

Das Email Empfangsprogramm wurde um eine interne Filterfunktion erweitert, die falsch formatierte Emailadressen des Absenders (z.B. bei SPAM asiatischen Ursprungs) übergeht, bevor der MIME String einen Abbruchfehler auslöst.

 

PTF 11 vom 29.05.19

Doppelte Spoolverarbeitung vermeiden

Diese Funktion (Beschreibung siehe im PTF 10) wurde optimiert. Standardmäßig wird ein Cache-Eintrag jetzt nach 60 Minuten wieder gelöscht. Das Programm DMATMMON wurde geändert, so dass man die Zeitspanne über ein Kennzeichen im Datenbereich DMDTAARA (Stelle 1229) steuern kann.

Weitere Informationen zur Steuerung der Cache-"Lebenszeit" finden Sie hier: directspool: doppelte Verarbeitung von SPLF verhindern (die Cache-Funktion).

Fehler bei Verwendung von ^SKP (Skip Seite)

Innerhalb von DirectSpool (Automail) kann mit der Funktion ^SKP eine Seite im Dokument übersprungen werden, wenn eine bestimmte Bedingung erfüllt ist. Z.B. kann es erforderlich sein, Seiten mit dem Hinweis KOPIE auszuschließen, damit sie nicht Teil der PDF-Datei werden.

Für den Fall, dass zufällig alle Seiten die Bedingung erfüllen und ausgeschlossen werden, wird keine PDF-Datei erstellt, was Fehler bei der Weiterverarbeitung der Spooldatei auslöst. Erkennbar ist das daran, dass in der SPLF der Parameter Ben.-Daten (USRDTA) auf dem Wert Automail verbleibt und die SPLF evtl. wiederholt verarbeitet wird.

Um solche Sonderfälle abzufangen, wurde Programm DMATMEXC so geändert, dass die Verarbeitung des Dokuments vor der Konvertierung in eine PDF-Datei abgebrochen wird – Voraussetzung ist, dass die Seiten des Dokuments durch ^SKP ausgeschlossen wurden. Es erfolgt keine Fehlermeldung. Falls der Trace eingeschaltet ist, kann der Vorgang anhand folgender Meldung erkannt werden:

No pages in segment … segment deleted