Dieses Dokument behandelt die folgenden Themen:
Anwendung, Dokument, Memo, Menü, Telefonnotiz, Prozedur, Programm, Referenzdokument oder Benutzerobjekt versenden.
Dieses Subprogramm entspricht Z-MAILA mit der Ausnahme, dass der Parameter Objekt-ISN das Format P10 hat.
Mit Z-MAILAX können Sie keine Post weiterleiten oder beantworten. Das gewünschte Objekt wird als normale Post gesendet. Die Empfängerangabe für externe Empfänger wird nicht überprüft. Externe Post kann nur unter Benutzung eines Rufnamens versendet werden; in diesem Fall muss die physische Adresse (z.B. Telexnummer) vollständig definiert sein.
Z-MAILAX kann zusammen mit anderen API-Subprogrammen benutzt werden. Die Subprogramme sollten in der folgenden Reihenfolge aufgerufen werden:
Z-MLDFLT (ändert die Versandvorgaben und/oder definiert eine suspendierte Zustellung von Transport Service-Objekten).
Z-MAILAX.
Z-CNFIRM (wenn suspendierte Zustellung von Transport Service-Objekten definiert wurde).
Sie können ein Objekt an bis zu 12 Empfänger senden. Um das Objekt an weitere Empfänger zu senden, können Sie dieses Subprogramm erneut aufrufen; in diesem Fall dürfen Sie nur weitere Empfänger und die jeweilige Versandart angeben.
Wenn Sie ein Memo senden, müssen Sie die Parameter Empfaenger, Begleitschreibentext, Buero, Betreff und Objektnummer (in diesem Fall ist die Objektnummer 11) angeben. Sie müssen die Parameter Objektname und Objekt-ISN leer lassen.
Wenn Sie eine Telefonnotiz senden, müssen Sie die Parameter Empfaenger, Begleitschreibentext, Buero, Betreff und Objektnummer (in diesem Fall ist die Objektnummer -11) angeben. Sie müssen die Parameter Objektname und Objekt-ISN leer lassen. Wenn die Telefonnotiz gesendet wird, wird sie beim Empfänger in den Ordner Telefon des Fachs Posteingang gestellt. Wenn Sie eine Telefonnotiz auf diese Art senden, wird der "Telefonnotiz senden"-Schirm nicht aufgerufen. Daher müssen Sie alle notwendigen Informationen (z.B. Anrufer und dessen Telefonnummer) im Parameter Betreff eingeben.
Es können unterschiedliche Adresstypen erstellt werden, die alle denselben Namen tragen (z.B. können ein Teilnehmerkennzeichen und der Name eines Verteilers gleich sein). Wenn Sie keinen Adresstyp angeben und Empfänger mit denselben Namen aber unterschiedlichen Adresstypen gefunden werden, versucht dieses Subprogramm zuerst, an Adresstyp 33 (Teilnehmerkennzeichen) zu senden und dann an Adresstyp 5 (Büro). Andere Adresstypen werden nicht berücksichtigt. Wenn z.B. ein Empfänger mit dem gewünschten Namen bei Adresstyp 33 gefunden wird, wird an diesen Empfänger gesendet. Wenn nicht, wird versucht an Adresstyp 5 zu senden. Wenn bei beiden Adresstypen kein Empfänger mit dem gewünschten Namen gefunden wird, wird der Return-Code 34 ausgegeben.
Im Fach Tageskopien wird für die Post ein Eintrag erstellt, der anschließend für jeden Empfänger kopiert wird. Wenn die Post gesendet wird, wird der Parameter Objekt-ISN auf die *ISN des Tageskopieneintrags gesetzt und der Parameter Objektname wird zurückgesetzt. Wenn kein Empfänger gefunden wird, wird der Return-Code auf 21 gesetzt und das Kennzeichen wird an das aufrufende Programm zurückgegeben.
Z-MAILAX erstellt eine Empfängerliste und führt eine eingeschränkte Berechtigungsprüfung durch (d.h. überprüft werden die Adressierstufe, die Anzahl der Empfänger sowie die Zugriffsberechtigung für das Büro, aus dem gesendet wird, und die Zugriffsberechtigung für das Objekt, das gesendet werden soll).
Wenn Sie Post aus einem Gruppenbüro oder einem offenen Büro senden, wird Ihr Teilnehmerkennzeichen als Absender angegeben (nicht das Kennzeichen des Büros, aus dem die Post versendet wurde). Diese Beschreibung gilt nicht für Post, die Sie aus einem Privatbüro oder einem unabhängigen Büro senden.
Wenn ein anderer Wert als 0 im Parameter Return-Code ausgegeben wird, erfolgt immer ein BACKOUT TRANSACTION.
Wenn Sie ein Memo oder ein Objekt mit einem Begleitschreiben senden, benutzt Z-MAILAX automatisch den Arbeitsbereich, der mit DEFINE PRINTER (1) OUTPUT 'SOURCE' definiert wurde.
Wenn Sie mit diesem API-Subprogramm externe Post versenden (z.B. SNADS), ist es unbedingt erforderlich, dass X-0INIT nach dem Ausführen von Z-MAILAX aufgerufen wird. X-0INIT ruft X-FZ auf, um die externe Post auf die Empfängerknoten zu übertragen.
| Parameter | Format | Ein | Aus | Bemerkung |
|---|---|---|---|---|
| Return-Code | N2 | O | X | Eingabe -1: kein ET. Wenn Sie mit dem Transport Service Post an externe Empfänger senden, erfolgt ein END TRANSACTION (auch wenn im Parameter Return-Code -1 angegeben wurde). |
| Empfaenger | A20/1:12 | E | X | Die Namen oder Kennzeichen der Empfänger. |
| Adresstyp | N2/1:12 | O | Der Adresstyp muss einer der folgenden sein: 1=Adresse (Rufname), 4=Rubrik, 5=Büro, 10=Verteiler, 33=Teilnehmerkennzeichen, 70=Nachname, 74=Extern. | |
| Versandart | A1/1:12 | O | O=Original, C=Kopie, B=Blindkopie, P=persönliche Post. Vorgabe: O. In Gruppenbüros und offenen Büros dürfen Sie die Versandart P nicht benutzen. | |
| Buero | A8 | E | Das Büro, aus dem das Objekt gesendet werden soll. | |
| Passwort | A8 | E | Das Passwort des o.g. Büros. | |
| Absendername | A20 | Für den internen Gebrauch. | ||
| Objektnummer | N2 | E | Die Nummer für das zu sendende Objekt muss eine der folgenden sein: 2=Anwendung, 11=Dokument/Memo, -11=Telefonnotiz, 18=Menü, 24=Prozedur, 26=Programm, 27=Referenzdokument, 80 bis 99=Benutzerobjekt. | |
| Objektname | A32 | E* | Der Name des Objekts, das gesendet werden soll. Entweder Objektname oder Objekt-ISN, nicht beides. Bei einem Memo oder einer Telefonnotiz muss dieser Parameter leer sein. | |
| Objekt-ISN | P10 | E* | X | Eingabe: Die ISN des Objekts, das gesendet werden soll. Entweder Objekt-ISN oder Objektname, nicht beides. Bei einem Memo oder einer Telefonnotiz muss dieser Parameter leer sein. Ausgabe: Die ISN des Eintrags, der im Fach Tageskopien erstellt wurde. |
| Begleitschreibentext | A76/1:16 | O | Wenn Sie ein Memo senden, müssen Sie diesen Parameter füllen. | |
| Betreff | A60 | E | Der Betreff der Post. | |
| Work-Parameter | A128 | Für den internen Gebrauch. Siehe Work-Parameter. |
| 00 | Erfolg |
| 02 | Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt |
| 03 | Falsches Passwort |
| 04 | ISN wurde nicht gefunden |
| 08 | Geben Sie entweder ISN oder Name ein - nicht beides |
| 09 | ISN zeigt nicht auf ein Objekt |
| 21 | Empfänger nicht gefunden |
| 22 | Spoolfile-Eintrag kann nicht erstellt werden |
| 23 | Bürokennzeichen des Absenders wurde nicht gefunden |
| 24 | Datenschutz-Sicherheitsübertretung (falsche Stufe zum Senden) |
| 25 | Mehr Empfänger als im Büro des Absenders erlaubt sind |
| 26 | Dokumentname wurde im Büro des Absenders nicht gefunden |
| 27 | Begleitschreiben ist erforderlich |
| 28 | Betreff ist erforderlich |
| 29 | Begleitschreiben konnte nicht gesichert werden |
| 33 | Empfänger ist nicht eindeutig |
| 34 | Adresstyp wurde nicht gefunden |
| 91 | Dieser Objekttyp kann nicht gesendet werden |
| 92 | Sie können keine Objekte aus den Fächern Posteingang und Papierkorb versenden |
| 93 | Objekt-ISN oder Objektname kann mit einer Telefonnotiz nicht benutzt werden |
| 94 | Transport Service-Objekt konnte nicht erstellt werden |
Die Subprogramme, die von Z-CNFIRM aufgerufen werden, sind in dieser Liste nicht enthalten.
Z-110
Z-120
Z-122
Z-123
Z-135
Z-145
Z-147
Z-155
Z-165
Z-175
Z-185
Z-190
Z-191A
Z-194
Z-197A
Z-200A
Z-201
Z-202
Z-205
Z-207
Z-241
Z-1200&0
Z-CNFIRM (wird nur aufgerufen, wenn mit
Z-MLDFLT nichts gegenteiliges
definiert wurde)
0010 * 0020 * Anwendung, Dokument, Memo, Menue, Telefonnotiz, 0030 * Prozedur, Programm, Referenzdokument oder 0040 * Benutzerobjet versenden 0050 * 0060 DEFINE DATA 0070 LOCAL 0080 1 RETURN-CODE (N2) 0090 1 EMPFAENGER (A20/1:12) 0100 1 ADRESSTYP (N2/1:12) 0110 1 VERSANDART (A1/1:12) 0120 1 BUERO (A8) 0130 1 PASSWORT (A8) 0140 1 ABSENDERNAME (A20) 0150 1 OBJEKTNUMMER (N2) 0160 1 OBJEKTNAME (A32) 0170 1 OBJEKT-ISN (P10) 0180 1 BEGLEITSCHREIBENTEXT (A76/1:16) 0190 1 BETREFF (A60) 0200 1 WORK-PARAMETER (A128) 0210 * 0220 END-DEFINE 0230 * 0240 RESET RETURN-CODE 0250 MOVE 'Kennzeichen ' TO EMPFAENGER(1) 0260 MOVE 33 TO ADRESSTYP(1) 0270 MOVE 'O' TO VERSANDART(1) 0280 MOVE 'Rufname' TO EMPFAENGER(2) 0290 MOVE 01 TO ADRESSTYP(2) 0300 MOVE 'C' TO VERSANDART(2) 0310 * 0320 MOVE 'BUERO' TO BUERO 0330 MOVE 'PASSWORT' TO PASSWORT 0340 MOVE 11 TO OBJEKTNUMMER 0350 MOVE 1234567890 TO OBJEKT-ISN 0360 MOVE 'Begleitschreiben' TO BEGLEITSCHREIBENTEXT(1) 0370 MOVE 'Post' TO BETREFF 0380 * 0390 CALLNAT 'Z-MAILAX' 0400 RETURN-CODE 0410 EMPFAENGER(*) 0420 ADRESSTYP(*) 0430 VERSANDART(*) 0440 BUERO 0450 PASSWORT 0460 ABSENDERNAME 0470 OBJEKTNUMMER 0480 OBJEKTNAME 0490 OBJEKT-ISN 0500 BEGLEITSCHREIBENTEXT(*) 0510 BETREFF 0520 WORK-PARAMETER 0530 * 0540 IF RETURN-CODE EQ 0 0550 WRITE 'Dokument wurde versendet' 0560 ELSE 0570 WRITE 'Return-Code ' RETURN-CODE 0580 END-IF 0590 * 0600 END