Inhaltsübersicht

Benutzerbefehle

WRKEML mit E-Mails arbeiten

Mit dem Befehl WRKEML kann man mit den E-Mails einer Mailbox arbeiten.

Mailbox (MAILBOX) - Eingabe der Mailbox.

CHGDMLLNG - Spracheinstellungen der IBM i - Anzeigen ändern

Mit dem Befehl CHGDMLLNG können die Spracheinstellungen der IBM i geändert werden.

Neue directmail Sprache (NEWLANG) - Sprache, die verwendet werden soll

Senden und Empfangen von E-Mails, Verarbeitung von Attachments

SNDSPLEML - Spooldatei via E-Mail senden

Ist der Name der Spooldatei bekannt, können diese mit dem IBM i-Befehl SNDSPLEML versandt werden.

Spool-Datei (FILE) - Der Name der anzuhängenden Spooldatei.

Jobname, Benutzer, Nummer (JOB)  - Die Jobinformationen der Spooldatei (kann über den IBM i-Befehl WRKSPLF angezeigt werden).

Spool-Dateinummer (SPLNBR) - Die laufende Spool-Nummer des Jobs.

Spool-Datei löschen (DLTSPLF) - Hier bestimmen Sie, ob die Spool-Datei nach Versand gelöscht werden soll.

Ausgabeformat (FORMAT) - Geben Sie an, in welches Format die Spooldatei konvertiert werden soll: PDF, HTML, Text-Datei, usw.

Seitenbereich von-bis (PAGERANGE) - Hier können Sie auswählen ab welcher Seite und bis zu welcher Seite die Spooldatei angehängt werden soll.

CSV Spaltentrennung (CVSTAB) - Hier steuern Sie die Spaltentrennung.

Editor aufrufen (EDIT) - Steuern Sie hier, ob der Editor zur Ergänzung der E-Mail um Betreff, Text und weiteren Informationen aufgerufen werden soll.

Mailbox (MAILBOX) - Der Name der Mailbox über die diese Spooldatei versandt werden soll. *CURRENT spezifiziert die aktuelle Mailbox des Benutzers

Absender Name (SENDER) - Geben Sie hier den Namen des Absenders, bzw. den Sonderwert *MAILBOX ein um die dem Benutzerdaten aus der zugeordneten Mailbox zu verwenden.

Empfänger (RCVR) - Geben Sie hier die E-Mail-Adresse des Empfängers ein.

Betreff (SUBJECT) - Hier steht der Betreff der E-Mail.

Nachrichtentext (TEXT) - Hier können Sie mit der E-Mail einen Nachrichtentext mit senden.

Uhrzeit für Versand (SCDTIME) - Soll eine E-Mail zeitgesteuert versandt werden, können Sie hier Datum und Uhrzeit angeben. Andernfalls wird die E-Mail sofort verschickt.

Datum für Versand (SCDDATE) - Soll eine E-Mail zeitgesteuert versandt werden, können Sie hier Datum und Uhrzeit angeben. Andernfalls wird die E-Mail sofort verschickt.

Nur Text verwenden (TEXTONLY) - Hier steuern Sie, dass bei Spooldateien nur der reine Text ohne Grafiken und sonstige Elemente verwendet werden.

Grüne Balken (GREENBAR) – bei HTML-Format - Geben Sie an, ob die Zeilen im HTML-Format durch weiß/grüne Balken getrennt werden sollen (Ergibt den Effekt wie Druck auf Tabellierpapier).

Seitentabelle (PAGETABLE) -Inhaltsverzeichnis einfügen

Papiergröße (PAPERSIZE) - Gibt die Papiergröße für die Erstellung der PDF-Datei an. Dieser Parameter steht nur bei FORMAT(*EPDF) zur Verfügung.

Querformat (ROTATION) - Gibt an, ob das Formular im Querformat beschrieben werden soll. Dieser Parameter steht nur beim Format *EPDF zur Verfügung.

CPI (CPI) - Hier können Sie eine von der Spooldatei abweichende Schriftbreite in CPI (Zeichen pro Zoll angeben).

LPI (LPI) - Hier können Sie eine von der Spooldatei abweichende Schrifthöhe in LPI (Zeilen pro Zoll angeben).

PDF-Font (FONT) - Geben Sie hier die zu verwendende Schriftart bei der Konvertierung in PDF an.

Codepage CCISD (CCSID) - Bei der Unicode-Konvertierung steuert die CCSID die korrekte Darstellung der Zeichen im PDF-Format.

PDF/A erstellen - Bei der Angabe von FORMAT(*EPDF) können Sie hier die Kompatibilität zu PDF/A-Normen einstellen.

Text Ursprungskoordinaten (PDFAREA) - X-Achse mm

Formular erste Seite (OVERLAY) - Geben Sie hier den Namen des Formulars ein, welches der PDF-Datei hinzugefügt werden soll. Diese Datei muss im FORMS-Verzeichnis von DirectMail400 abgelegt sein. Dieser Parameter ist nur bei Verwendung des *EPDF-Formates möglich.

Formular Position (MARGINS) - Geben Sie hier die Ränder ein, mit denen die Grafik wie gewünscht ausgerichtet werden soll.

Formular Folgeseiten (OVERLAY2) - Geben Sie hier das Formular für die Folgeseiten ein.

Formular Position (MARGINS2) - Geben Sie hier die Ränder ein, mit denen das Formular ausgerichtet werden soll.

PDF Sicherheitseinstellungen (PDFSEC) - Hier geben Sie die Einstellungen für verschlüsselt versandte PDF-Dateien an: Erlaubnis zu drucken, ändern, kopieren, usw.

CCSID der Parameter (PARAMCCSID) - Hier geben Sie die Einstellungen für verschlüsselt versandte PDF-Dateien. Über diesen Wert kann angegeben werden, in welcher CCSID die Parameter an den Befehl übergeben werden.

Alias Dateiname (ALIAS) - Hier können Sie einen Alias-Dateinmaen angeben.

Editor

Wurde der Parameter  „Editor aufrufen" (EDIT) auf *YES gesetzt, öffnet sich nun der Editor zur Eingabe weiterer Informationen.:

APIs zum Senden von Emails

Mit den CL-Befehlen OPNEMLAPI, WRTEMLAPI und CLSEMLAPI können Sie Emails "zusammensetzen" und versenden. Zum Inhalt solcher Mails können Sie hinzufügen

• Text

• Druckdateien (SPLF)

• IBM i Sicherungsdateien (SAVF)

• IFS-Objekte

Die Beschreibung der API-Befehle finden Sie auf der Seite E-Mail APIs - E-Mails automatisiert erstellen und versenden

SNDOBJEML - Ein Objekt per E-Mail senden

Der Befehl SNDOBJEML ist Teil der Lizenz Gruppe Batch- und Spool APIs, kann aber auch statt der Batch- und Spool APIs zu einem günstigeren Preis separat lizenziert werden (Code OBJ).

Als Alternative zu den Batch- und Spool APIs,  die sehr viele Optionen haben, gibt es eine vereinfachte Form des E-Mail Versands von IFS Objekten (PC-Dateien wie z.B. PDF), die bereits existieren. Hier erfolgt keine Konvertierung. Die Parameter sind an den Befehl SNDSPLEML angelehnt, nur dass hier alle Angaben für die Konvertierung von Spooldateien weggelassen wurden.

Open

sndobjeml1 – IFS Datei via E-Mail senden Bild 1

IFS Objekt (OBJ) - Pfad incl. Datei, wo sich die existierende PC-Datei (z.B. PDF) im IFS befindet. Die Länge des Eingabefelds ist auf 100 Stellen begrenzt.

IFS Datei löschen (DELETE) - Hier bestimmen Sie, ob die IFS Datei nach dem Erstellen der E-Mail gelöscht werden soll. In der Regel bleibt die Datei bestehen, da sie von einem fremden Prozess erstellt wurde.

Editor aufrufen (EDIT) - Steuern Sie hier, ob der Editor zur Ergänzung der E-Mail um Betreff, Text und weiteren Informationen aufgerufen werden soll.

Mailbox (MAILBOX) - Der Name der Mailbox über die diese Spooldatei versandt werden soll. *CURRENT spezifiziert die aktuelle Mailbox des Benutzers. Das funktioniert aber nur, wenn jeder Benutzer seine eigene Mailbox hat. Gibt es nur eine zentrale Mailbox, muss hier der Name (ohne Stern) angegeben werden.

Absender Name (SENDER) - Geben Sie hier den Namen des Absenders, bzw. den Sonderwert *MAILBOX ein um die Benutzerdaten aus der zugeordneten Mailbox zu verwenden.

Empfänger (RCVR) - Geben Sie hier die E-Mail-Adresse des Empfängers ein. Mit *SELECT bestimmen Sie, dass die Adresse später aus einem Adressbuch ausgewählt oder vom Benutzer direkt eingetippt wird (siehe bei Editor weiter unten).

Betreff (SUBJECT) - Hier steht der Betreff der E-Mail. Er kann 256 Stellen lang sein.

Nachrichtentext (TEXT) - Hier können Sie mit der E-Mail einen Nachrichtentext mitsenden (Mailbody). Es sind theoretisch 120 Zeilen mit jeweils 78 Zeichen erlaubt. Falls es sich bei dem Befehlsaufruf um einen Batch Vorgang handelt, muss der Buffer entsprechend groß gewählt werden (allein der Bereich TEXT benötigt 9362 Bytes).

Uhrzeit für Versand (SCDTIME) - Soll eine E-Mail zeitgesteuert versandt werden, können Sie hier Datum und Uhrzeit angeben. Andernfalls wird die E-Mail sofort verschickt.

Datum für Versand (SCDDATE) - Soll eine E-Mail zeitgesteuert versandt werden, können Sie hier Datum und Uhrzeit angeben. Andernfalls wird die E-Mail sofort verschickt.

Editor

Wurde der Parameter „Editor aufrufen" (EDIT) auf *YES gesetzt, öffnet sich nun der Editor zur Eingabe weiterer Informationen. Das gilt auch, wenn beim Empfänger (RCVR) *SELECT angegeben wurde. Editor und Select Optionen können nur in einem interaktiven Job genutzt werden, bei Batch Jobs müssen alle Empfänger und Textinformationen durch das Programm übergeben werden.

Open

sndobjeml4 - Anzeige des Editors

SELSPLFSND - Zu verwendendes E-Mail-System beim Versenden auswählen

Der Befehl SELSPLFSND dient zur Auswahl des zu verwendenden Mail Systems.

finden Sie die Texte unter DSPSPLF + F4 + F1 (IBM-Befehlsbeschreibung)

Spool-Datei (FILE) - Eingabe der Spool-Datei, deren Sätze angezeigt werden sollen.

Jobname (JOB) - Eingabe der relevanten Jobdaten.

Spool-Dateinummer (SPLNBR) - Eingabe der relevanten Spool-Dateinummer.

Mail System (MAILSYS) - Eingabe des entsprechenden Mail Systems.

EXPEMLATT -  Ein E-Mail Attachment in's IFS exportieren

Mit Hilfe des Befehles EXPEMLATT können Sie per Befehl einen Anhang aus einer empfangenen E-Mail exportieren, ohne dass Sie die E-Mail vorher öffnen müssen. Der Anhang wird im IFS gespeichert.

Mail-ID (MAILID) - Geben Sie hier die 20-stellige Mail-ID ein, die jede E-Mail eindeutig identifiziert. Die 20-stellige Mail-ID bekommen Sie z.B. automatisch aus dem Mail-Eingangsassistenten mit der Funktion

*EXITPGM (Aufruf Benutzerprogramm).

Anhang Nummer (ATTID) - Identifizieren Sie hier die Nummer des Anhangs den Sie exportieren wollen.

IFS Pfad (PATH) - Geben Sie hier den Pfad vom IFS ein, unter den der Anhang abgelegt werden soll.

Objekt ersetzen (REPLACE) - Hier steuern Sie, ob ein eventuell vorhandenes Dokument im IFS überschrieben wird, oder nicht.

CRTSECPDF - PDF-Datei verschlüsseln

Dieser Befehl dient der Verschlüsselung von PDF-Dateien die per E-Mail versandt werden. Damit ist es möglich vertrauliche Dokumente so zu schützen, dass nur der Empfänger mit den entsprechenden Kennwortdaten diese Datei öffnen kann. Die Verschlüsselung ist mit bis zu 128 bit möglich. Zertifikate werden bei dieser Verschlüsselung nicht unterstützt.

Hinweis: Auch bei einer 128 Bit Verschlüsselung diese nur so gut und sicher wie das verwendete Kennwort. Verwenden Sie deshalb ein möglichst langes Kennwort mit gemischten Zeichen- und Ziffernkombinationen.

PDF-Datei (OBJ) - Geben Sie hier Verzeichnis und Namen der unverschlüsselten PDF-Datei an.

Neue PDF-Datei (TOOBJ) - Geben Sie hier Verzeichnis und Name der verschlüsselten PDF-Datei an.

Datei ersetzen (REPLACE) - Wenn die Datei bereits vorhanden ist, kann sie ersetzt werden.

Aktuelles Eigner-Kennwort (CURPWD) - Hier steht das aktuell gültige Eigner-Kennwort für diese Datei. Dieses Kennwort benötigen Sie, wenn die Datei bereits mit einem Kennwort geschützt ist um die nachfolgenden Attribute zu verändern.

Drucken erlauben (PRINT) - Hier legen Sie fest, ob der Empfänger die Datei drucken darf.

Modifizieren erlauben (MODIFY) - Hier legen Sie fest, ob der Empfänger die Datei mit Adobe Acrobat verändern darf.

Kopieren erlauben (COPY) - Hier legen Sie fest, ob der Empfänger die Inhalte der Datei über Cut & Paste kopieren darf (Screenreader).

Kommentare erlauben (ANNOTS) - Hier legen Sie fest, ob der Empfänger mit Adobe Acrobat Kommentare einfügen bzw. ändern darf.

Formularfelder erlauben (FORMS) - Hier legen Sie fest, ob der Empfänger mit Adobe Acrobat Formularfelder einfügen bzw. ändern darf.

Zugriff auf Inhalt erlauben (ACCESSIBLE) - Hier legen Sie fest, ob der Empfänger auf den Inhalt der PDF-Datei mit z.B. Screenreadern zugreifen darf (ab Acrobat Version 5).

Zusammenstellung erlauben (ASSEMBLE) - Hier legen Sie fest, ob der Empfänger mit Adobe Acrobat Seiten einfügen, Löschen oder Drehen darf, oder ob Tumbnails und Bookmarks eingefügt werden dürfen.

Hochauflösenden Druck erlauben ( HIRESPRINT) - Hier legen Sie fest, ob der Empfänger den Inhalt der PDF-Datei hochauflösend, oder nur als Raster mit geringer Auflösung drucken darf.

Schlüssellänge (KEYLENGTH) - Hier legen Sie die Länge des Schlüssels fest mit der die PDF-Datei verschlüsselt wird.

Eigner-Kennwort (MASTERPWD) - Hier können Sie ein neues Kennwort für den Besitzer des PDF-Dokumentes vergeben. Ein Eigner-Kennwort ist notwendig um die Attribute der PDF-Datei verändern zu können.

Benutzer-Kennwort (USERPWD) - Hier können Sie ein Benutzer-Kennwort festlegen mit dem die PDF-Datei geöffnet und im Rahmen der durch den Eigner festgelegten Einschränkungen bearbeitet werden darf.

SGNOBJ - Ein Objekt signieren

Der Befehl SGNOBJ dient der qualifizierten elektronischen Signierung von beliebigen IFS-Objekten. Die Signatur erfolgt mittels directcard und Kartenterminal. Für diesen Befehl ist eine API und Kryptografie API Lizenz notwendig.

IFS Objekt (OBJ) -

Geben Sie hier ein beliebiges IFS-Objekt ein.

IFS Signatur-Objekt (SGNOBJ) - Nach erfolgreicher Signierung wird eine Signaturdatei dem hier angegebenen Namen erstellt (Die Standard-Erweiterung für Signaturobjekte ist .pkcs7).

Smart Card Terminal (TEMINAL) - Hier legen Sie fest, mit welchem Terminal Sie die Signierung des Objektes durchführen wollen. Geben Sie dazu den Namen aus der Terminalkonfiguration (aus DIRCARD/WRKCRDTRM) ein.

Zertifikat (CERT) - Dieser Parameter bietet die Möglichkeit mit DirectCard und Soft-Zertifikaten ein Objekt zu signieren.

Kennwort (PASSWORD) - Eingabe eines Kennwortes für die Signierung.

Objekt ersetzen (REPLACE) - Falls das Signaturobjekt von einer früheren Signierung bereits existiert, können Sie dieses mit diesem Parameter bei erneuter Signierung überschreiben.

Karten-Nr. (CARD) - Hier können Sie die Signierung auf eine bestimmte SmartCard einschränken, geben Sie dazu die Karten-Nr. ein. Die aktuell eingelegte Karte können Sie mir DIRCARD/WRKCRDTRM und Auswahl 15 vor dem Terminal auslesen.

Referenz Text (REF) - Hier können Sie einen Text eingeben, der bei Signatur des Objektes am Terminal angezeigt wird.

Hash Algorithmus (HASHALGO) - Der Hash Algorithmus dient zur Berechnung eines eindeutigen Prüfwertes. Unterstützt werden die Werte SHA1 bzw. SHA256.