Z-ADD01B

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Einen Rufnamen für eine Adresse an einem externen Knoten oder für eine interne Con-nect-Adresse eingeben. Dieses Subprogramm gilt nur für externe Knoten, die die Spoolfile-Methode benutzen.

Dieses Subprogramm gilt nicht für Transport Service-Knoten. Um einen Rufnamen für einen Transport Service-Knoten einzugeben, müssen Sie Z-ADD01T benutzen.

Dieses Subprogramm entspricht Z-ADD01A mit der Ausnahme, dass Sie auch einen Rufnamen für einen internen Con-nect-Teilnehmer eingeben können.

Eine interne Adresse kann Folgendes sein: der Nachname oder das Teilnehmerkennzeichen eines Con-nect-Teilnehmers, ein Verteiler, eine Rubrik oder ein Büro.

Sie können auch einen Rufnamen für einen bereits bestehenden Rufnamen eingeben (zum Beispiel, wenn der Rufname, der vom Administrator definiert wurde, schwer zu behalten ist); in diesem Fall können Sie im Parameter Adresstyp eine 1 angeben.

Wenn Sie einen Rufnamen für eine externe Adresse eingeben, müssen Sie die Parameter Knotenname, Knotenparameter, Parameterlaenge, Bearbeitungs-Flag und Bueroanschrift definieren. Für den Parameter Objektname dürfen Sie keinen Wert definieren.

Wenn Sie nur den Knotennamen kennen und nicht die physische Adresse des externen Knotens, die vom Administrator definiert wurde (Knotenparameter), können Sie vor dem Aufruf von Z-ADD01B das Subprogramm Z-GET74 aufrufen, um die physische Adressinformation auszugeben.

Dieses Subprogramm prüft nicht, ob die Daten, die Sie im Knotenparameter eingeben, mit den Daten übereinstimmen, die vom Administrator definiert wurden. Sie können daher auch abweichende Adressinformationen im Knotenparameter eingeben. Sie müssen jedoch darauf achten, dass diese Daten gültig sind.

Wenn Sie einen Rufnamen für eine interne Adresse eingeben, müssen Sie den Parameter Objektname definieren. Sie dürfen keine Werte für die Parameter Knotenname, Knotenparameter, Parameterlaenge, Bearbeitungs-Flag und Bueroanschrift definieren.

Der Parameter Bueroanschrift ist nur dann erforderlich, wenn Sie einen Rufnamen für eine externe Adresse eingeben. Wenn Sie einen Rufnamen für eine interne Adresse eingeben, wird die Systemadresse automatisch übernommen (wenn Sie den Parameter Bueroadresse für eine interne Adresse definieren, so wird dies ignoriert).

Wenn Sie im Parameter Objektname den Namen eines Teilnehmers eingeben, können Sie entweder den Nachnamen oder den Nachnamen zusammen mit dem Vornamen eingeben. Nachname und Vorname müssen durch ein Komma getrennt werden (zum Beispiel: Long,Sonya); Sie dürfen kein Leerzeichen einfügen.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem der Rufname eingegeben werden soll.
Passwort A8 E   Das Passwort des o.g. Büros.
Rufname A20 E   Der Rufname, der eingegeben werden soll.
ISN P8   X Die ISN des neuen Rufnamens.
Adresstyp N2 E   Muss einer der Folgenden sein: 1=Adresse (Rufname), 4=Rubrik, 5=Büro, 10=Verteiler, 33=Teilnehmerkennzeichen, 70=Nachname, 74=Externe Adresse.
Beschreibung A60/1:4 O   Eine kurze Beschreibung für den Rufnamen.
Fachname A15 O   Das Fach, im dem der Rufname abgelegt werden soll. Sie dürfen kein TRS-Fach und kein Systemfach (außer dem Arbeitsfach) definieren. Vorgabe: Arbeitsfach.
Ordnername A15 O   Der Ordner im o.g. Fach, in dem der Rufname abgelegt werden soll.
Objektname A40 E   Der Name des Objekts, für das Sie einen Rufnamen erstellen wollen (z.B. das Teilnehmerkennzeichen). Nur bei einem internen Rufnamen erforderlich.
Knotenname A8 E   Der Name eines Knotens, der vom Administrator definiert wurde.
Knotenparameter A250 E   Die physische Adresse des externen Knotens. Siehe Externe Kommunikation.
Parameterlaenge N3 E   Die Länge des Knotenparameters.
Bearbeitungs-Flag A1 O   Vorgabe: leer. Es ist nur dann sinnvoll, dieses Flag zu markieren, wenn Sie online mit Con-nect arbeiten. Wenn es markiert ist, erscheint ein Fenster und Sie können vor dem Versenden zusätzliche Informationen eingeben. Wenn Sie Post mit Z-MAILA versenden, dürfen Sie dieses Flag nicht markieren, weil das Fenster hier nicht erscheint.
Bueroanschrift A190/1:3 O   Die Bueroanschrift. Sie müssen diesen Parameter redefinieren. Siehe die Redefinitionen im folgenden Beispielprogramm.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
10 Funktion ist für Systemfach nicht gültig
21 Empfänger nicht gefunden
33 Empfänger ist nicht eindeutig
34 Adresstyp wurde nicht gefunden
55 Das gewünschte Fach bzw. der gewünschte Ordner existiert nicht
56 Das gewünschte Fach ist ein TRS-Fach
73 Ungültiger Fach-/Ordnername
91 Ungültiger Name
92 Der Name existiert bereits
93 Der externe Knoten existiert nicht
94 Die Objektnummer ist nicht erlaubt
95 Ein Objekt mit diesem Namen existiert nicht
96 Geben Sie entweder Objektname oder Knotenname an, nicht beides
97 Keine Postfunktion erlaubt
98 Die Adressierstufe ist zu niedrig
99 Der Knoten ist kein Spoolfile-Knoten

Subprogramme

Z-120
Z-122
Z-123
Z-135
Z-147
Z-150
Z-162
Z-174
Z-190
Z-200A
Z-1200&0

Beispiel

0010 *
0020 * Rufname für eine interne Adresse in einem bestimmten
0030 * Buero eingeben
0040 *
0050 * PARAMETER  : ADR-TYP  +   KNOTENNAME    ODER  NAME
0060 *            : _______      __________          ______________________
0070 *            :   01                             RUFNAME
0080 *            :   04                             RUBRIKNAME
0090 *            :   05                             BUERONAME
0100 *            :   10                             VERTEILERNAME
0110 *            :   33                             TEILNEHMERKENNZEICHEN
0120 *            :   70                             NACHNAME,VORNAME
0130 *            :   74          KNOTENNAME
0140 *
0150 ************************************************************************
0160 DEFINE DATA
0170 LOCAL
0180 1 RETURN-CODE         (N2)
0190 1 BUERO               (A8)
0200 1 PASSWORT            (A8)
0210 1 RUFNAME             (A20)        
0220 1 ISN                 (P8)
0230 1 ADRESSTYP           (N2)               /* Erlaubt: 1,4,5,10,33,70,74
0240 1 BESCHREIBUNG        (A60/1:4)
0250 1 FACHNAME            (A15)
0260 1 ORDNERNAME          (A15)
0270 1 OBJEKTNAME          (A40)              /* - intern -
0280 1 KNOTENNAME          (A8)               /* - extern -
0290 1 KNOTENPARAMETER     (A250)             /* - extern -
0300 1 PARAMETERLAENGE     (N3)               /* - extern -
0310 1 BEARBEITUNGS-FLAG   (A1)               /* - extern -
0320 1 BUEROANSCHRIFT      (A190/1:3)         /* - extern -
0330 *
0340 1 ANSCHRIFT1          (A190)
0350 1 REDEFINE ANSCHRIFT1
0360  2 BUERO-TITEL        (A32)
0370  2 BUERO-FIRMA        (A32)
0380  2 BUERO-ORT          (A32)
0390  2 BUERO-ABT-NAME     (A32)
0400  2 BUERO-ABT-NUM      (A10)
0410 1 ANSCHRIFT2          (A190)
0420 1 REDEFINE ANSCHRIFT2
0430   2 BUERO-ADRESSE     (A60/1:3)
0440 1 ANSCHRIFT3          (A190)
0450 1 REDEFINE ANSCHRIFT3
0460   2 BUERO-STADT       (A32)
0470   2 BUERO-STAAT       (A8)
0480   2 BUERO-PLZ         (A10)
0490   2 BUERO-LAND        (A8)
0500   2 BUERO-TEL-LAND    (A2)
0510   2 BUERO-TEL         (A15)
0520   2 BUERO-TEL-DURCH   (A10)
0530 *
0540 END-DEFINE
0550 * *****************************
0560 RESET RETURN-CODE
0570 *
0580 MOVE 'ORT'            TO BUERO-ORT
0590 MOVE 'FIRMA'          TO BUERO-FIRMA
0600 MOVE 'ABTEILUNGSNAME' TO BUERO-ABT-NAME
0610 MOVE ANSCHRIFT1 TO BUEROANSCHRIFT(1)
0620 MOVE ANSCHRIFT2 TO BUEROANSCHRIFT(2)
0630 MOVE ANSCHRIFT3 TO BUEROANSCHRIFT(3)
0640 MOVE 'BUERO'       TO BUERO
0650 MOVE 'PASSWORT'    TO PASSWORT
0660 MOVE 'RUFNAME'     TO RUFNAME
0670 MOVE  33           TO ADRESSTYP       /* Erlaubt: 1,4,5,10,33,70,74
0680 MOVE 'KENNZEICHEN' TO OBJEKTNAME      /* Verteiler;Teilnehmerkennz.;Buero;
0690 *                                        Rubrik;Nachname,Vorname,Rufname
0700 CALLNAT 'Z-ADD01B' RETURN-CODE
0710                    BUERO
0720                    PASSWORT
0730                    RUFNAME
0740                    ISN
0750                    ADRESSTYP
0760                    BESCHREIBUNG(*)
0770                    FACHNAME
0780                    ORDNERNAME
0790                    OBJEKTNAME
0800                    KNOTENNAME
0810                    KNOTENPARAMETER
0820                    PARAMETERLAENGE
0830                    BEARBEITUNGS-FLAG
0840                    BUEROANSCHRIFT(*)
0850 *
0860 IF RETURN-CODE = 0
0870    WRITE 'Adresse wurde eingegeben'
0880 ELSE
0890    WRITE 'Return-Code:' RETURN-CODE
0900 END-IF
0910 *
0920 END