Z-GET01C

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Die Büro- und Privatanschrift für ein Büro oder einen Rufnamen ausgeben.

Dieses Subprogramm entspricht Z-GETADR mit der Ausnahme, dass es für einen Rufnamen auch Nachname, Vorname und das Persoenlich-Flag ausgibt.

Dieses Subprogramm kann von unterschiedlichen Teilnehmertypen benutzt werden. Je nachdem, von welchem Teilnehmer es aufgerufen wird, sind die folgenden Funktionen erlaubt:

  • Büroadministrator
    Die Anschriften für Büros ausgeben (außer für das Büro SYSCNT), für Rufnamen im Büro SYSCNT oder für Rufnamen im Privatbüro des Büroadministrators.

  • Systemadministrator
    Die Anschrift für das Büro SYSCNT ausgeben, für Rufnamen im Büro SYSCNT oder für Rufnamen im Privatbüro des Systemadministrators.

  • Jeder andere Teilnehmer
    Die Anschriften für Rufnamen im Büro SYSCNT ausgeben, oder für Rufnamen im Privatbüro des Teilnehmers.

In den Parametern Bueroname oder Rufname können Sie Folgendes eingeben:

  • Um alle Anschriften in alphabetischer Reihenfolge auszugeben, geben Sie einen Stern (*) ein.

  • Um die Anschriften für alle Büros oder für alle Rufnamen auszugeben, die mit bestimmten Buchstaben beginnen, geben Sie die Buchstaben gefolgt von einem Stern ein (z.B. SAG*).

  • Um die Anschrift für ein bestimmtes Büro oder einen bestimmten Rufnamen auszugeben, geben Sie dessen Name ein.

Sie können dieses Subprogramm solange iterativ aufrufen, bis das Ende der Liste durch den Return-Code 77 gekennzeichnet wird.

Die folgende Tabelle zeigt, welche Parameter für die verschiedenen Funktionen dieses Subprogramms benutzt werden:

Funktion Buero Bueroname Rufname
Anschrift für ein Büro ausgeben (außer für SYSCNT). Teilnehmerkennzeichen eines Büroadministrators. Name eines bestimmten Büros; oder ein Stern (*); oder Buchstaben gefolgt von einem Stern (*).  
Anschrift für das Büro SYSCNT ausgeben. Teilnehmerkennzeichen eines Systemadministrators. Der Büroname "SYSCNT".  
Rufname im Büro SYSCNT ausgeben. Der Büroname "SYSCNT".   Ein bestimmter Rufname; oder ein Stern (*); oder Buchstaben gefolgt von einem Stern (*).
Rufname im eigenen Privatbüro ausgeben. Name des Büros, in dem der Rufname abgelegt ist.   Ein bestimmter Rufname; oder ein Stern (*); oder Buchstaben gefolgt von einem Stern (*).

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E X Um die Anschrift für ein Büro auszugeben, muss dies das Teilnehmerkennzeichen eines Büroadministrators sein. Um die Anschrift für einen Rufnamen auszugeben, muss dies der Name des Büros sein, in dem der Rufname abgelegt ist. Wenn der Rufname im angegebenen Büro nicht gefunden wird, sondern im Büro SYSCNT, wird SYSCNT ausgegeben.
Passwort A8 E   Das Passwort des o.g. Büros.
Bueroname A8 E* X Siehe die Beschreibung oben. Entweder Bueroname oder Rufname, nicht beides.
Rufname A32 E* X Siehe die Beschreibung oben. Entweder Rufname oder Bueroname, nicht beides.
Objekt-ISN P10   X Die ISN des Büros oder Rufnamens.
Objektnummer N2   X 1=Adresse (Rufname), 5=alle Bürotypen.
Persoenlich-Flag A1   X Markiert, wenn die Anschrift als persönliches Objekt definiert wurde.
Nachname A32   X Gilt nur für ein Privatbüro.
Vorname A32   X Gilt nur für ein Privatbüro.
2-Vorname A1   X Gilt nur für ein Privatbüro.
Rufname-fuer A44   X Gilt nur für einen Rufnamen. Nachname und Vorname, durch ein Komma getrennt.
Rufname-Status N1   X Gilt nur für einen Rufnamen. Überprüft die Struktur (z.B. Komma) des Parameters Rufname-fuer. 0=korrekt, 1=nicht korrekt.
Rufname-Ursprung A8   X Der Name des Büros, in dem der Rufname enthalten ist.
Buero-Titel A32   X  
Buero-Firma A32   X  
Buero-Ort A32   X  
Buero-Adresse A60/1:3   X  
Buero-Stadt A32   X  
Buero-Land A8   X  
Buero-Abteilungsname A32   X  
Buero-Abteilungsnummer A10   X  
Buero-Telefon A15   X  
Buero-Telefon-Land N2   X  
Buero-Durchwahl A10   X  
Buero-Postleitzahl A10   X  
Buero-Staat A8   X  
Privat-Adresse A60/1:2   X  
Privat-Stadt A32   X  
Privat-Land A8   X  
Privat-Telefon A15   X  
Privat-Telefon-Land N2   X  
Privat-Postleitzahl A10   X  
Privat-Staat A8   X  
Work-Parameter A83     Für den internen Gebrauch. Siehe Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname
03 Falsches Passwort
15 Ungültiger Administratorstatus
24 Datenschutz-Sicherheitsübertretung
53 Das gewünschte Objekt existiert nicht
77 Ende der Liste
92 Geben Sie entweder Büroname oder Rufname an, nicht beides
93 Geben Sie den Parameter Bueroname oder Rufname an

Subprogramme

Z-120
Z-122
Z-123
Z-710
Z-1200&0

Beispiel

Siehe das Beispiel für Z-MOD01C.