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 | |
LN |
Zeigt die Folgenummer(n) für einen ausgewählten RPC-Server in einer Liste an, in der Sie einen Server auswählen und beenden können. Siehe auch RPC-Server beenden. | 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 |
|
|
|
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:
Folgende Kommandos stehen zur Verfügung, um einen RPC-Server oder EntireX Broker Service aus der Standardansicht oder erweiterten Nachrichtenansicht des Bildschirms Server Command Execution zu beenden:
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.
|
LN |
Zeigt die Folgenummer(n) für einen
RPC-Server, der bei einem EntireX Broker Service registriert ist: Jeder
Server-Task wird durch Startdatum/-zeit, Host-Name, Anwendungsname und
IP-Adresse identifiziert und kann aus dieser Liste mit dem Kommando
TE ausgewählt und beendet werden.
|
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. |
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 eine einzelne RPC-Server-Task mit Folgenummer zu
beenden:
Geben Sie im Feld Code des Menüs Client Maintenance das folgende Kommando ein:
XC
Drücken Sie ENTER.
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:
LN
Drücken Sie ENTER.
Es wird eine Liste mit Server-Tasks angezeigt. Sie enthält folgende Informationen:
| Spalte | Beschreibung |
|---|---|
| SequenceNo | Die der Server-Task zugewiesene Nummer in der Reihenfolge, in der die Task beim EntireX Broker registriert wurde. |
| Date | Das Datum und die Uhrzeit (UTC), zu der die Server-Task gestartet wurde. |
| Time | |
| Host Name | Der Knoten, auf dem der Server gehostet wird. |
| Status | Der Status des Servers.
Mögliche Werte: |
Der Anwendungsname und die IP-Adresse (falls vorhanden) sind in der Zeile unter jeder nummerierten Zeile angegeben.
Der Anwendungsname hängt von der Umgebung ab, in der der Server läuft. Er kann z. B. der Name eines Natural-Images (auf UNIX), einer LPAR (auf dem Großrechner) oder einer gestarteten CICS-Task sein.
Die IP-Adresse zeigt die IPv4- oder IPv6-Adresse des Knotens an.
Mit den PF-Tasten können Sie auf dem Bildschirm navigieren und zur Liste aller Server (PF4) oder zum Menü Client Maintenance (PF3) zurückkehren.
Geben Sie in der Spalte Cmd neben der Folgenummer der zu beendenden Server-Task das folgenden Zeilenkommando ein:
TE
Drücken Sie ENTER.
Der Server gibt die Meldung Successful
response (Erfolgreiche Antwort) zurück, und der Status wechselt zu
term (beendet).
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.
