Inhaltsübersicht

PTF Informationen zu directfax Vers. 6.06

• 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.

PTF 09 vom 16.03.2022

Mindest Release des IBM i Betriebssystems für dieses PTF: V7R1

15.04.21 Änderungen am IFS-Monitor wg. Fehler

Der IFS-Monitor von directfax kann lizenziert werden, um z.B. PDF-Dateien in einem IFS-Verzeichnis abzugreifen und per Definition im Browser automatisch Faxe zu erstellen und zu versenden.

Bei der Nutzung der Parameter *APPKEY1 und *APPKEY2 kann ein Fehler wie RNX0100 oder RNQ0202 auftreten und den Job stoppen, wenn der Wert des Application Keys Länger als 10 Stellen ist.

Das Programm DFIFSMON wurde korrigiert und der Fehler abgefangen. Es werden jetzt nur die ersten 10 Stellen des Wertes verwendet.

26.05.21 Steuerung, in welchem Subsystem die IFS-Monitor-Jobs laufen

Standardmässig laufen die IFS-Monitor-Jobs (siehe directfax – IFS Monitor) im Subsystem QINTER.

Es wurde die Möglichkeit ergänzt, das zu steuern, indem im Datenbereich DIRECTFAXF/FAXDTAARA2 an Stelle 861 eine Jobbeschreibung eingetragen wird. Siehe: Konfiguration des Subsystems in dem die IFS-Monitor-Jobs laufen

Änderungen an der Lizenzroutine

Parallel zu den geänderten Programmen des IFS-Monitors wird eine SAVF mit geänderten Programmen und zugehörigen Objekten installiert (Namen TZ*), die für die Lizenzprüfung in directfax benötigt werden. Hier haben sich einige wenige Programme geändert.

PTF 08 vom 03.08.2020

Mindest Release des IBM i Betriebssystems für dieses PTF: V7R1

23.07.20 Anpassung Mailversand an SMTP AUTH TLS 1.2

Enthalten ist eine Erweiterung für die Kommunikation zwischen directfax und dem Mailserver beim Provider. Neben den verschlüsselten Protokollen SSL und TLS 1.0 wird jetzt auch das verbesserte TLS 1.2 Verfahren unterstützt.

• Die Unterstützung für TLS 1.2 ist ab IBM i V7R2 im Betriebssystem enthalten
• Für IBM i V7R1 muss diese Unterstützung aktiviert werden. Hinweise dazu auf der Seite IBMi-wichtige Informationen rund um das Betriebssytem - TLS1.2 unter IBMi V7R1 aktivieren

In der Konfiguration der Mailbox ist SSL einzustellen (siehe zu diesem Thema auch die directfax Checkliste SSL im Toolmaker Wiki). Das tatsächlich verwendete Protokoll SSL, TLS 1.0, TLS 1.1 oder TLS 1.2 wird beim Kontakt mit dem Mailserver automatisch bestimmt.

Betroffen sind folg. Programmobjekte: DFSNDSMT, DFHTTP1, DFEXPAT1

Hinweis: Seit Oktober 2019 gibt es für Kunden mit der älteren Version directfax 5.92 ein HOT PTF für die Unterstützung von Faxmail bezüglich SSL mit TLS 1.2. Der Link wird von der Hotline auf Anfrage geliefert, wenn die sonstigen Voraussetzungen abgeklärt wurden. Ältere Versionen als directfax 5.92 werden nicht unterstützt.

23.07.20 Unterstützung des Microsoft 365 Mailservers

Das früher 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.

Um dies zu unterstützen, wurde das Programm FAXMAIL so geändert, dass die Postmaster-Absender-Adresse aus CFGFAXMAIL F4 F9 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 dem Faxbenutzerprofil in WRKFAXPRF bei Parameter EMAIL entnommen. Wird dort nichts gefunden, wird die Postmaster-Adresse für die Antwort verwendet.

Die Syntax für die Mailadresse sollte grundsätzlich so aussehen:

"User Name" <user@domain.xx>

Das hat den Vorteil, dass der „sprechende Name“ des Absenders beim Empfänger sofort sichtbar wird.

In der Konfiguration und in WRKFAXPRF muss der String aus Name und Adresse zusätzlich von einfachen Hochkommata eingerahmt sein (hier rot). Beispiel:

'"Toolmaker Hotline" <hotline@toolmaker.de>'

Der Name kann Leerstellen und Sonderzeichen enthalten, die Email Adresse aber nicht!

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

Sollte es aber 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(DIRECTFAXF/FAXDTAARA2 (859 2)) VALUE('3F')

Hinweis: Für Kunden mit der älteren Version directfax 5.92 ist ein HOT PTF für die Unterstützung von Faxmail bezüglich MS 365 verfügbar. Der Link wird von der Hotline auf Anfrage geliefert, wenn die sonstigen Voraussetzungen abgeklärt wurden. Ältere Versionen als directfax 5.92 werden nicht unterstützt.

09.04.21 Fehler in Lizenzprüfung (Programm TZSYS fehlt)

Das PTF 08 wurde um die Installation einer neueren Version der Lizenzprüfung erweitert. Es wird eine SAVF mit div. TZ-Objekten heruntergeladen und diese werden mit RSTOBJ installiert. Darin ist auch das fehlende Programm TZSYS enthalten.

PTF 07 vom 20.07.2018

20.07.18 Erstellung der Datei DFRETFAX

Das PTF-Install.-Programm INS_PTFDFX wurde erweitert und prüft jetzt, ob die Datei DFRETFAX für Retarus vorhanden ist. Wenn nicht, wird die Routine zur Erstellung incl. Durchführung erforderlicher Nebenarbeiten aufgerufen. Es gab 2 Fälle, wo diese Datei nach einem Upgrade von der sehr alten Version 5.91d auf 6.06 nicht vorhanden war. Dies löste einen Lizenzfehler mit der MSG FAX1000 bei Nutzung der Retarus *SUPPORT Funktion aus.

Das Programm DFMIXBCD für das Einmischen eines Barcodes wurde korrigiert. Bei dem Code ^BCD(160;160;CODE128;12345678) mit Positionierung über Zahlenwerte (hier 160) war es zu Störungen gekommen. Bei dem Code ^BCD(;;CODE128;12345678) mit Positionierung über * (aktuelle Position) traten keine Probleme auf.

Das Programm DIRFAXCTLR wurde erweitert und ruft jetzt beim Start ein optionales EXIT-Programm mit Namen DIREXITCTR auf, welches die Jobumgebung für Retarus ändern kann, z. B. wenn es Probleme mit der CCSID auf nicht deutschsprachigen Systemen gibt. Das CL-Programm erwartet keine Parameter und muss bei Bedarf vom Kunden selbst erstellt werden.

PTF 06 vom 16.11.2016

06.07.16 Korrekturen wg. DIRWEB in *LIBL

Die Programme DFFAXOBJ, DFSTRIFS, DFENDIFS nutzen Funktionen in WOPiXX (Bibl. DIRWEB) und wurden um den Aufruf DFADDLIBLE DIRWEB erweitert, weil der Fehler DWCGIFKT nicht gefunden auftrat. Voraussetzung: In BNDDIR in DIRECTSRC muss Aktivierung auf *DEFER stehen und V7R1 ist das IBM Mindestrelease.

19.07.16 Lizenzprüfung für FAXOBJ erweitert

Die Lizenzprüfung für FAXOBJ aufgerufen aus DIRMAIL ATM wurde so erweitert, dass die MIX Funktion auch bei der DirectFax Lite Version ohne Einschränkung funktioniert (mit DSPLICINFO wird die DIRMAIL Automail/directspool Lizenz intern abgerufen). Betroffene Programme: MIXFAX01C, CRTMIXFAX, DFGETLICDM (neu).

16.08.16 Registrierung in WOPiXX für Browser

Der Aufruf DFREGWEB zur Registrierung der CGI-Programme und Übertragung der Nachrichten und Parameter für die Browserbedienung wurde geändert. Das Programm und die zugehörige Datei DFMBRFIL werden vom PTF nach DIRECTFAX übertragen. Das Programm DFREGWEB wird in INS_PTFDFX bei der Installation ausgeführt.

25.08.16 Zusätzliche Archivparameter &D1..9 aus Autofax

Autofax wurde so erweitert, dass die bereits vorhandenen Indizes &D1..9, die aus der Spooldatei als Kennungen abgegriffen werden können, jetzt auch an der Archivierungsschnittstelle für Ausgangsfaxe genutzt werden können. Um die Funktion zu nutzen, muss im Datenbereich FAXDTAARA2 das Kennzeichen in Stelle 858 auf A gesetzt sein. CHGDTAARA DTAARA(DIRECTFAXF/FAXDTAARA2 (858 1)) VALUE(A) Hinweis: Für diese Funktion steht aktuell noch ein HOT PTF auf Basis Version 06.06.05 und IBM V5R4 zur Verfügung. Bitte Hotline fragen.

16.11.16 Bereinigung/Reorg Unterverz. /temp korrigiert

Das Programm DFDLTATT wurde dem PTF 06 hinzugefügt. Eine Korrektur aus 12/2014 zur Löschung alter FAXATT_* Dateien war bisher nicht mit ausgeliefert worden. Hinweis: Sollten sich in /Toolmaker/DirectFax400/temp große Mengen an Dateien der Art FAXATT_xxxx.pdf angesammelt haben, müssen die alten Dateien, d.h. älter als „heute" minus die Tageszahl aus Parameter RETAIN, manuell gelöscht werden. RETAIN finden Sie in CHGFAXVAL F4 F11 auf Seite 2.

PTF 05 vom 13.04.2016

24.04.15 EmailToFax Content-Type: application/pdf

Mit dem Setzen eines P in Stelle 857 des Datenbereichs DMDTAARA kann die interne Struktur der Email aus Programm FAXMAIL auf Content-Type: application/pdfgeändert werden, um mit der Fremdanwendung EmailToFax kompatibel zu sein.

13.04.16 Verlängerung der Betreffzeile auf 97 Zeichen

Durch Verkettung der Inhalte der Parameter ^REF und ^PA kann eine bis zu 97 Zeichen lange Betreffzeile bei Emails aus directfax erzeugt werden. Programm FAXMAIL wurde geändert. Beispiel:

^REF(Dies ist ein Betrefftext +) ^PA(mit Verlängerung über PA)

Ergebnis: Dies ist ein Betrefftext mit Verlängerung über PA

18.05.16 Prüfung auf mögliche Konfigurationsfehler

Die Prüfung auf mögliche Konfigurationsfehler mit Nachricht FAX9217 wurde um den Modemtyp MT9234 ergänzt. Programm DFMODSND wurde geändert.

PTF 04 vom 01.09.2014

01.09.14 IFS-Monitor Dateien und Programme

Die Dateien des IFS-Monitors DFIFSMON und DFIFSPRM wurden vor einiger Zeit erweitert und liefen noch mit LVLCHK *NO. Das wurde jetzt richtiggestellt und die zugehörigen CGI-Programme DFCHGIFP und DFWRKIFP neu umgewandelt. Dies geschah auch im Hinblick auf die geänderten Bibliotheken DIRWEB und WOPIX.

01.09.14 PTF-Installationsprogramm

Das Installationsprogramm INS_PTFDFX wurde angepasst, um Schritte bibliotheksbezogen auszuführen.

PTF 03 vom 30.06.2014

31.01.14 FAXSPLF *PGM

LASTFAXID Datenbereich eingebaut (wg. RCVMSG-Probl. nach Ausführung, bei Bedarf Beispielprogramm bei der Hotline anfordern)

11.06.14 INSTDIRSQL *PGM (QGPL)

Die Dateien QSQLDDL und QSQLDML mit Angaben zu Views und Funktionen wurden hinzugefügt. Programm INSTDIRSQL in QGPL wird installiert und ausgeführt, um die fehlenden SQL Objekte (SQL-Funktion DFX_LSTAT in Member DFXLSTAT und View DFFAXLINV1 in DIRECTFAXF) zu erstellen.

30.06.14 CHGDEFP *PGM

Das Editierprogramm für Autofax-Definition wurde korrigiert. Die Skala für Spaltenpositionen war nach F20 (nach rechts gehen) um 1 Stelle falsch positioniert. Die internen Positionen waren davon nicht betroffen. Nach F20 wird die SPLF jetzt ab Stelle 101 angezeigt.

PTF 02 vom 17.04.2014

29.11.13 WRKINCFAX *PGM

Statusmeldung IMAGENO unterdrückt.

05.12.13 FAXINCD LF

Diese fehlende logische Datei FAXINCD wird erstellt.

Nachträglich eingefügt:

17.04.14 CPYAFPSPLF *PGM

Indexfehler bei AFP-SPLF-Konvertierung korrigiert (Feld MCFGC# in MCFCP# geändert)

PTF 01 vom 22.10.2013

23.08.13 DFGETDIR *PGM

CloseDir() hinzugefügt. Bei sehr lange laufenden Jobs, die dieses Programm nutzen, konnte es nach ca. 200 Aufrufen zu Fehler kommen. Nutzung z.B. bei ^ATTACH /path/file* (generischer Anhang).

22.10.13 DIRFAXDTR3 *PGM

Wg. eines temporären Lizenzfehlers DML400API bei Nutzung der Mailfunktion über DirectMail (MAILSYS *DIRECTMAIL) wurde vor dem Aufruf von FAXMAIL ein DLYJOB 2 eingefügt. Diese Verzögerung verhindert auf sehr schnellen Systemen eine Objektsperre.