Dieses Dokument behandelt die folgenden Themen:
Post weiterleiten.
Die Post, die Sie weiterleiten wollen, muss sich im Fach Posteingang befinden (hierbei spielt es keine Rolle, ob die Post bereits gelesen wurde oder nicht). Sie können ein Dokument oder ein Memo weiterleiten.
Wenn Sie Post weiterleiten, die sich zur Zeit im Ordner Neu des Fachs Posteingang befindet, wird die dazugehörende Empfängerliste aktualisiert (d.h. der Empfangsstatus der Post weist nun darauf hin, dass die Post gelesen wurde) und die Post wird in den Ordner Gelesen gestellt. In diesem Fall erfolgt automatisch ein END TRANSACTION.
Sie müssen die Parameter Posteingang-ISN, Weiterleitungsliste und einen der Begleitschreiben-Parameter angeben. Der Parameter Posteingang-ISN muss die ISN der Post enthalten, die Sie weiterleiten. Um die gewünschte ISN zu erhalten, können Sie vor dem Aufruf dieses Subprogramms zum Beispiel Z-DIS13A aufrufen.
In der Weiterleitungsliste müssen Sie alle Empfänger angeben, an die Sie die Post weiterleiten wollen. Sie können bis zu 12 Empfänger angeben.
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 Sie als Empfänger eine Kombination aus Nachname und Vorname angeben, ist Z-FORWD in der Lage einen Ausdruck wie zum Beispiel "Long,Sonya", "Long,S", "Long,So" oder einfach nur "Long" zu erkennen - solange dieser Ausdruck eindeutig ist.
Der Parameter Erfolg weist darauf hin, ob ein Empfänger gefunden wurde oder nicht. Der Parameter Weiterleitungsoption legt fest, wie Z-FORWD reagieren soll, wenn ein Empfänger nicht gefunden wird. Wenn Sie für diesen Parameter den Wert 1 angeben, wird die Post an alle anderen Empfänger, die gefunden werden, weitergeleitet. Bei jedem anderen Wert, oder wenn mindestens ein Empfänger nicht gefunden wird, wird der Return-Code 21 ausgegeben und die weiteren Empfänger werden nicht überprüft.
Die Begleitschreiben*-Parameter bieten verschiedene Möglichkeiten, ein Begleitschreiben für die weitergeleitete Post zu erstellen. Sie dürfen nur einen dieser Parameter angeben.
Wenn Sie den Parameter Begleitschreiben-Name angeben, sucht Z-FORWD nach einem Dokument mit dem angegebenen Namen und kopiert den Text dieses Dokuments in das Begleitschreiben der Post.
Wenn Sie den Parameter Begleitschreiben-ISN angeben, sucht Z-FORWD nach einem Objekt mit der angegebenen ISN und kopiert den Text dieses Objekts in das Begleitschreiben der Post. Das Objekt muss nicht unbedingt ein Dokument sein.
Wenn Sie den Parameter Begleitschreiben-Text markieren, erstellt Z-FORWD das Begleitschreiben aus dem Inhalt des Natural-Editierbereichs. Der Inhalt dieses Bereichs wird nicht verändert. Das nachfolgende Beispiel zeigt, wie Sie den Text mit dieser Methode angeben können.
Anmerkung:
"*/" in den ersten beiden Positionen einer Zeile im
Natural-Editierbereich generiert eine neue Seite im Text.
Nachdem die Post weitergeleitet wurde, wird die ISN des neuen Eintrags, der im Fach Tageskopien erstellt wurde, im Parameter Tageskopien-ISN ausgegeben.
Wenn ein anderer Wert als 0 im Parameter Return-Code ausgegeben wird, erfolgt immer ein BACKOUT TRANSACTION.
Parameter | Format | Ein | Aus | Bemerkung |
---|---|---|---|---|
Return-Code | N2 | O | X | Eingabe -1: kein ET. |
Buero | A8 | E | Das Büro, in dem die Post weitergeleitet wird. | |
Passwort | A8 | E | Das Passwort des o.g. Büros. | |
Posteingang-ISN | P10 | E | Die ISN der Post, die weitergeleitet werden soll. | |
Tageskopien-ISN | P10 | X | Die ISN des neuen Eintrags im Fach Tageskopien. | |
Begleitschreiben-Name | A32 | O* | Wenn angegeben, wird der Begleitschreibentext aus dem Dokument mit diesem Namen kopiert. | |
Begleitschreiben-ISN | P10 | O* | Wenn angegeben, wird der Begleitschreibentext aus dem Objekt mit dieser ISN kopiert. | |
Begleitschreiben-Text | A1 | O* | Wenn markiert, wird der Begleitschreibentext aus dem Inhalt des Natural-Editierbereichs kopiert. | |
Weiterleitungsoption | I1 | O | 0=nur dann weiterleiten, wenn alle Empfänger gefunden werden. 1=an alle gefundenen Empfänger weiterleiten (auch dann, wenn einige Empfänger nicht gefunden werden). Vorgabe: 0. | |
Weiterleitungsliste (12) | ||||
Empfaenger | A20 | E | Name oder Teilnehmerkennzeichen des Empfängers. | |
Adresstyp | N2 | O | Der Adresstyp muss einer der folgenden sein: 1=Adresse (Rufname), 4=Rubrik, 5=Büro, 10=Verteiler, 33=Teilnehmerkennzeichen, 70=Nachname oder 74=Extern. | |
Versandart | A1 | O | O=Original, C=Kopie, B=Blindkopie oder P=persönliche Post. Vorgabe: O. | |
Erfolg | I1 | X | 00=Empfänger wurde gefunden. 01=Empfänger wurde nicht gefunden. 02=Empfänger ist nicht eindeutig. 03=Ungültiger Adresstyp. |
00 | Erfolg |
02 | Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt |
03 | Falsches Passwort |
04 | Posteingang-ISN wurde nicht gefunden |
08 | Geben Sie für das Begleitschreiben nur Name, ISN oder Text an - nicht alles |
09 | Posteingang-ISN zeigt nicht auf das richtige Objekt |
18 | API-Kontext-Buffer ist nicht verfügbar |
21 | Empfänger nicht gefunden |
24 | Datenschutz-Sicherheitsübertretung |
53 | Das gewünschte Objekt existiert nicht |
57 | Das Objekt enthält keinen Text |
60 | Der Editierbereich ist leer |
90 | Transport Service-Objekt konnte nicht erstellt werden |
99 | Interner Fehler |
Z-MPPDB
Z-MPPLF
Z-RAREC
Z-RASSTX
Z-RCONFM
Z-RINITM
Z-RREC
Z-110
Z-120
Z-122
Z-123
Z-124
Z-145
Z-147
Z-161
Z-165
Z-168
Z-175
Z-177
Z-180
Z-185
Z-191
Z-191A
Z-194
Z-194A
Z-197
Z-197A
Z-200B
Z-201
Z-201B
Z-202
Z-207
Z-208
Z-211
Z-212
Z-213
Z-215
Z-216
Z-221
Z-222
Z-223
Z-224
Z-225
Z-226
Z-241
Z-373
Z-400
Z-401
Z-402
Z-403
Z-404
Z-406
Z-407
Z-719
Z-747
Z-1200&0
0010 * In diesem Beispiel wird davon ausgegangen, dass die 0020 * Posteingang-ISN, der Begleitschreibentext und die 0030 * ausgewaehlten Empfaenger von einer vorherigen Haupt-Routine 0040 * geprueft wurden. 0050 * 0060 * 0070 * 0080 DEFINE DATA 0090 * 0100 PARAMETER 0110 * 0120 1 RETURN-CODE (N2) 0130 1 BUERO (A8) 0140 1 PASSWORT (A8) 0150 1 POSTEINGANG-ISN (P10) 0160 1 WEITERLEITUNGSLISTE (1:12) 0170 2 EMPFAENGER (A20) 0180 2 ADRESSTYP (N2) 0190 2 VERSANDART (A1) 0200 2 ERFOLG (I1) 0210 1 TEXTZEILEN (A70/1:20) 0220 * 0230 LOCAL 0240 * 0250 1 TAGESKOPIEN-ISN (P10) 0260 1 WEITERLEITUNGSOPTION (I1) 0270 1 BEGLEITSCHREIBEN-NAME (A32) 0280 1 BEGLEITSCHREIBEN-ISN (P10) 0290 1 BEGLEITSCHREIBEN-TEXT (A1) 0300 * 0310 1 INX (P3) 0320 * 0330 END-DEFINE 0340 * 0350 * Das Ziel 'SOURCE' definieren und die Textzeilen in den Natural-Editier- 0360 * bereich stellen. Der Inhalt des Editierbereichs wurde vorher geloescht. 0370 * 0380 DEFINE PRINTER (#OUT=1) OUTPUT 'SOURCE' 0390 FORMAT (#OUT) LS=80 PS=60 0400 SET CONTROL 'Z' 0410 * 0420 FOR INX EQ 1 TO 20 0430 WRITE (#OUT) NOTITLE TEXTZEILEN (INX) 0440 END-FOR 0450 * 0460 * Post an alle gefundenen Empfaenger weiterleiten, einschl. ET 0470 * 0480 RESET RETURN-CODE 0490 MOVE 1 TO WEITERLEITUNGSOPTION 0500 MOVE 'X' TO BEGLEITSCHREIBEN-TEXT 0510 * 0520 CALLNAT 'Z-FORWD' 0530 RETURN-CODE 0540 BUERO 0550 PASSWORT 0560 POSTEINGANG-ISN 0570 TAGESKOPIEN-ISN 0580 BEGLEITSCHREIBEN-NAME 0590 BEGLEITSCHREIBEN-ISN 0600 BEGLEITSCHREIBEN-TEXT 0610 WEITERLEITUNGSOPTION 0620 WEITERLEITUNGSLISTE (*) 0630 * 0640 END