Benötigte Puffergröße berechnen

Das Direktkommando SYSRPC CSMASS wird verwendet, um die Puffergröße zu berechnen, die RPC-Aufrufe ohne Interface-Objekte benötigen, um Daten vom Client zum Server oder umgekehrt zu senden. Die Angabe der Größe hilft Ihnen, die verwendete Middleware-Schicht zu konfigurieren, z.B. die Broker-Attributdatei, wenn EntireX Broker verwendet wird.

Falls gewünscht, können Sie auch Größenberechnungen für Interface-Objekte durchführen, auch wenn die Größen bereits bei der Generierung der Interface-Objekte berechnet werden.

Das Direktkommando SYSRPC CSMASS kann online oder im Batch-Modus verwendet werden.

Dieses Kapitel enthält folgende Informationen:


Direktkommando SYSRPC CSMASS benutzen

Um die benötigte Puffergröße online zu berechnen, können Sie das Direktkommando SYSRPC CSMASS an jeder Natural-Eingabeaufforderung eingeben.

Der folgende Abschnitt enthält Informationen über:

Syntax des Direktkommandos SYSRPC CSMASS

Die Syntax, die beim Direktkommando SYSRPC CSMASS gilt, ist im folgenden Diagramm dargestellt:

SYSRPC CSMASS [name] [compression]

Die Syntax-Elemente name und compression werden im Abschnitt Name und Komprimierungsart angeben erläutert.

SYSRPC CSMASS-Report

The SYSRPC CSMASS direct command produces a report that indicates the send and receive length requirements of the subprograms (objects) specified with the command as shown in the following example:

Das Direktkommando SYSRPC CSMASS erzeugt einen Bericht, der den mit dem Kommando angegebenen Bedarf an Sende- und Empfangslänge der Subprogramme (Objekte) anzeigt, wie im folgenden Beispiel gezeigt:

Page       1                                               2018-01-17 15:54:12

    SYSRPC - Calculation of Buffer Sizes for RPC Without Interface Objects


Calculation Criteria:

    Object name or range: RPC*
             Compression: 1


Calculation Results (sizes in bytes):

 Number of objects found:       8
     Maximum send length:  200228
  Maximum receive length: 1024192


Object     Type      Send Length   Receive Length   Message
--------   ----   --------------   --------------   --------------
RPCCALL1   N                 209              202
RPCCALL2   N                 219              240   Compression=2
RPCCALL3   N                 204              193
MORE

Der Report ist in drei Abschnitte gegliedert, die die folgenden Informationen enthalten:

  • Calculation Criteria - Berechnungskriterien:
    Die Kriterien, auf deren Grundlage die Berechnung durchgeführt wurde: ein einzelner Objektname oder ein Bereich von Namen (hier: RPC*) und die Komprimierung (hier: 1).

  • Calculation Results (sizes in bytes) - Berechnungsergebnisse (Größen in Bytes):
    Die Anzahl der Objekte, die für die Größenberechnung ausgewählt wurden.

    Die maximalen Puffergrößen, die alle ausgewählten Objekte zum Senden und Empfangen von Daten vom Client benötigen.

  • Object List - Objektliste:
    Der Name und der Typ (hier: N für den Typ Subprogramm) jedes für die Berechnung ausgewählten Objekts. Die Puffergrößen, die jedes Objekt zum Senden (Send Length - Sendelänge) und Empfangen (Receive Length - Empfangslänge) von Daten vom Client benötigt. Ein möglicher Kommentar zu jeder Objektberechnung in der Spalte Message - Nachricht. Im obigen Beispiel zeigt Compression=2 an, dass das Objekt RPCCALL2 nicht, wie im Kommando gefordert, mit Compression 1 berechnet wurde. Die Objektliste ist in alphabetischer Reihenfolge der Objektnamen sortiert.

Wenn die Eingabeaufforderung MORE erscheint, konnen Sie ENTER drücken, um zum Ende des Berichts zu blättern.

Wenn die Größenberechnung für einzelne oder mehrere Objekte fehlschlägt, zeigt der Bericht die Anzahl der betroffenen Objekte und entsprechende Fehlermeldungen an.

Namensangabe für Größenberechnung und Komprimierung

Sie können die Objekte ( Subprogramme oder PDAs) angeben, die für die Größenberechnung ausgewählt werden sollen, sowie die Art der Komprimierung, die verwendet werden soll:

Name

Sie können einen Objektnamen oder einen Bereich von Namen angeben. Falls Sie keinen Namen oder Namensbereich angeben, wird die Größe aller in der aktuellen Library enthaltenen Subprogramme oder PDAs berechnet.

Gültige Namensangaben sind im Folgenden beschrieben, wobei value eine beliebige Kombination aus einem oder mehreren alphanumerischen Zeichen ist:

Eingabe Ausgewählte Objekte
* Alle Subprogramme oder PDAs.

Dies ist die Standardeinstellung.

value Ein Subprogramm oder ein PDA mit einem Namen, der gleich value ist.
value* Alle Subprogramme oder PDAs mit Namen, die mit value beginnen.
value< Alle Subprogramme oder PDAs, deren Name kleiner oder gleich value ist.
value> Alle Subprogramme oder PDAs, deren Name größer oder gleich value ist.

Compression

Sie können eine der folgenden Komprimierungsarten angeben: 0, 1, 2. Die Angabe der Komprimierung ist optional. Der Standardtyp für die Generierung von Interface-Objekten ist 1.

Siehe auch Komprimierung verwenden in Betrieb einer Natural RPC-Umgebung in der Natural RPC (Remote Procedure Call)-Dokumentation.