Z-MAILAX

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

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:

  1. Z-MLDFLT (ändert die Versandvorgaben und/oder definiert eine suspendierte Zustellung von Transport Service-Objekten).

  2. Z-MAILAX.

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

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.

Return-Codes

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

Subprogramme

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)

Beispiel

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