Server-Kommandos ausführen (Server Command Execution)

#### Search Results

Search

# Server-Kommandos ausführen (Server Command Execution)

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:

- Funktion Server Command Execution benutzen

- RPC Server anpingen

- RPC-Server beenden

## Funktion Server Command Execution benutzen

Um die Funktion Server Command Execution zu benutzen:

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

       XC

2. Drücken Sie ENTER.

   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.

3. Wenn Sie PF11 drücken oder das Größer-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 Kleiner-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:

- Zeilenkommandos: Server Command Execution

### Zeilenkommandos: Server Command Execution

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 an. Server: Pingt den ausgewählten RPC-Server an. Siehe auch das Direktkommando `SYSRPC PING`. | X | X
`TE` | Beendet den ausgewählten RPC-Server. Siehe auch RPC-Server beenden. |  | X
`TI` | Trace-Informationen, aktuellen Trace-Level-Wert abrufen. Broker-Knoten: Zeigt die Trace-Informationen zu allen für den ausgewählten Broker definierten RPC-Server. Server: Zeigt die Trace-Informationen zum ausgewählten RPC-Server. | X | X
`Tn` | Setzt den Trace-Level für den ausgewählten RPC-Server dynamisch. n steht für `0` bis `9`. `T0` bedeutet, dass die Trace-Funktion abgeschaltet ist. |  | X
`T*` | Ruft ein Fenster auf, in dem Sie den Trace-Level-Wert n eingeben und die Option Write-on-Error (`E`) für den ausgewählten RPC-Server angeben können. |  | 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 `SRVLIST`. | 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

## RPC Server anpingen

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:

1. 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

2. 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.

3. Die vollständigen Meldungstexte werden automatisch in der erweiterten Nachrichtenansicht des Bildschirms Server Command Execution angezeigt (und die Belegung von PF11 ändert sich in das Kleiner-als-Zeichen (`<`).

- Direktkommando SYSRPC PING verwenden

### Direktkommando SYSRPC PING verwenden

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}]` `ALL` |

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:

Syntax-Element | Format/Länge | Beschreibung
--- | --- | ---
`server-name` | A32 | Name eines RPC-Servers oder ein Bereich von Namen. Ein Stern (*) wählt alle Namen aus. Stern-Notation wählt alle Namen aus, die mit dem angegebenen Wert beginnen.
`broker-name` | A32 | Name des EntireX-Brokers oder ein Bereich von Namen Ein Stern (*) wählt alle Namen aus. Stern-Notation wählt alle Namen aus, die mit dem angegebenen Wert beginnen.
`port-number` | N5 | Port-Nummer der für die Serververbindung verwendeten Netzwerkadresse. Gültige Werte: `0` bis `65535`
`TRANSPORT` | A3 | Vom EntireX Broker verwendete Transportmethode::
`TCP` | TCP/IP-Protokoll
`SSL` | SSL oder TLS
`NET` | Entire Net-Work (nicht unterstützt unter UNIX oder Windows)
`ALL` | - | Pingt alle RPC-Server an, die im Service Directory der aktuellen Library definiert sind.

## RPC-Server beenden

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:

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

       XC

   Die Standardansicht des Bildschirms Server Command Execution wird angezeigt.

2. 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).

3. 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).

   Der vollständige Meldungsinhalt wird automatisch in der Standardansicht des Bildschirms Server Command Execution (und PF11 ist mit dem Kleiner-als- Zeichen (<) belegt).

4. Wenn Sie PF11 erneut drücken oder das Kleiner-als- Zeichen (<) in der Kommandozeile unten im Bildschirm eingeben, wird wieder die Standardansicht des Bildschirms Server Command Execution angezeigt (siehe auch Beispiel für eine Standardansicht).

5. 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:

1. 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.

2. 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: `idle` (untätig), `busy` (beschäftigt) oder `term` (beendet).

   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.

3. 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:

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

       XC

   Die Standardansicht des Bildschirms Server Command Execution wird angezeigt.

2. 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).

3. Drücken Sie ENTER.

   Es erscheint das Fenster SYSRPC - Terminating EntireX Broker Service.

4. 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).

5. Drücken Sie ENTER, um den EntireX Broker Service zu beenden.

### On this page

- Funktion Server Command Execution benutzen
- RPC Server anpingen
- RPC-Server beenden