Z-GETADR

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

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

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). Oder die Anschriften für die Rufnamen ausgeben, die im Privatbüro des Büroadministrators definiert sind.

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

  • Jeder andere Teilnehmer
    Die Anschriften für die Rufnamen ausgeben, die im Privatbüro des Teilnehmers definiert sind.

Dieses Subprogramm gibt auch die Anschriften für Rufnamen in den Büros aus, für die die oben genannten Teilnehmer eine Zugriffsberechtigung haben (zum Beispiel, Gruppenbüros und offene Büros).

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" (nur für Systemadministratoren).   Ein bestimmter Rufname; oder ein Stern (*); oder Buchstaben gefolgt von einem Stern (*).
Rufname aus dem Privatbüro des Teilnehmers ausgeben oder aus einem Büro, für das der Teilnehmer eine Zugriffsberechtigung hat. 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   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.
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 Einer der Folgenden: 1=Adresse (Rufname), 5=Büro, 33=Teilnehmerkennzeichen (Privatbüro).
Persoenlich-Flag A1   X Markiert, wenn die Anschrift als persönliches Objekt definiert wurde.
Nachname A32   X  
Vorname A32   X  
2-Vorname A1   X  
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 A88     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
15 Ungültiger Administratorstatus
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-1200&0

Beispiel

Siehe das Beispiel für Z-MODADR.