Toolmaker Produkt-Dokumentation

directfax Checkliste - Befehl FAXOBJ

Owned by Robert E. Schneider
Last updated: Oct 29, 2018
3 min read

DirectFax Checkliste FAXOBJ (PDF) (14.02.17/HW)

Anforderung

Eine PDF-Datei im IFS soll gefaxt oder per E-Mail gesendet werden.Dafür gibt es zwei Möglichkeiten:

  • Es wird der DirectFax Befehl FAXOBJ verwendet.
  • Es wird ein IFS-Monitor-Job verwendet

Voraussetzungen

Das Faxen von PDF aus der IBM i Umgebung erfordert

  1. eine aktuelle DirectFax Version 5.91r oder höher (siehe DSPDIRFAXV)
  2. die Bibl. DIRWEB in Version 1.34.03 oder höher
  3. den Betriebssystemzusatz PASE: Ob PASE installiert ist, kann unter GO LICPGM, Menüpunkt 10, geprüft werden: 5722SS1 33 OS/400 - Portable App Solutions Environment

Ab einer DirectFax Versions-Nummern 5.92 ist auch die Installation einer neueren Version von DirectWeb erforderlich (Bibl. DIRWEB ab Version 1.50.35 oder höher. Informationen zu Download und Installation finden Sie auf der Seite zu RPGWX (aka WOPiXX)

Ausgangslage (Fehlersituation)

"MIX-Warnung" in WRKFAXSTS

Das Fax steht mit MIX-Warnung in der Warteschlange und geht nach Freigabe mit 6 auf den Fehler Leerfax. An QSYSOPR kommt die Fehlermeldung Fehler in der Aufbereitung! RC x Dump erstellt!

E-Mail wird gesendet, hat aber keinen Anhang

Im Regelfall soll die PDF-Datei als Anhang an einem E-Mail mit einem Standardtext gesendet werden. In dieser Fehlersituation geht das Mail mit dem Standardtext auch 'raus, es hat aber keinen Anhang, sondern nur einen directfax - ^ATTACH-Befehl, der auf eine PDF-Datei im IFS hinweist (z.B. "^ATTACH/Toolmaker/DirectFax400/temp/FAXATT_939014BCE67BD6CCB57C2657A17C9536.pdf").

Vorgehen zur Fehlerbehebung

Nachfolgend werden die Prüfpunkte abgefragt, die erfüllt sein müssen, damit der automatisch generierte Code ^ATTACH im Fax die PDF-Datei erfolgreich faxen kann. Am besten arbeiten Sie die einfach schrittweise ab, ohne Rücksicht auf bekannte oder vermeintlich sichere Informationen.

Prüfpunkte auf der IBM i


  1. SIGNOFF machen und mit QSECOFR oder einem Profil mit entspr. Rechten neu anmelden, um alle nachfolgenden Schritte ausführen zu können.
  2. Lizenzprüfung mit CHKDIRFAX bzw. DSPLICINFO ab Version 6.00.Es sollte DF450=1 bzw. FULL angezeigt werden, dann ist eine Hauptlizenz vorhanden ist. Bei 0 bzw. LITE fehlt diese.
  3. Versionsprüfung mit DSPDIRFAXV. Es sollte mindestens 5.91r vorhanden sein. Dazu passend muss Bibl. DIRWEB in Version 1.34.03 auf dem System installiert sein (siehe WRKLIB DIRWEB). Ab DirectFax Version 6.00 ist die Version 2.00 oder höher der Bibl. DIRWEB erforderlich.
  4. Mit CHGFAXVAL F4 auf Seite 2 den Parameter Faxmodem-Unterstütz. (MIXALL) prüfen. Er muss auf *YES oder *EXT stehen (aber nicht einfach nicht ändern!). Falls er auf *NO steht, wird vermutlich noch die alte DCE Faxbox verwendet und eine Nutzung von FAXOBJ ist nicht ohne andere Maßnahmen möglich. Bitte in diesem Fall mit der Hotline sprechen.
  5. Fax mit Auswahl 5 anzeigen und nach ^ATTACH suchen. Der Code muss einen gültigen Pfad auf die tatsächlich existierende PDF-Datei enthalten. Die Rechte für den Benutzer DIRECTFAX dürfen in dem Pfad und in der Datei nicht eingeschränkt sein.
  6. Mit WRKENVVAR F4 bei JOB und bei *SYS sicherstellen, dass ein Eintrag *GS_LIB vorhanden ist. Fehlt dieser, wurde DirectFax nach einem Systemwechsel noch nicht richtig initialisiert. Das wird wie folgt gemacht:
    1. Als QSECOFR zumindest mit *ALLOBJ Rechten angemeldet sein
    2. ENDDIRFAX
    3. ADDLIBLE DIRECTFAX
    4. CALL INZDIRFAX
    5. STRDIRFAX
  7. CFGFAXMAIL F4 - sicherstellen, dass die Parameter für den Mailversand korrekt gesetzt sind. Erforderlich sind: MAILFMT(*TIFF) GRFFMT(*PDF).

Testfax senden

Nach Klärung der Prüfpunkte geht es im nächsten Schritt um ein Testfax. Dazu den Befehl FAXOBJ mit F4 verwenden und einen manuellen Faxvorgang anstoßen. Dabei auf den richtigen Pfad und den richtigen Namen für die PDF-Datei achten.

Prüfung von Fehlermeldungen

Falls das Testfax weiterhin auf MIX-Warnung und nach Freigabe auf Fehler Leerfax geht oder zwar versandt wird, den Inhalt der PDF-Datei aber nicht enthält, suchen Sie nach Fehlermeldungen an folgenden Stellen:

DSPMSG QSYSOPR, evtl. ist in der Meldung ein RC (Returncode) angegeben.

DSPMSG Benutzername (Eigentümer des Faxes)

WRKACTJOB, Auswahl 5 vor Job FAXMIX, Auswahl 10 Joblog, Taste F10.

Keine Fehler zu finden

Enthält das Fax den ATTACH Befehl als Text, dann fehlt das Zeichen "^" oder es gibt eine unerlaubte Leerstelle dahinter. Es kann auch sein, dass das Zeichen "^" einen falschen Hexcode hat (richtig wäre X'5F'). Denkbar ist auch, dass einer der Prüfpunkte nicht beachtet wurde.


Falls Sie das Problem trotz Checkliste nicht lösen können, schicken Sie die PDF-Datei als Anhang zusammen mit dem Joblog von Job FAXMIX und dem Hardcopy der QSYSOPR-Meldung an die Toolmaker Hotline und beschreiben Sie kurz den Fehler (hotline@toolmaker.de).