Die SYSRPC Utility bietet die Server-Ausführungskommandos
ping und terminate. Sie
werden verwendet, um aktive Server zu kontrollieren, die im Service Directory
definiert wurden:
Das Kommando ping sendet eine interne
Nachricht an den Server, um eine Serververbindung zu verifizieren.
Das Kommando terminate sendet entweder
eine interne Nachricht an den Server, um die Beendigung einer einzelnen
Server-Task anzufordern, oder gibt ein Kommando an den EntireX Broker aus, das
die Beendigung aller mit einem EntireX Broker-Dienst verbundenen Server-Tasks
anfordert.
Die Server-Ausführungskommandos verweisen auf das Service Directory in
der Library, das mit dem
NTRPC/RPC-Schlüsselwort-Subparameter
RPCSDIR
definiert ist (siehe Parameter-Referenz-Dokumentation).
Wenn RPCSDIR nicht gesetzt ist (dies ist die
Standardeinstellung), wird die Library verwendet, in der Sie gerade angemeldet
sind. Der Name der Library wird in der oberen rechten Ecke des Bildschirms
Server Command
Execution angezeigt, wie im folgenden Abschnitt
dargestellt.
Dieser Abschnitt behandelt folgende Themen:
Um die Funktion Server Command Execution zu benutzen:
Geben Sie im Feld Code im Menü Client Maintenance das folgende Kommando ein:
XC
Die Standardansicht des Bildschirms Server Command Execution erscheint (Beispiel):
15:16:30 ***** NATURAL SYSRPC UTILITY ***** 2016-07-18
- Server
Command Execution - Library SAGTRPC2
Cmd Node Server Message
1 ETB045
2 __ NRPC001 Natural
3 __ NRPC002
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help ERR Exit -H +H -P +P TOP BOT < Canc |
Die Standardansicht des Bildschirms zeigt die Felder Node, Server und Message. Die Felder in der Spalte Message werden abgeschnitten angezeigt und enthalten maximal 8 Zeichen.
Wenn Sie PF11 drücken oder das Kleiner-als-Zeichen (<) in die Kommandozeile unten im Bildschirm eingeben, wird die erweiterte Ansicht des Bildschirms Server Command Execution angezeigt (Beispiel):
16:36:39 ***** NATURAL SYSRPC UTILITY ***** 2016-07-18
- Server
Command Execution - Library SAGTRPC2
Cmd Server Message
1
2 __ NRPC001 Natural RPC Server 8.3.7 on WNT-x86
3 __ NRPC002
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help ERR Exit -H +H -P +P TOP BOT > Canc |
In der erweiterten Ansicht können Sie maximal 50 Zeichen Nachrichtentext in der Spalte Message anzeigen. In dieser Ansicht wird die Spalte Node nicht angezeigt und die Felder in der Spalte Server werden abgeschnitten und zeigen maximal 16 Zeichen an (in der Standardansicht werden 30 Zeichen angezeigt).
Wenn Sie ein weiteres Mal PF11 wählen oder das Größer-als-Zeichen (>) in die Kommandozeile eingeben, wird wieder die Standardansicht des Bildschirms Server Command Execution angezeigt, wie im Beispiel für eine Standardansicht dargestellt.
In diesem Abschnitt werden die folgenden Themen behandelt:
Welche Zeilenkommandos auf dem Bildschirm Server Command Execution verfügbar sind, hängt davon ab, ob sie auf einem EntireX Broker-Knoten oder einem RPC-Server-Knoten ausgeführt werden. In der folgenden Tabelle zeigt ein X an, ob ein Kommando für einen Knoten verfügbar ist.
| Zeilenkommando | Beschreibung | Broker | Server |
|---|---|---|---|
PI |
Broker-Knoten:
Pingt alle für den ausgewählten EntireX-Broker definierten Server ab.
Server-Knoten: Pingt den ausgewählten RPC-Server an. Siehe auch das Direktkommando
|
X | X |
TE |
Beendet den ausgewählten RPC-Server. | X | |
TS |
Beendet den ausgewählten EntireX Broker Service. | X | |
LS |
Listet die auf dem ausgewählten EntireX
Broker registrierten Server auf.
Siehe auch Direktkommando
|
X | X |
IV |
Listet die Versionen des ausgewählten EntireX Brokers und seiner Command and Information Services (CIS) sowie die Version des EntireX Broker Stub auf. | X | X |
Sie können einen RPC-Server über die Standardansicht oder die
erweiterte Nachrichtenansicht des Bildschirms Server Command
Execution oder mit dem Direktkommando
SYSRPC
PING anpingen.
Informationen zum Anpingen eines RPC-Servers über die Anwendungsprogrammierschnittstelle USR2073N finden Sie in der entsprechenden Natural RPC (Remote Procedure Call)-Dokumentation.
Der folgende Abschnitt enthält eine Anleitung für das Anpingen eines RPC-Servers über die Standardansicht des Bildschirms Server Command Execution screen.
Um einen RPC-Server über den Bildschirm Server Command Execution
anzupingen:
Geben Sie im Bildschirm Server Command Execution in der Spalte Cmd neben dem/den Server(n), der/die angepingt werden soll(en), das folgende Zeilenkommando ein:
PI
Beispiel:
16:41:32 ***** NATURAL SYSRPC UTILITY ***** 2016-07-18
- Server
Command Execution - Library SAGTRPC2
Cmd Node Server Message
1 __ ETB045
2 PI NRPC001
3 PI NRPC002
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help ERR Exit -H +H -P +P TOP BOT > Canc |
Drücken Sie ENTER. Der Server (bzw. die Server) gibt die Meldung zurück:
Server version on operating system
Dabei bezeichnet Server den Servertyp und version die Version des Betriebssystems operating system, auf dem der Server läuft.
Beispiel-Nachricht:
Natural RPC Server 8.3.7.0 on WNT-x86
Wenn das Anpingen des Servers fehlschlägt und stattdessen ein Fehler auftritt, können Sie PF2 (ERR) wählen, um RPC-bezogene Natural- und EntireX-Broker-Meldungen anzuzeigen, wie unter Programm RPCERR verwenden (Den Status einer RPC-Sitzung überwachen in der Natural RPC (Remote Procedure Call)-Dokumentation beschrieben.
Um mehr von dem Meldungstext anzuzeigen, der in der Standardansicht des Bildschirms Server Command Execution abgeschnitten erscheint (siehe auch Beispiel für eine Standardansicht), gehen Sie wie folgt vor:
Drücken Sie PF11.
Oder:
Geben Sie in der Kommandozeile das Kleiner-als-Zeichen (<)
ein.
Sie können einen RPC-Server im Online- und Batch-Modus mit dem
Direktkommando SYSRPC PING anpingen.
Es gilt die folgende Kommandosyntax:
SYSRPC PING
server-name
ON broker-name
[[PORT]
port-number][TRANSPORT
{TCP|SSL|NET}] |
Die im Syntax-Diagramm verwendeten Symbole werden im Abschnitt Syntax-Symbole in der Statements-Dokumentation erläutert.
Die Syntax-Elemente werden in der folgenden Tabelle erläutert:
Die SYSRPC Utility bietet zwei Kommandos zum Beenden eines
Servers: TE (Terminate RPC Server) und
TS (Terminate EntireX Broker Service):
TE beendet eine einzelne
RPC-Server-Task, indem eine interne Nachricht an den RPC-Server gesendet wird.
Wenn ein RPC-Server mit mehreren RPC-Server-Tasks (einschließlich Replikaten
auf Großrechner-Plattformen) verknüpft ist, können Sie entweder jede
RPC-Server-Task einzeln mit TE beenden oder alle
RPC-Server-Tasks in einem Zug mit dem Kommando TS
beenden.
TS beendet alle Server-Tasks, die
mit einem EntireX Broker Service verbunden sind, indem es die EntireX Broker
Command and Information Services (ETBCIS; Details finden Sie in der
EntireX-Dokumentation) aufruft. Der Begriff Service fasst
hier alle Server-Tasks zusammen, die unter demselben Servernamen auf derselben
oder auf verschiedenen Plattformen laufen.
Sie können Server-Tasks über die Standardansicht oder erweiterte Nachrichtenansicht des Bildschirms Server Command Execution beenden.
Der folgende Abschnitt enthält Anweisungen zum Beenden einer einzelnen RPC-Server-Task oder eines EntireX Broker Service über die Standardansicht.
Alternative Methoden zur Beendigung von Servern finden Sie unter Terminating a Natural RPC Server in der Natural RPC (Remote Procedure Call) -Dokumentation.
Um eine einzelne RPC-Server-Task zu beenden:
Geben Sie im Feld Code des Menüs Client Maintenance das folgende Kommando ein:
XC
Die Standardansicht des Bildschirms Server Command Execution wird angezeigt.
Geben Sie in der Spalte Cmd neben dem/den zu beendenden Server(n) das folgende Zeilenkommando ein:
TE
(Dies ist vergleichbar mit der Eingabe des Kommandos
PI, wie im
Beispiel zum Anpingen
eines Servers gezeigt).
Drücken Sie ENTER.
Der Server gibt die Meldung aus:
Terminating Server version on operating system
Server bezeichnet den Servertyp; version bezeichnet die vier- oder fünfstellige Produktnummer; operating system bezeichnet das Betriebssystem, das auf dem Server läuft.
Beispielmeldung:
Terminating Natural RPC Server 6.3.1.0 on WNT-x86
Wenn die Beendigung des Servers fehlschlägt und stattdessen ein Fehler auftritt, können Sie PF2 (ERR) wählen, um RPC-bezogene Natural- und EntireX-Broker-Meldungen anzuzeigen, siehe Programm RPCERR verwenden (Den Status einer RPC-Sitzung überwachen, Natural RPC (Remote Procedure Call)-Dokumentation).
Um mehr vom Meldungsinhalt anzuzeigen, der in der Standardansicht des Bildschirms Server Command Execution abgeschnitten erscheint:
Drücken Sie PF11.
Oder:
Geben Sie in der Kommandozeile das
Kleiner-als- Zeichen (<) ein.
Wenn im Service Directory die Option
Logon
gesetzt ist, werden die Anmeldedaten (Benutzerkennung, Passwort und
Library-Name) mit dem Kommando TE an den Server
gesendet, wie es bei der Remote-Ausführung von CALLNAT üblich ist.
Das Fenster Security Token Data wird angezeigt und fordert zur Eingabe von Benutzerkennung und Kennwort auf, wenn auf der Client-Seite kein Natural Security installiert ist und keine Anmeldedaten mit der Anwendungsprogrammierschnittstelle USR1071N für die aktuelle Natural-Sitzung festgelegt wurden. Siehe auch USR1071N in Using Security, Using Natural RPC with Natural Security, in der Natural RPC (Remote Procedure Call) -Dokumentation.
Wenn auf der Server-Seite LOGONRQ=ON gesetzt
wurde (siehe auch
Verwendung
von Security in der Natural RPC (Remote
Procedure Call)-Dokumentation), müssen die Anmeldedaten vom Client
mit dem Kommando TE gesendet werden.
Wenn Natural Security auf dem Server installiert ist, müssen die übertragenen Anmeldedaten eine Anmeldung bei der Natural System Library SYSRPC ermöglichen.
Um einen EntireX Broker Service zu beenden:
Geben Sie im Feld Code des Menüs Client Maintenance das folgende Kommando ein:
XC
Die Standardansicht des Bildschirms Server Command Execution wird angezeigt.
Geben Sie in der leeren Spalte zwischen der laufenden Nummer und der Spalte Node in der Zeile, die zu dem zu beendenden Server gehört, das folgende Kommando ein:
TS
(Dies ist vergleichbar mit der Eingabe des Kommandos
PI, wie es im
Beispiel zum Anpingen
eines Servers gezeigt wurde).
Drücken Sie ENTER.
Es erscheint das Fenster SYSRPC - Terminating EntireX Broker Service.
Falls für die Anmeldung erforderlich, geben Sie die entsprechende Benutzerkennung und das Passwort für den EntireX Broker ein.
Wenn Sie Server-Tasks, die an einer Konversation beteiligt
sind, beenden wollen, geben Sie im Feld Terminate
immediately ein Y ein, um die sofortige Beendigung
anzufordern. Wenn Sie ein N eingeben (dies ist die
Standardeinstellung), bleiben alle an einer Konversation beteiligten
Server-Tasks in Betrieb.
Wenn Sie nicht möchten, dass dieses Fenster während der aktuellen SYSRPC-Sitzung wiederholt angezeigt wird, wählen Sie Do not show this window again (Dieses Fenster nicht mehr anzeigen).
Drücken Sie ENTER, um den EntireX Broker Service zu beenden.