Z-ADDATT

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Teilnehmer und Arbeitsmittel für eine Besprechung eingeben.

Mit jedem Aufruf können Sie bis zu 12 Teilnehmer definieren. Um weitere Teilnehmer zu definieren, müssen Sie dieses Subprogramm erneut aufrufen; in diesem Fall dürfen Sie jedoch nur weitere Teilnehmer und die entsprechenden Teilnehmertypen angeben.

Die Adressinformationen für externe Teilnehmer werden nicht überprüft. Externe Teilnehmer müssen deshalb vollständig definiert werden.

Z-ADDATT erstellt eine Empfängerliste (sofern sie nicht schon existiert) und führt eine eingeschränkte Berechtigungsprüfung durch - d.h. es überprüft die Adressierstufe und die Anzahl der Teilnehmer. Die gültigen Teilnehmer werden nach der Prüfung auf Leerzeichen zurückgesetzt.

Wenn ein Teilnehmer nicht gefunden wird oder ungültig ist, wird der entsprechende Return-Code gesetzt. In diesem Fall wird der Teilnehmer-Parameter nicht auf Leerzeichen zurückgesetzt und das API wird beendet.

Vorsicht:
Wenn einer der Teilnehmer nicht gefunden wird oder ungültig ist (d.h. wenn der Return-Code nicht 0 ist), werden der Empfängerliste keine Teilnehmer hinzugefügt.

Z-MCONFM kann später zum Versenden der Einladungen benutzt werden.

Nachdem die Einladungen versendet wurden, kann Z-UNDO zum Stornieren von Teilnehmern und Arbeitsmitteln benutzt werden.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro des Initiators.
Passwort A8 E   Das Passwort des o.g. Büros.
Initiator A20 O   Wird auf *USER gesetzt, wenn der Initiator ein eigenes Büro hat. Andernfalls wird der angegebene Name benutzt.
Kalender-ISN P10 E X Eingabe: die ISN des ersten Satzes der zu ändernden Besprechung. Ausgabe: die ISN des ersten Satzes der geänderten Besprechung.
Teilnehmer A20/1:12 E X Eingabe: die Namen oder Teilnehmerkennzeichen der Teilnehmer. Ausgabe: die gültigen Teilnehmer werden auf Leerzeichen zurückgesetzt.
Teilnehmertyp N2/1:12 O   1=Adresse (Rufname), 5=Büro, 10=Verteiler, 29=Arbeitsmittel, 33=Teilnehmerkennzeichen, 70=Nachname, 74=Extern.
Work-Parameter A128     Für den internen Gebrauch. Siehe Der 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
09 ISN zeigt nicht auf eine Besprechung
21 Teilnehmer nicht gefunden
24 Datenschutz-Sicherheitsübertretung
25 Mehr Teilnehmer als erlaubt
33 Teilnehmer ist nicht eindeutig
34 Teilnehmertyp wurde nicht gefunden
90 Teilnehmer können nur für die letzte Version der Besprechung eingegeben werden
91 Für eine abgesagte Besprechung können keine Teilnehmer eingegeben werden

Subprogramme

Z-110
Z-120
Z-122
Z-123
Z-135
Z-147
Z-155
Z-165
Z-175
Z-190
Z-191A
Z-194
Z-197A
Z-200A
Z-201
Z-202
Z-207
Z-215
Z-216
Z-711
Z-742
Z-1200&0

Beispiel

DEFINE DATA
LOCAL
1 RETURN-CODE     (N2)
1 BUERO           (A8)
1 PASSWORT        (A8)
1 INITIATOR       (A20)
1 KALENDER-ISN    (P10)
1 TEILNEHMER      (A20/1:12)
1 TEILNEHMERTYP   (N2/1:12)
1 WORK-PARAMETER  (A128)
*
END-DEFINE
*
MOVE 'Buero'       TO BUERO
MOVE 'Passwort'    TO PASSWORT
MOVE 'David Brown' TO INITIATOR
MOVE 102504        TO KALENDER-ISN
MOVE 'ESH'         TO TEILNEHMER(1)
MOVE 33            TO TEILNEHMERTYP(1)
MOVE 'TPI'         TO TEILNEHMER(2)
MOVE 33            TO TEILNEHMERTYP(2)
*
CALLNAT 'Z-ADDATT'
  RETURN-CODE
  BUERO
  PASSWORT
  INITIATOR
  KALENDER-ISN
  TEILNEHMER    (*)
  TEILNEHMERTYP (*)
  WORK-PARAMETER
*
WRITE
  '=' BUERO              /
  '=' PASSWORT           /
  '=' INITIATOR          /
  '=' KALENDER-ISN       /
  '=' TEILNEHMER(*)      /
  '=' TEILNEHMERTYP(*)   /
*
IF RETURN-CODE NE 0
  WRITE / 'Return-Code' RETURN-CODE
ELSE
  WRITE / 'Return-Status OK'
END-IF
*
END