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

- Kommandos für RPC-Server-Tasks ausführen

## 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 alle Server-Tasks des ausgewählten RPC-Servers (EntireX Broker Service). Siehe auch RPC-Server beenden. |  | X
`TI` | Trace-Informationen: Ruft den aktuellen Trace-Level-Wert ab. 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 alle Server-Tasks mit ihren Folgenummern für einen ausgewählten RPC-Server in einer Liste an. In dieser Liste können Sie ein Kommando für einen einzelnen Server-Task oder ein Kommando für alle Server-Tasks ausführen. Siehe auch Kommandos für RPC-Server-Tasks ausführen. |  | 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 Linux oder Windows)
`ALL` | - | Pingt alle RPC-Server an, die im Service Directory der aktuellen Library definiert sind.

## RPC-Server beenden

In der Standardansicht oder erweiterten Nachrichtenansicht des Bildschirms Server Command Execution stehen die folgenden Kommandos zur Verfügung, um einen RPC-Server oder EntireX Broker Service 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 z/OS-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.

Der folgende Abschnitt enthält Anleitungen zum Beenden einer einzelnen RPC-Server-Task oder eines EntireX Broker Service über die Standardansicht.

Alternative Methoden zur Beendigung von Servern finden Sie unter Beenden eines Natural RPC Servers 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 Verwendung von Security, Natural RPC mit Natural Security verwenden, 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:

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.

## Kommandos für RPC-Server-Tasks ausführen

Verschaffen Sie sich zunächst einen Überblick über alle verfügbaren RPC-Server-Tasks für einen RPC-Server auf der gleichen oder auf verschiedenen Plattformen, die auf einem EntireX Broker registriert sind.

Um eine Liste aller RPC-Server-Tasks mit Folgenummer zu erhalten:

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.

   Der Bildschirm Server Command Execution auf Server-Task-Ebene wird mit der Liste aller Server-Tasks für einen RPC-Server angezeigt.

   Die folgenden Informationen werden angezeigt:

   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), `term` (beendet) oder `active` (bei Ping- und Trace-Kommandos).

   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 Linux), einer LPAR (auf z/OS) 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 im Bildschirm Server Command Execution(PF3) oder zum Menü Client Maintenance (PF12) zurückkehren.

3. Wählen Sie eine der folgenden Möglichkeiten:

   - Für eine einzelne Server-Task
     Geben Sie in der Spalte Cmd neben der Folgenummer der Server-Task eines der folgenden Kommandos ein.

   - Für alle Server-Tasks
     Drücken Sie PF4 (Cmds) und geben Sie in dem Eingabefenster eines der folgenden Kommandos ein.

     Informationen zum Ausführen eines Kommandos für eine RPC-Server-Task mithilfe der Anwendungsprogrammierschnittstelle USR9204N finden Sie in der entsprechenden Dokumentation zum Natural RPC (Remote Procedure Call).

     Kommando | Beschreibung
     --- | ---
     `PI` | Pingt einen einzelnen Server-Tasks bzw. alle Server-Tasks eines RPC-Server an.
     `TE` | Beendet einen einzelnen Server-Tasks bzw. alle Server-Tasks eines RPC-Server an.
     `TI` | Trace-Informationen: Ruft den aktuellen Trace-Level-Wert für einen einzelnen Server-Task bzw. alle Server-Tasks eines RPC-Server ab.
     `Tn` | Setzt den Trace-Level für einen einzelnen Server-Task bzw. alle Server-Tasks eines RPC-Server dynamisch. n steht für `0` bis `9`. `T0` bedeutet, dass die Trace-Funktion abgeschaltet ist.
     `T*` | Ruft ein Fenster auf, in dem Sie den Trace-Level-Wert n eingeben und die Option Write-on-Error (`E`) für einen einzelnen Server-Task eines RPC-Server angeben können. Die Trace-Level-Werte `T1E` bis `T9E` können auch für alle Server-Tasks eines RPC-Servers nach Drücken der Taste `PF4` (Cmds) eingestellt werden.

   Wichtig
   Die Kommandos `PI`, `TI`, `T0`, `T1` bis `T9` und `T1E` bis `T9E` werden abgelehnt, wenn die von der aktuellen Natural-Sitzung verwendete CIS-Version nicht hoch genug ist, um das angeforderte EntireX-Kommando zu unterstützen (erforderlich: EntireX Broker 11.0 mit CIS-Version 13 und höher). Sie können die CIS-Version des EntireX Brokers mit dem Kommando `IV` im Menü Client Maintenance überprüfen.

   Drücken Sie ENTER.

   Der RPC-Server gibt die Meldung/Fehlermeldung und den geänderten Status für die angeforderte(n) Server-Task(s) zurück.

   In der ersten Informationszeile der Server-Task steht dann die Meldung `Successful reponse` (`Erfolgreiche Antwort` nach Beendigung), die Ping-Informationen oder der Trace-Level.

   In der zweiten Informationszeile der Server-Task wird die Fehlermeldung mit Fehlernummer und Fehlertext angezeigt, z. B. `Participant not found` (`Teilnehmer nicht gefunden`, wenn die Server-Task bereits beendet ist), `Function disallowed by Natural Security` (Funktion durch Natural Security nicht erlaubt) oder `Command SEND-COMMAND not supported` (Kommando `SEND-COMMAND` nicht unterstützt, wenn die CIS-Version das Kommando noch nicht unterstützt, siehe wichtiger Hinweis oben).

### On this page

- Funktion Server Command Execution benutzen
- RPC Server anpingen
- RPC-Server beenden
- Kommandos für RPC-Server-Tasks ausführen