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 (wird auf z/VSE nicht unterstützt)
NET Entire Net-Work (nicht unterstützt unter UNIX 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

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.

Beginn der AnweisungslisteUm 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.