Z-FORWD

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

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

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.

Return-Codes

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

Subprogramme

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

Beispiel

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