Beim EntireX Broker registrierte Server auflisten

#### Search Results

Search

# Beim EntireX Broker registrierte Server auflisten

Sie können Informationen über RPC-Server, die beim EntireX Broker registriert sind, mit dem Direktkommando `SYSRPC SRVLIST` anfordern.

Das Direktkommando `SYSRPC SRVLIST` sendet einen Aufruf an den EntireX Broker und fordert Informationen über RPC-Server an, die beim EntireX Broker mit den Attributen `SERVER-CLASS=RPC` und `SERVICE=CALLNAT` registriert sind.

Sie können `SYSRPC SRVLIST` online (von einer Natural-Kommandoeingabe aus) oder im Batch-Modus ausführen.

Anmerkung
Wenn Sie dieses Kommando online ausführen, werden Sie in einem Fenster aufgefordert, sich bei dem im Kommando angegebenen EntireX Broker anzumelden.

Die folgende Kommandosyntax gilt für `SYSRPC SRVLIST`:

`SYSRPC SRVLIST` `server-name` `ON` `broker-name` `[[``PORT``]` `port-number``][``TRANSPORT` `{TCP|SSL|NET}]`[`USING``{HEAD1MAP|``object-name}]`

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)
`object-name` | A8 | Name des Natural-Text-Objekts, das zum Anpassen eines Server-Reports verwendet wird. Siehe auch Server-Listen anpassen.

In diesem Kapitel werden die folgenden Themen behandelt:

- Beispiel für ein SYSRPC SRVLIST-Direktkommando

- Server-Liste anzeigen

- Zusätzliche Server-Informationen anzeigen

- Server-Listen anpassen

## Beispiel für ein SYSRPC SRVLIST-Direktkommando

    SYSRPC SRVLIST SERV* ON BRK123

Dieses Kommando gibt Daten für alle Server zurück, deren Namen mit `SERV` auf EntireX Broker `BRK123` beginnen.

## Server-Liste anzeigen

Wenn Sie das Direktkommando `SYSRPC SRVLIST` online ausführen, wird der Bildschirm Servers registered on ... mit einer Server-Liste angezeigt (Beispiel):

     13:03:53             ***** NATURAL SYSRPC SRVLIST *****             2016-07-14
                           - Servers registered on BRK123 -
     Cmd  Server           TransRoutine   Requests ConvTimeouts ServersActive Conv>
     ---  ---------------- ------------ ---------- ------------ ------------- ---->
      _   SERVRPC1                               0           60             1
      _   SERVRPC2         SAGTCHA               0           60             1
      _   SERVRPC3                               0           60             1
      _   SERVRPC4         SAGTCHA              76           60             1
      _   SERVRPC5                            2035           60             1
      _   QA42RPC6         RPCTRNS              25          600             2
      _   QA42RPC7                           11190           60             1
      _   QA42RPC8                             206           60             1

    Command ===>

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit              --    -     +     ++          >     Canc

Die Spalten und Spaltenüberschriften auf dem Bildschirm Servers werden im Textobjekt `HEAD1MAP` beschrieben. Siehe auch Server-Listen anpassen.

Sie können durch die Liste navigieren und zusätzliche Server-Informationen anzeigen, indem Sie die in der folgenden Tabelle beschriebenen Kommandos verwenden.

Die Spalte ganz links, die den Namen des RPC-Servers enthält, bleibt immer an ihrer Position, wenn Sie in der Liste nach rechts oder links blättern.

Kommando | Beschreibung
--- | ---
PF3 | Beendet das Kommando.
PF6 | Blättert in den Daten zur Spalte ganz links.
PF7 | Blättert in den Daten nach links.
PF8 or PF11 | Blättert in den Daten nach rechts.
PF9 | Blättert in den Daten zur Spalte ganz rechts.
`I` | Zeilenkommando, das in der Spalte Cmd für einen aufgelisteten Server eingegeben wird. Zeigt zusätzliche Informationen über einen einzelnen RPC-Server an: Siehe auch Zusätzliche Server-Informationen anzeigen.

## Zusätzliche Server-Informationen anzeigen

Sie können zusätzliche Informationen zu einem bestimmten RPC-Server anzeigen.

Um zusätzliche Informationen für einen einzelnen Server anzuzeigen:

- Geben Sie in der Spalte Cmd des Bildschirms Servers registered on ... das Zeilenkommando `I` neben dem Server ein, zu dem Sie zusätzliche Informationen anzeigen möchten.

  Es erscheint der Bildschirm Information on Server (Beispiel):

       15:16:28             ***** NATURAL SYSRPC SRVLIST *****             2016-07-14
                       - Information on Server SERVRPC4 on BRK123 -
       Description                                                Value
       ---------------------------------------------------------- -------------------
       Character set used on platform...........................: EBCDIC
       Endian type of platform..................................: Big endian
       Status of user...........................................: Waiting
       Kind of conversation for which user waits................: NEW
       Server for which user waits (Class=RPC/Service=CALLNAT)..: SERVRPC4
       Number of active conversations of this user..............: 0
       Number of services active (offered) by this server.......: 1
       Elapsed time since the last activity of the user.........: 95
       Non-activity timeout in seconds..........................: 600
       Accumulated time server waited for new conversations.....: 68856
       Number of times server waited for new conversations......: 190
       Accumulated time server or client waited for messages of>: 0
       Number of times server or client waited for messages of >: 0
       Sum of conversations for the user since start of session.: 76
       Number of UOWs (units of work)...........................: 0
       IPv4 address of server...................................: 10.20.91.119

      Command ===>

  Der Bildschirm zeigt alle Informationen an, die EntireX Broker für den angeforderten Server zurückgegeben hat. Siehe auch Server-Listen anpassen.

## Server-Listen anpassen

Sie können eine Liste von Servern oder eine Liste mit Server-Informationen nach Bedarf neu anordnen, indem Sie das Textobjekt Natural `HEAD1MAP` bzw. `HEAD2MAP` verwenden. `HEAD1MAP` und `HEAD2MAP` werden in der SYSRPC System Library ausgeliefert.

Wir empfehlen Ihnen, `HEAD1MAP` (Liste der Server) aus der Library SYSRPC in eine benutzerdefinierte Library zu kopieren, bevor Sie mit der Bearbeitung der Liste beginnen. Sie können das Objekt dann umbenennen und im Kommando `SRVLIST` darauf verweisen.

Die Liste `HEAD2MAP` (Serverinformationen) können Sie nicht umbenennen.

Die zu verwendenden Textobjekte müssen in der aktuellen Library, in der mit dem `NTRPC`/`RPC`-Schlüsselwort-Subparameter `RPCSDIR` angegebenen Library (siehe Parameter-Referenz-Dokumentation) oder in der SYSRPC-Systembibliothek enthalten sein, wenn der Objektname `HEAD1MAP` verwendet wird.

`HEAD1MAP` und `HEAD2MAP` enthalten Anweisungen, wie Sie eine Liste nach Ihren Bedürfnissen ändern können. Sie können die Quellcodezeilen für Spalten und Überschriften, die in Ihrem Report nicht benötigt werden, auskommentieren. Sie können die Position der Codezeilen ändern, um die Spalten neu anzuordnen.

Ausnahmen:

- Bei `HEAD1MAP`: Sie dürfen die erste Quellcodezeile, die das Feld `SERVER-NAME` enthält, nicht auskommentieren oder verschieben. Sie dürfen den Namen eines Feldes in der Spalte Field nicht ändern.

- Bei `HEAD2MAP`: Sie dürfen den Namen eines Feldes in der Spalte Field nicht ändern.

### On this page

- Beispiel für ein SYSRPC SRVLIST-Direktkommando
- Server-Liste anzeigen
- Zusätzliche Server-Informationen anzeigen
- Server-Listen anpassen