Die Funktion Service Directory Maintenance wird verwendet, um ein Dienstverzeichnis zu pflegen, um das aufrufende Programm des Clients mit einem Subprogramm auf einem Server zu verbinden.

Die Informationen des Dienstverzeichnisses werden im Subprogramm NATCLTGS in der Library gespeichert, die mit dem NTRPC/RPC-Schlüsselwort-Subparameter RPCSDIR definiert ist (siehe Parameter-Referenz-Dokumentation). Wenn RPCSDIR gesetzt ist, verweist die Service Directory Maintenance-Funktion auf die mit RPCSDIR angegebene Library. Wenn RPCSDIRRPCSDIR nicht gesetzt ist (dies ist die Standardeinstellung), wird auf die Library verwiesen, in der Sie angemeldet sind. Melden Sie sich in diesem Fall bei der Library (oder einer ihrer Steplibs) an, die vom Client zur Laufzeit verwendet wird, bevor Sie die Funktion Service Directory Maintenance ausführen.

Der Name der Library, auf die bei der Pflege des Dienstverzeichnisses verwiesen wird, wird in der oberen rechten Ecke des Bildschirms Service Directory angezeigt (siehe Service Directory Maintenance aufrufen). Wenn RPCSDIR gesetzt ist, steht im Bildschirmtitel Central, was darauf hinweist, dass die auf dem Bildschirm angezeigte Library nicht die Library ist, in der Sie gerade angemeldet sind, sondern die mit RPCSDIR angegebene zentrale Library.

Achtung!

Wenn das Subprogramm NATCLTGS in der Natural System Library SYSRPC gespeichert ist, empfehlen wir dringend, NATCLTGS in die vom Client verwendete Application Library (oder eine ihrer Steplibs) zu verschieben.

Weitere Informationen zur Anwendung der Funktion Service Directory Maintenance siehe RPC-Server-Adressen festlegen im Kapitel Betrieb einer Natural RPC-Umgebung in der Natural RPC (Remote Procedure Call) -Dokumentation.

Dieses Kapitel behandelt die folgenden Themen:

• Service Directory-Konzept

• Funktion Service Directory Maintenance aufrufen

• Felder auf dem Service Directory-Bildschirm

• Kommandos zur Pflege des Service Directory

• API USR8216N zur Pflege des Service Directory

---

Service Directory-Konzept

Ein Service Directory hat eine hierarchische Struktur mit einer kaskadierenden Liste zur Zuordnung von untergeordneten zu übergeordneten Feldern. Die höchste hierarchische Ebene ist Knoten (Node), die niedrigste ist Programm. Sie können Knoten, Server, Library und Programm nicht in derselben Zeile eingeben. Wenn Sie dies tun, erscheint eine entsprechende Fehlermeldung. Sie müssen den Wert eines untergeordneten Feldes in den Zeilen unterhalb des übergeordneten Feldes eingeben. Sie können einem Knoten mehrere Server, einem Server mehrere Libraries und einer Library mehrere Programme zuordnen.

• Knoten und Server

Knoten und Server

In Beispiel 1 - Service Directory-Standardansicht sind zwei Server bei einem Knoten definiert. Beide Server sind mit demselben Knoten verbunden: ETB045. Der Remote-CALLNAT zum Subprogramm SUB1 wird auf Server NRPC001 ausgeführt, während die Subprogramme SUB2 und SUB3 auf Server NRPC002 ausgeführt werden.

Die hier angegebenen Servernamen müssen mit den Servernamen identisch sein, die für den Server mit dem NTRPC/RPC-Schlüsselwort-Subparameter SRVNAME angegeben wurden, der in der Parameter-Referenz-Dokumentation beschrieben ist. Analog dazu muss der Knotenname im Service Directory mit dem Knotennamen identisch sein, der für den Server mit dem NTRPC/RPC-Schlüsselwort-Subparameter SRVNODE angegeben wurde, der in der Parameter-Referenz-Dokumentation beschrieben ist.

Funktion Service Directory Maintenance aufrufen

Um die Funktion Service Directory Maintenance aufzurufen:

1. Geben Sie im Feld Code des Menüs Client Maintenance das folgende Kommando ein:

   SM

2. Drücken Sie ENTER.

   Wenn das Serviceverzeichnis bereits Servicedefinitionen enthält, erscheint ein Fenster mit der Meldung, dass vorhandene Dienstdefinitionen gefunden wurden:

   Existing service definitions found

   • Geben Sie im Fenster im Feld Code ein A (Standardwert) ein, um alte Definitionen zu behalten und neue anzuhängen, und drücken Sie ENTER.

   • Oder: Geben Sie im Fenster im Feld Code ein I ein, um alle vorhandenen Definitionen zu ignorieren und aus dem Service Directory zu löschen, und drücken Sie ENTER.

   Die Service Directory-Standardansicht wird angezeigt (Beispiel):

   Beispiel 1 - Service Directory-Standardansicht

   15:00:11 ***** NATURAL SYSRPC UTILITY ***** 2016-07-18 - Service Directory - Library SAGTST Node Tr. Server Logon Library Program 1 ETB045__________ B ________________ _ ________ ________ 2 ________________ _ NRPC001_________ N ________ ________ 3 ________________ _ ________________ _ SYSTEM__ ________ 4 ________________ _ ________________ _ ________ SUB1____ 5 ________________ _ NRPC002_________ Y ________ ________ 6 ________________ _ ________________ _ SYSTEM__ ________ 7 ________________ _ ________________ _ ________ SUB2____ 8 ________________ _ ________________ _ ________ SUB3____ 9 ________________ _ ________________ _ ________ ________ 10 ________________ _ ________________ _ ________ ________ 11 ________________ _ ________________ _ ________ ________ 12 ________________ _ ________________ _ ________ ________ 13 ________________ _ ________________ _ ________ ________ 14 ________________ _ ________________ _ ________ ________ 15 ________________ _ ________________ _ ________ ________ 16 ________________ _ ________________ _ ________ ________ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Long Exit Find -H +H -P +P Top Bot > Canc

   Der Bildschirm Service Directory bietet maximal 500 Zeilen für die Eingabe.

3. Wenn Sie PF11 drücken oder das Kleiner-als-Zeichen (<) in die Kommandozeile eingeben, wird die erweiterte Knoten-/Serveransicht des Service Directory-Bildschirms ähnlich wie im folgenden Beispiel angezeigt:

   Beispiel 2 - Erweiterte Service Directory-Ansicht

   15:09:01 ***** NATURAL SYSRPC UTILITY ***** 2016-07-18 - Service Directory - Library SAGTST Node Tr. Server Logon 1 ETB045__________________________ B ________________________________ _ 2 ________________________________ _ NRPC001_________________________ N 3 ________________________________ _ ________________________________ _ 4 ________________________________ _ ________________________________ _ 5 ________________________________ _ NRPC002_________________________ Y 6 ________________________________ _ ________________________________ _ 7 ________________________________ _ ________________________________ _ 8 ________________________________ _ ________________________________ _ 9 ________________________________ _ ________________________________ _ 10 ________________________________ _ ________________________________ _ 11 ________________________________ _ ________________________________ _ 12 ________________________________ _ ________________________________ _ 13 ________________________________ _ ________________________________ _ 14 ________________________________ _ ________________________________ _ 15 ________________________________ _ ________________________________ _ 16 ________________________________ _ ________________________________ _ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Long Exit Find -H +H -P +P Top Bot > Canc

   Wenn Sie PF11 drücken oder das Größer-als-Zeichen (>) in die Kommandozeile eingeben, wird die Standardansicht des Service Directory-Bildschirms angezeigt, wie in Beispiel 1 - Service Directory-Standardansicht dargestellt.

Felder auf dem Service Directory-Bildschirm

Der Service Directory-Bildschirm enthält die folgenden Eingabefelder (ein Eintrag pro Zeile):

Feld	Beschreibung
Node	Der Name des Knotens, an den der Remote CALLNAT gesendet wird. Siehe auch Natural RPC Terminology in der Natural RPC (Remote Procedure Call) -Dokumentation. Die maximale Länge der Eingabe ist wie folgt: Standardansicht des Bildschirms Service Directory: 16 characters Erweiterte Knoten-/Serveransicht des Bildschirms Service Directory: 32 Zeichen Fenster Long Name (siehe PF2 in Lokale Kommandos und PF-Tasten) des Bildschirms Service Directory: bis zu 192 Zeichen.
Tr.	Das zu verwendende Transportprotokoll: B steht für EntireX Broker ACI-Protokoll.
Server	Der Name des Servers, an den der Remote CALLNAT gesendet wird. Siehe auch Natural RPC Terminology in der Natural RPC (Remote Procedure Call) -Dokumentation. Die maximale Länge der Eingabe ist wie folgt: Standardansicht des Bildschirms Service Directory: 16 Zeichen Erweiterte Knoten-/Serveransicht des Bildschirms Service Directory: 32 Zeichen
Logon	Initiiert eine Natural-Anmeldung beim Server. Dies ist auf Server- oder Knotenebene möglich und gilt für alle Definitionen, die auf einer hierarchisch niedrigeren Ebene vorgenommen wurden. Wenn die Logon-Option bei einem bestimmten Server gesetzt wurde, gilt sie für alle zugehörigen Library- und Subprogramm-Definitionen. Mögliche Werte: Y Wenn die Option auf Y (Ja) gesetzt ist, initiiert der Client bei jeder nicht-konversationellen CALLNAT-Anforderung oder bei jedem Start einer Konversation eine Natural-Anmeldung beim Server unter Verwendung des aktuellen Library-Namens auf dem Client, unabhängig von den Libraries in der untergeordneten Spalte Library, die zum Feld Server gehört. Sie können die Anwendungsprogrammierschnittstelle USR4008N verwenden, um eine andere Library anzugeben (siehe auch Bei einer anderen Library anmelden im Kapitel Logon-Option benutzen in der Natural RPC (Remote Procedure Call)-Dokumentation). N oder blank Wenn N (Nein) oder kein Wert eingegeben wird, wird keine Anmeldung initiiert. Nach der Ausführung des Remote CALLNAT (erfolgreich oder nicht) oder am Ende einer Konversation wird die Server Library in ihren vorherigen Zustand zurückgesetzt. Weitere Informationen finden Sie unter Logon-Option benutzen in der Natural RPC (Remote Procedure Call)-Dokumentation. Siehe auch Server-Kommandos ausführen (Server Command).
Library	Library SYSTEM oder der Name der Library, bei der Ihre Client-Anwendung während der Ausführung des Remote CALLNAT angemeldet ist.
Program	Der Name des Remote Subprogramms, auf das vom Client aus zugegriffen werden soll. Sie können einen Namen oder einen Namensbereich eingeben. Gültige Namen sind beliebige Kombinationen aus einem oder mehreren alphanumerischen Zeichen mit einem oder mehreren Stern-Zeichen (*) und/oder einem oder mehreren Fragezeichen (?). Dabei bedeutet: Stern (*) eine beliebige Zeichenkette, Fragezeichen (?) ein einzelnes Zeichen. Ungültige Kombinationen sind: *? Ein Stern gefolgt von einem Fragezeichen wird in ?* umgewandelt. ** Zwei oder mehr aufeinanderfolgende Sterne werden in einen einzelnen Stern umgewandelt..

Auswahlkriterien für Knoten und Server

Zur Natural-Laufzeit hängt die Auswahl eines Knotens und Servers vom Wert der Felder Program und Library ab. Halten Sie die folgenden Bedingungen ein:

Nicht-konversationelles CALLNAT

1. Das Feld Library muss den Namen der aktuellen Application Library oder SYSTEM enthalten.

2. Der Name des in der CALLNAT-Anweisung angegebenen Subprogramms muss im Feld Program enthalten sein, das zum Feld Library in Punkt (1) gehört.

Konversationelles CALLNAT

1. Das Feld Library muss den Namen der aktuellen Application Library oder SYSTEM enthalten.

2. Alle im Statement OPEN CONVERSATION angegebenen Subprogramme müssen in einem Program-Feld enthalten sein, das zum Feld Library unter Punkt (1) gehört.

Der für ein nicht-konversationelles oder konversationelles CALLNAT verwendete Knoten und Server werden aus den übergeordneten Feldern Node und Server des Feldes Library in Punkt (1) übernommen.

Kommandos zur Pflege des Service Directory

Dieser Abschnitt enthält Informationen zu den Kommandos, die auf dem Bildschirm Service Directory zur Verfügung stehen.

• Zeilenkommandos

• Lokale Kommandos und PF-Tasten

Zeilenkommandos

Mit den Zeilenkommandos, die auf dem Bildschirm Service Directory zur Verfügung stehen, können Sie einzelne oder mehrere Zeilen, die Feldwerte enthalten, kopieren, verschieben oder löschen.

Geben Sie ein Zeilenkommando am Anfang einer Zeile ein, d.h. überschreiben Sie die fortlaufende Nummer und drücken Sie ENTER.

Siehe auch Um einen Zeilenblock zu kopieren oder zu verschieben und das lokale Kommando RESET.

Zeilenkommando	Funktion
A	Kopiert oder verschiebt den mit CC oder MM markierten Zeilenblock unter der Zeile, in der das Kommando eingegeben wurde.
CC	Markiert den zu kopierenden Zeilenblock.
D	Löscht die markierte Zeile.
DD	Markiert und löscht einen Zeilenblock. Markieren Sie einen Zeilenblock, indem Sie dieses Kommando in der ersten und letzten Zeile des Blocks eingeben und ENTER drücken, um das Kommando auszuführen.
I	Fügt fünf Leerzeilen unter der Zeile ein, in der das Kommando eingegeben wurde. Der Cursor wird in die erste neue Zeile unterhalb der Spalte Server oder Library gesetzt, je nachdem, welches Element (Knoten, Server, Library, Programm) in der Zeile enthalten ist, in der Sie das Kommando eingeben. Beispiele: Wenn die Zeile einen Knoten- oder Servernamen enthält, wird der Cursor unter die Spalte Server platziert. Enthält die Zeile den Namen einer Library oder eines Programms, wird der Cursor unter die Spalte Library gesetzt.
MM	Markiert den zu verschiebenden Zeilenblock.
P	Kopiert oder verschiebt den mit CC oder MM markierten Zeilenblock oberhalb der Zeile, in der der Befehl eingegeben wurde.

Um einen Zeilenblock zu kopieren oder zu verschieben:

1. Überschreiben Sie am Anfang der Zeile, in der der Block beginnt, die laufende Nummer mit einem der folgenden Zeilenkommandos.

   Um den Block zu kopieren:

   CC

   Um den Block zu verschieben:

   MM

2. Überschreiben Sie am Anfang der Zeile, in der der Block endet, die laufende Nummer mit einem der folgenden Zeilenkommandos.

   • Um den Block zu kopieren:

     CC

   • Um den Block zu verschieben:

     MM

3. Drücken Sie ENTER.

   Die Zeilenkommandos verschwinden, die laufenden Nummern werden wieder angezeigt und der Zeilenblock ist markiert.

4. Geben Sie am Anfang der Zeile, unter oder über der Sie den markierten Zeilenblock platzieren wollen, eines der folgenden Zeilenkommandos ein, um den Block zu kopieren oder zu verschieben.

   • Um den Block unter die angegebene Zeile zu kopieren oder zu verschieben:

     A

   • Um den Block über die angegebene Zeile zu kopieren oder zu verschieben:

     P

   Anmerkung
   Die Zeilenkommandos A oder P sind nur in Zeilen ausführbar, in denen mindestens ein Feld gefüllt ist.

5. Drücken Sie ENTER.

   Der Zeilenblock wird unter oder über die angegebene Zeile kopiert bzw. verschoben.

Lokale Kommandos und PF-Tasten

Im Bildschirm Service Directory können Sie die folgenden lokalen Kommandos in die Kommandozeile eingeben bzw. durch Drücken der entsprechend belegten PF-Tasten absetzen.

Lokales Kommando	PF-Taste	Funktion
EXPIRATION		Die Daten des Remote Directory werden zur Laufzeit geladen. Die Verfallszeit in Sekunden bestimmt die Gültigkeitsdauer dieser Daten. Wenn Directory-Daten nach der eingestellten Ablaufzeit angefordert werden, werden sie automatisch neu geladen. Wird die Verfallszeit auf 0 gesetzt, werden die Remote Directory-Daten nicht neu geladen. Mit dem lokalen Kommando EXPIRATION können Sie eine Verfallszeit in Sekunden eingeben, zum Beispiel EXPIRATION 86400. Das Maximum ist eine 8-stellige Zahl. Wenn Sie mit dem Kommando keinen Parameter angeben, erscheint das Fenster Expiration Time, in dem Sie die aktuelle Verfallszeit anzeigen oder ändern können.
RESET		Entfernt die mit einem Zeilenkommando gesetzten Zeilenmarkierungen, siehe Zeilenkommandos. Beachten Sie, dass, wenn Zeilen falsch markiert wurden, eine entsprechende Meldung erscheint und Sie den fehlerhaften Zeilenbefehl entfernen müssen, bevor Sie RESET eingeben.
	PF1	Ruft die Online-Hilfe des Editors auf.
	PF2	Öffnet das Fenster Long Name, in dem Sie einen Knotennamen mit bis zu 192 Zeichen eingeben können.
	PF3	Exit (Beenden): Fordert Sie auf, die Änderungen zu speichern und den Bildschirm Service Directory zu verlassen.
FIND	PF4	Ruft das Fenster Find Item auf, in dem Sie nach einem Namen suchen können::   Find what Was suchen: Geben Sie eine alphanumerische Suchzeichenfolge mit bis zu 32 Zeichen ein.   Case sensitive Groß-/Kleinschreibung: Ersetzen Sie die Standardeinstellung N (Nein) durch Y (Ja), um zwischen Groß- und Kleinbuchstaben zu unterscheiden.   Whole words only Nur ganze Wörter: Ersetzen Sie die Standardeinstellung N (Nein) durch Y (Ja), um nur nach ganzen Wörtern zu suchen.   Drücken Sie ENTER, um die Suche zu starten und von einem Treffer zum nächsten zu gelangen, falls ein solcher vorhanden ist. Drücken Sie PF4, um die Suche von Anfang an zu starten. Die Treffer werden mit dem Cursor markiert.
REPLACE	PF16	Ruft das Fenster Replace Item (Element ersetzen) auf, in dem Sie nach einzelnen oder mehreren Namen suchen und diese ersetzen können (Groß- und Kleinschreibung wird dabei nicht beachtet):   Find Suchen: Geben Sie eine alphanumerische Suchzeichenfolge mit bis zu 32 Zeichen ein.   Replace with Ersetzen durch: Geben Sie eine alphanumerische Ersetzungszeichenfolge mit bis zu 32 Zeichen ein.   Whole words only Nur ganze Wörter: Ersetzen Sie die Standardeinstellung N (Nein) durch Y (Ja), um nur nach ganzen Wörtern zu suchen.   Search only Nur suchen: Standardmäßig werden alle Namen im Service-Directory nach Übereinstimmungen durchsucht (leerer Feldeintrag). Sie können einen der folgenden Buchstaben eingeben, um die Suche auf eines der folgenden Elemente zu beschränken:   N Nur Knotennamen S Nur Servernamen L Nur Library-Namen P Nur Programmnamen   Replace all Alles ersetzen: Ersetzt alle gefundenen Vorkommen der Suchzeichenfolge.   Drücken Sie ENTER, um mit der Suche zu beginnen und von einem Treffer zum nächsten zu gelangen, falls einer vorhanden ist. Drücken Sie PF4, um die Suche von Anfang an zu starten. Die Treffer werden mit dem Cursor markiert.
REPLACE replace-clause		Führt die im Fenster Replace Item angebotenen Ersetzungsfunktionen aus. Entspricht der replace-clause-Klausel des SYSRPC SM REPLACE-Kommandos.
-H	PF5	Blättert eine halbe Seite vor/zurück.
+H	PF6
-P	PF7	Blättert eine Seite rückwärts/vorwärts.
+P	PF8
TOP	PF9	Blättert an den Anfang der Liste.
BOT	PF10	Blättert an das Ende der Liste.
	PF11	Schaltet zwischen der Standardansicht des Service Directory-Bildschirms (siehe Beispiel 1 - Service Directory-Standardansicht) und der erweiterten Ansicht der Felder Knoten und Server um (siehe Beispiel 2 - Erweiterte Service Directory-Ansicht).
>	PF11	Zeigt die erweiterte Ansicht der Felder Node und Server an. In der erweiterten Knoten-/Serveransicht werden die Felder Library und Program nicht angezeigt, wie in Beispiel 2 - Erweiterte Service Directory-Ansicht dargestellt. Zeigt die Standardansicht des Bildschirms Dienstverzeichnis an, wie in Beispiel 1 - Standardansicht des Dienstverzeichnisses dargestellt.
<	PF11	Zeigt die Standardansicht des Bildschirms Service Directory an, wie in Beispiel 1 - Service Directory-Standardansicht dargestellt.
CANCEL	PF12	Beendet den Bildschirm Service Directory, ohne Änderungen zu speichern.

API USR8216N zur Pflege des Service Directory

Sie können die Anwendungsprogrammierschnittstelle (API) USR8216N verwenden, um Service Directory Maintenance-Funktionen auszuführen.

USR8216N ruft ein vorhandenes Service Directory ab und fügt Einträge im Dienstverzeichnis hinzu, ändert oder löscht sie.

USR8216N wird in der Natural SYSEXT System Library ausgeliefert. Anleitung zur Handhabung siehe Eine Natural API verwenden in SYSEXT Utility-Beschreibung.