directfax Version 25.92 mit dem aktuellen PTF installieren

Hinweis: Mit der vorliegenden DirectFax Version kann jede ältere Version von DirectFax aktualisiert werden, ohne Zwischenversionen einspielen zu müssen.

Erforderliche Prüfungen

Vor der Installation einer neuen Version von DirectFax auf Ihrer iSeries sollten Sie folgende Punkte prüfen:

• Die oben genannten Punkte im Abschnitt Allgemeine Installations-Voraussetzungen.

• Falls Sie eigene Objekte oder Quellen in Bibliothek DIRECTFAX gespeichert haben, retten Sie diese in eine eigene Bibliothek, weil die Installationsroutine keine Rücksicht darauf nimmt. Physische Dateien und andere Objekte in Bibliothek DIRECTFAXF sind von dieser Warnung nicht betroffen. Ihre Konfigurationen, Profile, Graphiken und andere DirectFax Daten bleiben erhalten!

• Falls Sie eigene logische Dateien über die DirectFax-Dateien in Bibliothek DIRECTFAXF gelegt haben, löschen Sie diese und erstellen Sie sie neu nach Abschluss der Installation. Wenn dieser Punkt nicht beachtet wird, kommt es zu Abbruchfehlern während der Dateikonvertierung.

• Prüfen, wann Sie für einen Zeitraum von ca. einer Stunde das Produkt DirectFax exklusiv, d.h. ohne Störungen durch Benutzereingriffe, für sich zur Verfügung haben.

Die Installation selbst wird dann wie folgt durchgeführt:

...

Alle Benutzer warnen, dass jetzt für eine bestimmte Zeit keine DirectFax-Menüpunkte aufgerufen werden dürfen und der DirectFax PC-Client nicht angerührt wird!!! Es darf kein Directfax-Menü am Bildschirm stehen bleiben (das gilt auch für die EDV). Es schadet nichts, wenn die Bibliotheken DIRECTFAX und DIRECTFAXF irgendwo in einer Bibl.-Suchliste (*LIBL) stehen.

...

Mit ENDDIRFAX das Subsystem DIRECTFAX beenden.

...

SIGNOFF machen und sich mit QSECOFR und Kennwort neu anmelden (auch wenn Sie schon mit QSECOFR angemeldet sind!).

Bitte prüfen Sie dann mit WRKACTJOB, ob Jobs mit Namen DFAXxxxx (xxxx=4-stellige Zahl) oder INTRADEV im Subsystem QINTER oder QCMN aktiv sind. Das können alte, hängen gebliebene Serverjobs für DirectFax Clients sein (oder aktive Benutzer, die die Warnung von Punkt 1 nicht ernst genommen haben). Diese Jobs müssen mit Auswahl 4, Taste F4 und *IMMED beendet werden. Beenden Sie auch den DirectFax-Job TCPSERVER (meist im QINTER) auf die gleiche Weise.

Bitte wählen Sie eine Installationsvariante aus:

A: Falls Sie als Datenträger eine CD erhalten haben, diese in das optische Laufwerk der iSeries einlegen und die Installation mit dem Befehl

LODRUN OPT01 und Datenfreigabetaste

starten (statt OPT01 ggf. den abweichenden Namen des CD-Laufwerkes an Ihrer iSeries eingeben).

B: Falls Sie eine EXE-Datei über einen Download aus dem Internet erhalten haben, starten Sie am PC mit Doppelklick auf die EXE-Datei und folgen den dort angezeigten Anweisungen. Der Punkt 6 unten gilt hier nicht.

C: Falls Sie eine ZIP-Datei über einen Download aus dem Internet erhalten und lt. WEB-Transfer-Anleitung die Sicherungsdatei auf Ihre iSeries in die Bibl. SAVPRODFAX übertragen haben, wird die Installation mit dem Befehl INSTDIRFAX und Datenfreigabetaste

gestartet.

Bei den Installationsvarianten A und C erscheint die erste von 5 Bildschirmseiten des Installationsprogramms.

Im ersten Bild können Sie die Primärsprache für Menüs und Befehle wählen. Auf Grund der Spracheneinstellung des Systems wird i.d.R. die richtige Sprache vorgeschlagen (in Deutschland z.B. DEU und in der Schweiz DES/Multinational). Auf Basis der DirectFax Profile kann die Spracheinstellung für Bildschirmanzeigen später jederzeit individuell (je Benutzer) vorgegeben werden.

Mit Datenfreigabetaste kommen Sie jeweils zum nächsten Bild.

Falls noch Benutzer mit DirectFax aktiv sind, können Sie nicht installieren. Angezeigt wird auf Seite 1 in der Zeile Version der Datenbibliothek DIRECTFAXF möglicherweise ein roter/blinkender Hinweis * ACTIVE *. Dann ist eine der Dateien FAXKA, FAXSTAT oder FAXLGO offen. Auf einer 2. Sitzung können Sie das mit WRKOBJLCK DIRECTFAXF/Dateiname prüfen. Nach Beseitigung der Ursache können Sie im Installationsprogramm Taste F5=Aktualisieren drücken.

Auf Seite 4 wählen Sie als erstes den Menüpunkt 11 aus: Bibliotheken DIRECTFAX und DIRECTFAXF in die Sicherungsdateien SAVDIRFAX und SAVDIRFAXF in Bibl. QGPL sichern (SAVLIB nach *SAVF)

Nach der erfolgreichen (fehlerfreien!) Sicherung der vorhandenen DirectFax-Bibliotheken starten Sie aus dem selben Menü den Punkt 3 Update-Installation (neuere Version von DirectFax einspielen).

Sie können auch ohne Gefahr Menüpunkt 4 Update-Installation nach Umbau des Systems auf RISC-Technologie oder 5 wählen. Derzeit gibt es im Ablauf dort keine Unterschiede.

Nach ca. 10-30 Minuten wird die erfolgreiche Installation gemeldet und Sie können das Installationsprogramm mit F3 verlassen.

Jetzt ist ein geeigneter Zeitpunkt zur Eingabe der Lizenzcodes (dies ist erforderlich, wenn Sie von Version 3 oder 4 auf Version 5 umgestiegen sind).

Handelt es sich um eine Installation unter V6R1 oder höher und ist der Systemwert QFRCCVNRST kleiner als 2, ist es empfehlenswert, jetzt alle Programme nach V6 zu konvertieren. Dazu folgende Befehle eingeben:

CHGPGM PGM(DIRECTFAX/*ALL) FRCCRT(*YES)

CHGSRVPGM SRVPGM(DIRECTFAX/*ALL) FRCCRT(*YES)

...

Bitte melden Sie sich danach mit SIGNOFF *LIST ab, damit das Joblog der Installation als Spooldatei in OUTQ QEZJOBLOG gerettet wird (bitte nicht ausdrucken!).

...

Sollte es während der Installation zu Abbruchfehlern kommen, dokumentieren Sie diese auf jeden Fall per Hardcopy. Im Anhang finden Sie eine Beschreibung für die Lösung von Installationsproblemen.

...

Falls auf der Toolmaker Website Zusatzkorrekturen (z. B. ein kumulatives PTF) zu der gerade installierten Version angeboten werden, sollten Sie diese jetzt in der dort beschriebenen Weise installieren.

...

Jetzt können Sie sich wieder mit normalem Namen und Kennwort anmelden und DirectFax wieder starten (STRDIRFAX oder GO FAXOPR Menüpunkt 1). Falls erforderlich, können Sie hier auch den TCPSERVER von DirectFax starten (Menüpunkt 3).

Falls Sie den DirectFax PCL-Konverter im Einsatz haben und Spooldateien mit *USERASCII Datenstrom über Autofax versenden, sollten Sie die verschiedenen Belegarten testen. Durch die permanente Weiterentwicklung der PCL Serverprogramme kann es durch Rundungsdifferenzen oder geänderte Routinen zu Abweichungen im Layout kommen. Falls Autofax die Faxnummer oder Mailadresse nicht mehr finden kann und einen ^FAX Error meldet, müssen Sie mit Befehl WRKATFDEF bei der betreffenden Definition eine aktuelle PCL Spooldatei importieren und den Schlüssel (blaue Umkehranzeige) neu setzen.

Wenn Sie den PCL-Konverter nicht nutzen, erstellen Sie ein einfaches Testfax und senden Sie es an Ihr hausinternes Faxgerät. Wenn das erfolgreich war, geben Sie DirectFax für alle Benutzer wieder frei.

...

Dieser Abschnitt beschreibt die Punkte, die beim Umstieg auf eine neue iSeries besonders zu beachten sind.

Beim Umstieg auf eine neue iSeries werden auf der alten Maschine alle Bibliotheken gesichert und auf der neuen Maschine zurückgespeichert. Dabei sollte unbedingt darauf geachtet werden, dass in beiden Fällen mit dem Profil QSECOFR gearbeitet wird und das Subsystem DIRECTFAX beendet ist. Auch der Job TCPSERVER und zugehörige Jobs DFAXxxxx und INTRADEV sollten beendet sein, da die Sicherung sonst wegen offener Dateien unvollständig ist!

Da der Umstieg meistens auf eine neue iSeries mit höherem OS/400 Release-Stand erfolgt, werden bestimmte IBM-Bibliotheken wie z.B. QUSRSYS und QGPL nicht übernommen. Dies erfordert zusätzliche Maßnahmen bei DirectFax.

Wegen der Änderung der Serien-Nr. und des Modells müssen neue Lizenzcodes für alle bisher aktivierten Funktionen vorliegen.

Beachten Sie bitte, dass die Lizenzcodes nur einmal eingegeben werden können. Falls Sie nach der Lizenzeingabe die Bibliothek DIRECTFAX löschen und alles noch mal neu installieren, wird die iSeries die Kennworte der Lizenzcodes nicht akzeptieren und Toolmaker muss Ihnen neue Lizenzcodes mit heutigem Kennwortdatum liefern.

Schritte beim Umstieg auf eine neue iSeries

(bitte alle Schritte unter dem QSECOFR-Profil durchführen)

Bibliotheken DIRECTFAX und DIRECTFAXF unter QSECOFR auf der alten iSeries sichern, während niemand mit dem Produkt arbeitet und das Subsystem DIRECTFAX beendet ist (ENDDIRFAX). Dieser Schritt kann entfallen, wenn diese beiden Bibliotheken bereits im Zusammenhang mit einer Gesamtsicherung gesichert wurden.

Bitte beachten Sie, dass sich auch im IFS (Integrated File System) der iSeries Ordner mit Dokumenten und PC-Dateien von oder für DirectFax befinden können (es könnten kundeneigene Verzeichnisse mit TIF-Dateien dabei sein, die mit ^ATTACH gefaxt werden). Diese müssen ebenfalls gesichert werden. Beispiel für einen Standardordner: /Toolmaker

Bibliotheken DIRECTFAX und DIRECTFAXF unter QSECOFR in die neue iSeries zurückspeichern. Dieser Schritt kann entfallen, wenn diese beiden Bibliotheken bereits im Zusammenhang mit einer Gesamtsicherung gesichert und zurückgespeichert wurden.

Auch die gesicherten Ordner aus dem IFS müssen zurückgespeichert werden.

Falls Sie im Rahmen des Maschinenwechsels auch gleich eine neuere Version von DirectFax installieren wollen, können Sie das jetzt tun.

Beachten Sie dabei bitte die im vorherigen Abschnitt Update-Installation dargelegten Schritte zur Durchführung der Installation.

...

Falls auf der Toolmaker Website Zusatzkorrekturen (PTFs) zu der gerade installierten Version angeboten werden, sollten Sie diese jetzt in der dort beschriebenen Weise installieren.

...

Jetzt folgt die Eingabe aller vorliegenden Lizenzcodes entsprechend der Anleitung auf dem jeweiligen Kennwort-Brief/Fax. Falls Sie hierzu Hilfe brauchen, können Sie sich das Dokument Softkey.doc von der Toolmaker Website herunterladen (siehe DirectFax FAQ, Suchbegriff Softkey).

Falls Sie keine Update-Installation (siehe Schritt 3) gemacht haben, ist jetzt folgender Befehl einzugeben:

CALL INZDIRFAX

Alle DirectFax Befehle und Menüs werden in die QUSRSYS kopiert und andere Schritte durchgeführt, die sonst nach einer Installation üblich sind.

Mit GO FAXCNFG jetzt ins DirectFax Menü gehen und Punkt 1 Konfiguration aufrufen. Den Ressourcennamen prüfen und ggf. an die neue iSeries-Umgebung anpassen. Mit WRKHDWRSC *CMN können Sie sich einen Überblick über die vorhandenen V.24 Schnittstellen verschaffen.

Achtung für Kunden, die mit der älteren DCE Faxbox Typ 30 oder 2-30 arbeiten: Nach Eingabe des richtigen Ressourcennamens drücken Sie F10 und blättern auf die nächste Seite. Wird dort als Typ der Faxbox 30 (aber auch 32-38 ist möglich) angezeigt , geben Sie beim Parameter Anpassungen an RISC PCI-Bus *PCI ein. Wird als Typ der Faxbox M0 (aber auch M2-M8 ist möglich) angezeigt, drücken Sie einfach Datenfreigabe. Falls Sie mit dem neuen Sendeprogramm (Param. MIXALL = *EXT) arbeiten, sind Sie von diesen Hinweisen nicht betroffen.

...

STRDIRFAX eingeben und ein 2-3-seitiges Testfax (z.B. eine Spooldatei) an Ihr hausinternes Faxgerät senden.

Spiegelung des Datenbestands

Falls der gesamte Datenbestand der iSeries auf eine andere iSeries gespiegelt wird, um im Notfall schnell auf das Ersatzsystem umschalten zu können, ist im Zusammenhang mit DirectFax folgendes zu beachten.

Die DirectFax Lizenzcodes sind in Objekten der Art *USRSPC in Bibl. DIRECTFAX gespeichert. Die Namen beginnen mit DF450*. Diese 11 oder mehr Objekte müssen aus der Spiegelung herausgenommen werden, damit die auf der Backup-Maschine hinterlegten Lizenzcodes nicht überschrieben werden.

Nachdem die Objekte aus der Spiegelung der Hauptmaschine herausgenommen wurden, können die DirectFax-Lizenzcodes des Backup-Systems auf dem Backup-System gefahrlos eingegeben werden.

Bitte beachten Sie, dass Lizenzcodes nur einmal benutzt werden können. Auch wenn die Objekte ausgetauscht werden, ist keine zweite Eingabe des Codes möglich. Toolmaker muss dann neue Kennworte generieren.

Installation Online-Hilfedateien

Toolmaker liefert DirectFax mit einer Online-Hilfe aus, die Ihnen am PC feldbezogen Informationen zum jeweils angezeigten Bildschirm bietet. Damit erübrigt sich oftmals die Suche im PDF- oder ausgedrucktem Handbuch, da in der Online-Hilfe die gleichen Informationen enthalten sind.

Die Online-Hilfe wird bei der Installation von DirectFax automatisch zur Installation angeboten, wenn die Installation am PC aus der großen DirectFax EXE-Datei gestartet wurde.

Wurde die Installation aber auf der iSeries mit LODRUN gemacht, müssen zumindest die Hilfedateien auf dem jeweiligen PC oder zentral auf einem Server installiert werden.

Legen Sie die CD in den PC ein und doppelklicken Sie die Datei directfax_help_d.exe. Es wird ein Winzip Archiv geöffnet. Sie können dann das Zielverzeichnis für die beiden Hilfedateien beibehalten oder bei Bedarf ändern und dann die Taste Extrahieren drücken.

Hinweis:

Funktioniert in Ihrer Umgebung die Anzeige der Online Hilfe am PC nicht, können Sie auf der CD die Datei DirectHelpRuntimeClient x.xx.xx deutsch.exe doppelklicken oder über die Toolmaker Webseite den DirectHelp Client herunterladen und installieren. Zur Aktivierung der Kommunikation über den DirectHelp Client stellen Sie im Befehl WRKHLPPTH den Parameter "Kommunikation mit PC" den Wert "DIRPCCMD" ein. Details finden Sie weiter unten.

Hinweis zu Windows Vista: Hilfedateien mit der Dateinamenerweiterung ".hlp" können unter Vista nur in Verbindung mit WinHlp32.exe, das aus rechtlichen Gründen nicht mit ausgeliefert werden darf, angezeigt werden. http://support.microsoft.com/kb/917607

Anhang

Installationsfehler beheben

Abbruchfehler

Sollte es während der Dateikonvertierungen zu Abbruchmeldungen kommen, weil die zu konvertierende Datei doch von laufenden Anwendungen benutzt und damit offen gehalten wird oder nicht gelöscht werden kann, weil fremde logische Dateien im Spiel sind, notieren Sie sich den Namen der bemängelten Datei und den Namen des abgestürzten Programms (CVTxxxxxxx) und beantworten Sie diese und die Folge-Meldungen mit. ‘C’ (Cancel/Abbruch), bis Sie wieder im Install.-Menü sind.

Joblog prüfen

Dann prüfen Sie mit Abruf/3 und Auswahl 10 und dann F10 und F18 das Joblog und ermitteln die Fehlerursache. Ggf. verwenden Sie von einer anderen Sitzung WRKOBJLCK, um die aktiven Benutzer herauszufinden.

Wiederanlauf

Nachdem Sie den Fehler beseitigt haben, machen Sie einen Wiederanlauf der DirectFax-Installation. Falls Sie während der Fehlersuche auch das Install.-Programm verlassen hatten, geben Sie INSTDIRFAX ein. Wählen im Install.-Menü den Punkt 6 (Wiederanlauf). Das Install.-Programm wird bei der Dateikonvertierung genau bei der abgebrochenen Datei wieder aufsetzen.

Überlegungen zur Nutzung eines iASP

DirectFax wurde ab Version 5.91 so geändert und erweitert, dass es in einem iASP (independent Auxiliary Storage Pool ) installiert und genutzt werden kann.

Man verwendet einen iASP in der Regel, um die Systemverfügbarkeit zu erhöhen. Die Daten des iASP sind dann außerhalb der lokalen iSeries physisch in einem anderen System gespeichert.

Der iASP wird aus der Sicht der lokalen iSeries wie eine Einheit angehängt und dem Job zugeordnet. Die Bibliotheken und Dateien im iASP sind also nicht automatisch und immer online!

Außerdem können manche Systemobjekte nicht in den iASP gespeichert und andere dort vorhandenen Objektarten nicht benutzt werden. Ab i5/OS V5R2 ist die Funktion seitens IBM verfügbar, wurde aber in V5R3 nochmals bezüglich der erlaubten Objektarten geändert.

Die Anpassungen in DirectFax betreffen alle Programme, die Objekte aus Sicherungsdateien zurückspeichern, da hier in jedem Einzelfall die Parameter RSTASP und RSTASPDEV geprüft und richtig gesetzt werden müssen. Außerdem sind die im iASP nicht nutzbaren DirectFax Objekte in die Bibl. QGPL verschoben worden. Dies sind im Einzelnen:

• *SBSD DIRECTFAX (bisher in DIRECTFAXF)

• *JOBQ DIRECTFAX (bisher in DIRECTFAX)

• *JOBQ TCPJOBQ (bisher in DIRECTFAXF)

• *JOBD DIRECTFAX (bisher in DIRECTFAX)

• *JOBD STRDIRFAX (bisher in DIRECTFAX)

• *JOBD STRTCPSRV (bisher in DIRECTFAX)

Die aufgelisteten Objekte werden bei der Installation einmalig neu erstellt und können dann bei Bedarf durch den EDV-Verantwortlichen angepasst werden.

Die Erstellung fehlender Objekte kann manuell mit folgenden Befehlen jederzeit aufgerufen werden (es wird empfohlen, mit QSECOFR angemeldet zu sein, zumindest ist *ALLOBJ erforderlich):

ADDLIBLE DIRECTFAX

CALL INZDIRFAX

Voraussetzungen für DirectFax im iASP sind:

...

Beide Bibliotheken (DIRECTFAX und DIRECTFAXF) müssen im iASP gespeichert werden, nicht nur eine von beiden.

...

Der iASP muss bereits bei Systemstart (in QSTRUP) mittels Befehl

VRYCFG CFGOBJ(IASP33) CFGTYPE(*DEV) STATUS(*ON)

angehängt werden.

In allen JOB-Beschreibungen der Benutzer und Batchjobs, die auf DirectFax im iASP zugreifen wollen, muss der folgende Parameter gesetzt sein (das betrifft auch die Jobbeschreibungen von DirectFax, die oben aufgelistet wurden):

ASP-Anfangsgruppe . . . . . . . INLASPGRP IASP33

Achtung: In IBM-Jobbeschreibungen wie z. B. QDFTJOBD darf nie ein iASP-Name angegeben werden, da sonst ernsthafte Probleme beim Anmelden eines Benutzers auftreten können.

...

Alternativ kann ein Job den iASP explizit mit folgendem Befehl zuweisen:

SETASPGRP ASPGRP(IASP33)

...

Das IFS-Verzeichnis /Toolmaker muss sich im iASP befinden. Das i5/OS regelt das durch den vorangestellten Pfad /IASP33.

Bei der Installation von DirectFax in einen iASP sind folgende Abweichungen von der normalen Installationsfolge zu beachten:

...

Bei einer Update-Installation müssen sich die beiden Bibliotheken DIRECTFAX und DIRECTFAXF bereits im iASP befinden. Auch das IFS-Verzeichnis /Toolmaker muss schon unter /IASP33 positioniert sein.

War DirectFax bisher im ASP 1 aktiv und soll das Produkt zukünftig in einem iASP laufen, müssen prinzipiell folgende Schritte manuell gemacht werden, bevor die Installation von DirectFax startet:

CRTSAVF ...

SAVLIB DIRECTFAX ...

CRTSAVF ...

SAVLIB DIRECTFAXF ...

DLTLIB DIRECTFAX

DLTLIB DIRECTFAXF

RSTLIB DIRECTFAX aus SAVF in den iASP

RSTLIB DIRECTFAXF aus SAVF in den iASP

Kopieren des IFS Verzeichnisses /Toolmaker unter /IASP33 und anschließende Löschung im normalen IFS.

Hinweis:

Es gibt keine Möglichkeit, die beiden Bibliotheken mit MOVOBJ oder anderen Befehlen direkt in den iASP zu schieben.

...

Bei der eigentlichen Installation wird die Rückspeicherung in einen iASP beim Aufruf von INSTDIRFAX F4 mit den Parametern ASP und ASPDEV bestimmt. Das bedeutet, wenn in einen iASP installiert werden soll, muss nach dem Übertragen der Installationsbibliotheken SAVPRODFAX etc. ins System, ein manueller Aufruf INSTDIRFAX F4 mit Angabe der ASP-Parameter erfolgen. Die LODRUN-Automatik kann nicht verwendet werden.

...

Sollte es in der Archivierungsschnittstelle CFGFAXARC Pfadangaben zum IFS geben, müssen diese so geändert werden, dass /IASP33 am Anfang steht. Das gilt nicht für QDLS.

Die Unterstützung für iASP wurde neu in DirectFax integriert, noch liegen aber keine Erfahrungen aus der Praxis vor (Stand 06/2009).

Spezielle Installationshinweise

Soll eine Installation aus dem iSeries Green Screen erfolgen, es liegt aber nur eine DirectFax EXE Datei aus einem Download vor, kann diese Aufgabe wie folgt gelöst werden:

Auf der iSeries WRKFAXSTS aufrufen und stehen lassen (dies blockiert einige DirectFax Dateien).

Am PC die Installation mit Doppelklick auf die DirectFax EXE-Datei starten. Dabei ganz normal den Anweisungen folgen. Die Installation wird nach Übertragung der Sicherungsdatei abbrechen, da das Produkt benutzt wird.

Auf der iSeries das Programm WRKFAXSTS beenden und auch sonst alle Vorkehrungen für eine Installation wie oben beschrieben durchführen. Nach Anmeldung mit QSECOFR kann die eigentliche Installation dann mit Befehl INSTDIRFAX gestartet werden. Diese Vorgehensweise entspricht im Ergebnis der Installationsvariante 5 C wie sie oben bei der Installation eines Updates beschrieben wurde. Es geht dann dort mit Punkt 6 weiterStand: Juni 2023

Voraussetzungen

Der Versand von E-Mails über einen SMTP Server von Microsoft 365 erfordert zwingend das Protokoll SSL mit TLS 1.2. Diese Unterstützung muss sowohl im Betriebssystem IBM i, als auch in directfax verfügbar sein.

IBM i Betriebssystem-Versionen

• IBM i V7R2M0 und alle folgenden Versionen unterstützen TLS 1.2 “ab Werk”,

• IBM i V7R1M0 untersützt TLS 1.2 erst ab dem Technology Refresh 6. Weitere Informationen dazu: hier

Es muss auf der IBM i ein SSL-Zertifikatsspeicher existieren

Weitere Hinweise dazu: IBM i - wichtige Informationen rund um das Betriebssytem

directfax-Versionen

• Ab Version 6.06, PTF 08 unterstützt directfax die Anbindung an die Microsoft 365 Server. Die Version 6.06 und das PTF werden über den Toolmaker Installation Manager installiert.

• Für die vorhergehende Version 5.92 wurde ein Notfall-PTF erstellt, das auch den SMTP-Versand über die Microsoft 365 Server ermöglicht. Hinweise dazu finden Sie weiter unten auf dieser Seite.

Authorisierung für Email-Versand und -Empfang (SMTP, POP) über Microsoft 365

Ab 2023 unterstützt Microsoft 365 nicht mehr alle Authorisierungsmodelle, also die Art, wie sich ein System beim Microsoft 365 Server anmeldet.

Die Unterstützung für Basic Authentication (also Benutzer & Kennwort) wurde

• für SMTP de-aktiviert, kann aber von einem Administrator wieder reaktiviert werden. Siehe auch: und auf der Wiki-Seite Microsoft Exchange 365 - Keine Basic Authentication mehr ab Oktober 2022

• für POP de-aktiviert und kann nicht reaktiviert werden, sie wird durch das modernere Protokoll XOAUTH ersetzt. Das ist aber für directfax nicht relevant, denn mit diesem Produkt können nur Faxmails versandt werden.

Anchor
DFX592 DFX592

directfax Version 5.92 mit dem HOTPTF20200811 installieren

Natürlich ist es sinnvoll, Software immer auf dem neuesten Stand zu halten. Bei directfax ist das (Stand Juni 2023) die Version 6.06.

Für den Fall aber, dass der update auf nicht möglich ist oder gewünscht wird, stellt Toolmaker einmalig und als Ausnahme das Notfall-HOTPTF20200811 zur Verfügung. Mit diesem PTF ist die Verwendung von Microsoft 365 SMTP-Servern auch noch unter Version 5.92 möglich.

Hinweis: Mit der vorliegenden DirectFax Version kann jede ältere Version von DirectFax aktualisiert werden, ohne Zwischenversionen einspielen zu müssen.

Download der benötigten Dateien

Die folgenden Dateien werden benötigt:

• Für den Update von einer vorherigen Version auf die Version 5.92:

  • TMSSAVF1.SAVF

  • TMSSAVF2.SAVF

• Das Hotfix 20200811

  • TMSHOTPTF.SAVF

Diese 3 Dateien sind in diesem Download enthalten: http://www.toolmaker.de/download/dirfax/DF590/DIRFAX_592_mit_Office365_PTF.zip (98 MB).

Nach dem Herunterladen muss die ZIP-Datei entpackt werden:

...

Anchor
UPLOAD UPLOAD

Upload der benötigten Dateien auf die IBM i via FTP in die Bibliothek QGPL

Nach dem Download und Entpacken müssen die benötigten Dateien per FTP auf die IBM i kopiert werden.

Bitte prüfen Sie mit dem Befehl DSPDIRFAXV, welche Version von directfax installiert ist

• Wenn die Version 5.92 angezeigt wird, dann wird nur die TMSHOTPTF.SAVF benötigt

• Wenn eine ältere Version (5.91..) angezeigt wird, dann werden alle 3 Dateien benötigt

Anleitung für den FTP-Transfer

Wenn ein FTP-Tool, wie z.B. FileZilla oder der Norton Commander zur Verfügung steht, dann kann man natürlich dieses für den Transfer der Dateien verwenden.

Wenn nicht, dann ist hier eine Anleitung, wie man das manuell machen kann:

1. Erstellen der SavF auf der IBM i. Sollte der Fehler kommen, dass die Datei schon existiert, dann ist CLRSAVF zu verwenden, anstelle von CRTSAVF

CRTSAVF QGPL/TMSHOTPTF

Wenn zusätzlich der update von einer älteren Version (5.91 oder davor) erforderlich ist, dann noch:

CRTSAVF QGPL/TMSSAVF1
CRTSAVF QGPL/TMSSAVF2

2. Dateien per FTP auf die IBM i kopieren

Am PC ein DOS-Fenster öffnen und folgendes eingeben (Kleinbuchstaben sind erlaubt):

FTP x.x.x.x (TCP-Adr. Ihrer iSeries angeben)
Name+Kennwort (QSECOFR und KW nach Aufforderung eingeben)
BIN
PUT <pfad>\TMSHOTPTF.savf QGPL/TMSHOTPTF

Bei einem update von 5.91 etc. zusätzlich:

PUT <pfad>\TMSSAVF1.savf QGPL/TMSSAVF1

PUT <pfad>\TMSSAVF2.savf QGPL/TMSSAVF2

QUIT

EXIT

Erforderliche Prüfungen

Vor der Installation einer neuen Version von DirectFax auf Ihrer iSeries sollten Sie folgende Punkte prüfen:

• Falls Sie eigene Objekte oder Quellen in Bibliothek DIRECTFAX gespeichert haben, retten Sie diese in eine eigene Bibliothek, weil die Installationsroutine keine Rücksicht darauf nimmt. Physische Dateien und andere Objekte in Bibliothek DIRECTFAXF sind von dieser Warnung nicht betroffen. Ihre Konfigurationen, Profile, Graphiken und andere DirectFax Daten bleiben erhalten!

• Falls Sie eigene logische Dateien über die DirectFax-Dateien in Bibliothek DIRECTFAXF gelegt haben, löschen Sie diese und erstellen Sie sie neu nach Abschluss der Installation. Wenn dieser Punkt nicht beachtet wird, kommt es zu Abbruchfehlern während der Dateikonvertierung.

• Prüfen, wann Sie für einen Zeitraum von ca. einer Stunde das Produkt DirectFax exklusiv, d.h. ohne Störungen durch Benutzereingriffe, für sich zur Verfügung haben.

Durchführen der Installation

Update auf Version 5.92 wenn erforderlich

1. Alle Benutzer warnen, dass jetzt für eine bestimmte Zeit keine DirectFax-Menüpunkte aufgerufen werden dürfen und der DirectFax PC-Client nicht angerührt wird!!! Es darf kein Directfax-Menü am Bildschirm stehen bleiben (das gilt auch für die EDV). Es schadet nichts, wenn die Bibliotheken DIRECTFAX und DIRECTFAXF irgendwo in einer Bibl.-Suchliste (*LIBL) stehen.

2. Mit ENDDIRFAX das Subsystem DIRECTFAX beenden.

3. Abmelden und als QSECOFR neu anmelden (auch wenn Sie schon mit QSECOFR angemeldet sind!). Ein anderes, gleichwertiges Benutzerprofil ist auch akzeptabel.

4. Bitte prüfen Sie dann mit WRKACTJOB, ob Jobs mit Namen DFAXxxxx (xxxx=4-stellige Zahl) oder INTRADEV im Subsystem QINTER oder QCMN aktiv sind. Das können alte, hängen gebliebene Serverjobs für DirectFax Clients sein (oder aktive Benutzer, die die Warnung von Punkt 1 nicht ernst genommen haben). Diese Jobs müssen mit Auswahl 4, Taste F4 und *IMMED beendet werden. Beenden Sie auch den DirectFax-Job TCPSERVER (meist im QINTER) auf die gleiche Weise.

5. RSTOBJ QINSTAPP SAVPRODFAX *SAVF SAVF(QGPL/TMSSAVF1) RSTLIB(QTEMP)

6. CALL QTEMP/QINSTAPP *SAVF

7. INSTDIRFAX u

8. Es erscheint die erste von 5 Bildschirmseiten des Installationsprogramms.

   Im ersten Bild können Sie die Primärsprache für Menüs und Befehle wählen. Auf Grund der Spracheneinstellung des Systems wird i.d.R. die richtige Sprache vorgeschlagen (in Deutschland z.B. DEU und in der Schweiz DES/Multinational). Auf Basis der DirectFax Profile kann die Spracheinstellung für Bildschirmanzeigen später jederzeit individuell (je Benutzer) vorgegeben werden.

   Mit Datenfreigabetaste kommen Sie jeweils zum nächsten Bild.

   Falls noch Benutzer mit DirectFax aktiv sind, können Sie nicht installieren. Angezeigt wird auf Seite 1 in der Zeile Version der Datenbibliothek DIRECTFAXF möglicherweise ein roter/blinkender Hinweis * ACTIVE *. Dann ist eine der Dateien FAXKA, FAXSTAT oder FAXLGO offen. Auf einer 2. Sitzung können Sie das mit WRKOBJLCK DIRECTFAXF/Dateiname prüfen. Nach Beseitigung der Ursache können Sie im Installationsprogramm Taste F5=Aktualisieren drücken.

   Auf Seite 4 wählen Sie als erstes den Menüpunkt 11 aus: Bibliotheken DIRECTFAX und DIRECTFAXF in die Sicherungsdateien SAVDIRFAX und SAVDIRFAXF in Bibl. QGPL sichern (SAVLIB nach *SAVF)

   Nach der erfolgreichen (fehlerfreien!) Sicherung der vorhandenen DirectFax-Bibliotheken starten Sie aus dem selben Menü den Punkt 3 Update-Installation (neuere Version von DirectFax einspielen).

   Sie können auch ohne Gefahr Menüpunkt 4 Update-Installation nach Umbau des Systems auf RISC-Technologie oder 5 wählen. Derzeit gibt es im Ablauf dort keine Unterschiede.

9. Nach ca. 10-30 Minuten wird die erfolgreiche Installation gemeldet und Sie können das Installationsprogramm mit F3 verlassen.

10. Bitte melden Sie sich danach mit SIGNOFF *LIST ab, damit das Joblog der Installation als Spooldatei in OUTQ QEZJOBLOG gerettet wird (bitte nicht ausdrucken!).

11. Sollte es während der Installation zu Abbruchfehlern kommen, dokumentieren Sie diese auf jeden Fall per Hardcopy. Im Anhang finden Sie eine Beschreibung für die Lösung von Installationsproblemen.

12. Falls auf der Toolmaker Website Zusatzkorrekturen (z. B. ein kumulatives PTF) zu der gerade installierten Version angeboten werden, sollten Sie diese jetzt in der dort beschriebenen Weise installieren.

13. Jetzt können Sie sich wieder mit normalem Namen und Kennwort anmelden und DirectFax wieder starten (STRDIRFAX oder GO FAXOPR Menüpunkt 1). Falls erforderlich, können Sie hier auch den TCPSERVER von DirectFax starten (Menüpunkt 3).

14. Falls Sie den DirectFax PCL-Konverter im Einsatz haben und Spooldateien mit *USERASCII Datenstrom über Autofax versenden, sollten Sie die verschiedenen Belegarten testen. Durch die permanente Weiterentwicklung der PCL Serverprogramme kann es durch Rundungsdifferenzen oder geänderte Routinen zu Abweichungen im Layout kommen. Falls Autofax die Faxnummer oder Mailadresse nicht mehr finden kann und einen ^FAX Error meldet, müssen Sie mit Befehl WRKATFDEF bei der betreffenden Definition eine aktuelle PCL Spooldatei importieren und den Schlüssel (blaue Umkehranzeige) neu setzen.

    Wenn Sie den PCL-Konverter nicht nutzen, erstellen Sie ein einfaches Testfax und senden Sie es an Ihr hausinternes Faxgerät. Wenn das erfolgreich war, geben Sie DirectFax für alle Benutzer wieder frei.

Installation des HOTFIX20200811

Wenn die Version 5.92 installiert ist, dann muss noch das Hotfix installiert werden.

Hierfür wurde im Schritt Upload der benötigten Dateien auf die IBM i via FTP in die Bibliothek QGPL (oben) die SavF-QGPL/TMSHOTPTF erstellt.

Diese muss jetzt mit den folgenden Befehlen verarbeitet werden.

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/TMSHOTPTF) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(QTEMP) OUTPUT(*PRINT)
CALL QTEMP/HWHOTPTFI

Nach diesen Befehlen ist das Hotptf installiert.

In der SAVF-DIRECTFAX/PTFjjmmtt sind die vorherigen Versionen der Objekte enthalten, die vom PTF ausgetauscht wurden.

Konfiguration des Faxmail-Programmes

Wenn die Version 5.92 mit dem Hotfix installiert ist, dann muss directfax für den Versand über die Microsoft 365 Server konfiguriert werden

Befehl CFGFAXMAIL

CFGFAXMAIL, F10, einmal vorwärts blättern

...

Die folgenden Einträge werden Ihnen vom Microsoft 365-Administrator gegeben:

• SMTP Server - ist meistens “smtp.office365.com”, kann aber anders sein

• SMTP Benutzer - wir Ihnen mitgeteilt

• SMTP Kennwort - wird Ihnen mitgeteilt

Die folgenden Einträge sind zu vergeben:

• TCP/IP Port für SMTP - *SMTPS oder 587

• SSL verwenden - *YES

• SMTP AUT Verfahren - *LOGIN oder *AUTO

ENDDIRFAX WAIT(60) RESTART(*YES)

Konfiguration in Microsoft 365

Basic Authentication (wieder) freigeben

Wie oben beschrieben wurde die Basic Authentication - die wir ja benutzen - von Microsoft Anfang 2023 de-aktiviert. Sie muss nun wieder freigegeben werden.

Das ist eine Anforderung an die Microsoft 365 Administratoren. Eine Hilfestellung dazu gibt es hier im Wiki: Microsoft Exchange 365 - Keine Basic Authentication mehr ab Oktober 2022

Berechtigungen “im Namen von” zu senden

Beim E-Mail-Versand meldet sich ja die IBM i mit einem bestimmten Microsoft 365-Benutzer an. Als Absender steht in den E-Mails aber regelmässig irgend eine andere Adresse. Das ist wichtig, damit der/die Empfänger:in einfach per “Antworten” auf das E-Mail antworten kann und dabei den richtigen Adressaten vorgelegt bekommt.

Die Berechtigung, im Namen eines anderen Benutzers zu senden muss in Microsoft 365 explizit vergeben werden.

Ein Hinweis, dass der E-Mail Versand scheitert, weil die Berechtigung nicht vorliegt, findet sich im SMTP-trace: 504 5.7.4 - not allowed to send as anonymous.

Weitere Anpassungen

Es können weitere Anpassungen in Microsoft 365 erforderlich sein (Berechtigung für öffentlichen Ordner, …)

Welche das sind kann man dem SMTP-trace (s. unten) entnehmen. Dort findet man Fehlermeldungen des SMTP-Servers, die das Problem jeweils beschreiben.

Anhang

Anchor
#SMTPTRACE #SMTPTRACE

Fehlersuche mit dem SMTP-Trace

Wenn der SMTP-Trace eingeschaltet ist, dann erzeugt der Job FAXMAIL Protokolle mit der Kommunikation zwischen der IBM i und dem SMTP-Server.

Das Einschalten des SMTP-Trace und, wo man die trace-Daten findet ist hier beschrieben: directfax Fehlersuche und -behebung

Fehler beim update auf Version 5.92 beheben

Abbruchfehler

Sollte es während der Dateikonvertierungen zu Abbruchmeldungen kommen, weil die zu konvertierende Datei doch von laufenden Anwendungen benutzt und damit offen gehalten wird oder nicht gelöscht werden kann, weil fremde logische Dateien im Spiel sind, notieren Sie sich den Namen der bemängelten Datei und den Namen des abgestürzten Programms (CVTxxxxxxx) und beantworten Sie diese und die Folge-Meldungen mit. ‘C’ (Cancel/Abbruch), bis Sie wieder im Install.-Menü sind.

Joblog prüfen

Dann prüfen Sie mit Abruf/3 und Auswahl 10 und dann F10 und F18 das Joblog und ermitteln die Fehlerursache. Ggf. verwenden Sie von einer anderen Sitzung WRKOBJLCK, um die aktiven Benutzer herauszufinden.

Wiederanlauf

Nachdem Sie den Fehler beseitigt haben, machen Sie einen Wiederanlauf der DirectFax-Installation. Falls Sie während der Fehlersuche auch das Install.-Programm verlassen hatten, geben Sie INSTDIRFAX ein. Wählen im Install.-Menü den Punkt 6 (Wiederanlauf). Das Install.-Programm wird bei der Dateikonvertierung genau bei der abgebrochenen Datei wieder aufsetzen.

Überlegungen zur Nutzung eines iASP

DirectFax wurde ab Version 5.91 so geändert und erweitert, dass es in einem iASP (independent Auxiliary Storage Pool ) installiert und genutzt werden kann.

Man verwendet einen iASP in der Regel, um die Systemverfügbarkeit zu erhöhen. Die Daten des iASP sind dann außerhalb der lokalen iSeries physisch in einem anderen System gespeichert.

Der iASP wird aus der Sicht der lokalen iSeries wie eine Einheit angehängt und dem Job zugeordnet. Die Bibliotheken und Dateien im iASP sind also nicht automatisch und immer online!

Außerdem können manche Systemobjekte nicht in den iASP gespeichert und andere dort vorhandenen Objektarten nicht benutzt werden. Ab i5/OS V5R2 ist die Funktion seitens IBM verfügbar, wurde aber in V5R3 nochmals bezüglich der erlaubten Objektarten geändert.

Die Anpassungen in DirectFax betreffen alle Programme, die Objekte aus Sicherungsdateien zurückspeichern, da hier in jedem Einzelfall die Parameter RSTASP und RSTASPDEV geprüft und richtig gesetzt werden müssen. Außerdem sind die im iASP nicht nutzbaren DirectFax Objekte in die Bibl. QGPL verschoben worden. Dies sind im Einzelnen:

• *SBSD DIRECTFAX (bisher in DIRECTFAXF)

• *JOBQ DIRECTFAX (bisher in DIRECTFAX)

• *JOBQ TCPJOBQ (bisher in DIRECTFAXF)

• *JOBD DIRECTFAX (bisher in DIRECTFAX)

• *JOBD STRDIRFAX (bisher in DIRECTFAX)

• *JOBD STRTCPSRV (bisher in DIRECTFAX)

Die aufgelisteten Objekte werden bei der Installation einmalig neu erstellt und können dann bei Bedarf durch den EDV-Verantwortlichen angepasst werden.

Die Erstellung fehlender Objekte kann manuell mit folgenden Befehlen jederzeit aufgerufen werden (es wird empfohlen, mit QSECOFR angemeldet zu sein, zumindest ist *ALLOBJ erforderlich):

ADDLIBLE DIRECTFAX

CALL INZDIRFAX

Voraussetzungen für DirectFax im iASP sind:

1. Beide Bibliotheken (DIRECTFAX und DIRECTFAXF) müssen im iASP gespeichert werden, nicht nur eine von beiden.

2. Der iASP muss bereits bei Systemstart (in QSTRUP) mittels Befehl

   VRYCFG CFGOBJ(IASP33) CFGTYPE(*DEV) STATUS(*ON)

   angehängt werden.

3. In allen JOB-Beschreibungen der Benutzer und Batchjobs, die auf DirectFax im iASP zugreifen wollen, muss der folgende Parameter gesetzt sein (das betrifft auch die Jobbeschreibungen von DirectFax, die oben aufgelistet wurden):

   ASP-Anfangsgruppe . . . . . . . INLASPGRP IASP33

   Achtung: In IBM-Jobbeschreibungen wie z. B. QDFTJOBD darf nie ein iASP-Name angegeben werden, da sonst ernsthafte Probleme beim Anmelden eines Benutzers auftreten können.

4. Alternativ kann ein Job den iASP explizit mit folgendem Befehl zuweisen:

   SETASPGRP ASPGRP(IASP33)

5. Das IFS-Verzeichnis /Toolmaker muss sich im iASP befinden. Das i5/OS regelt das durch den vorangestellten Pfad /IASP33.

Bei der Installation von DirectFax in einen iASP sind folgende Abweichungen von der normalen Installationsfolge zu beachten:

1. Bei einer Update-Installation müssen sich die beiden Bibliotheken DIRECTFAX und DIRECTFAXF bereits im iASP befinden. Auch das IFS-Verzeichnis /Toolmaker muss schon unter /IASP33 positioniert sein.

2. War DirectFax bisher im ASP 1 aktiv und soll das Produkt zukünftig in einem iASP laufen, müssen prinzipiell folgende Schritte manuell gemacht werden, bevor die Installation von DirectFax startet:

   CRTSAVF ...

   SAVLIB DIRECTFAX ...

   CRTSAVF ...

   SAVLIB DIRECTFAXF ...

   DLTLIB DIRECTFAX

   DLTLIB DIRECTFAXF

   RSTLIB DIRECTFAX aus SAVF in den iASP

   RSTLIB DIRECTFAXF aus SAVF in den iASP

   Kopieren des IFS Verzeichnisses /Toolmaker unter /IASP33 und anschließende Löschung im normalen IFS.

   Hinweis:

   Es gibt keine Möglichkeit, die beiden Bibliotheken mit MOVOBJ oder anderen Befehlen direkt in den iASP zu schieben.

3. Bei der eigentlichen Installation wird die Rückspeicherung in einen iASP beim Aufruf von INSTDIRFAX F4 mit den Parametern ASP und ASPDEV bestimmt. Das bedeutet, wenn in einen iASP installiert werden soll, muss nach dem Übertragen der Installationsbibliotheken SAVPRODFAX etc. ins System, ein manueller Aufruf INSTDIRFAX F4 mit Angabe der ASP-Parameter erfolgen. Die LODRUN-Automatik kann nicht verwendet werden.

4. Sollte es in der Archivierungsschnittstelle CFGFAXARC Pfadangaben zum IFS geben, müssen diese so geändert werden, dass /IASP33 am Anfang steht. Das gilt nicht für QDLS.

Die Unterstützung für iASP wurde neu in DirectFax integriert, noch liegen aber keine Erfahrungen aus der Praxis vor (Stand 06/2009).