Mehrere Interface-Objekte generieren

Sie können einzelne oder mehrere Interface-Objekte entweder online oder im Batch-Modus erzeugen, indem Sie das Direktkommando SYSRPC SGMASS verwenden.

Interface-Objekte können Sie aus Subprogrammen oder Parameterdatenbereichen (PDAs) generieren.

Dieser Abschnitt enthält folgende Informationen:

Direktkommando SYSRPC SGMASS benutzen

Um Interface-Objekte online zu erzeugen, können Sie das Direktkommando SYSRPC SGMASS an jeder Natural-Eingabeaufforderung eingeben

Der folgende Abschnitt enthält Informationen über:

Syntax des Direktkommandos SYSRPC SGMASS

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

SYSRPC SGMASS [name] [compression]

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

SYSRPC SGMASS-Report

Das Direktkommando SYSRPC SGMASS erzeugt einen Bericht, der die mit dem Kommando erzeugten Interface-Objekte auflistet, wie im folgenden Beispiel gezeigt: 

Page       1                                               2018-01-17 11:58:33

    SYSRPC - Interface Object Generation in Library SAGTEST


Generation Criteria:

    Object name or range: RPC*
             Compression: 1


Generation 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:

  • Generation Criteria - Generierungskriterien:
    Die Kriterien, auf deren Grundlage das/die Interface-Objekt(e) generiert wurden: ein einzelner Objektname oder ein Namensbereich (hier: RPC*) und die Komprimierungsart (hier: 1).

  • Generation Results (sizes in bytes) - Generierungsergebnisse (Größe in Bytes):
    Die Anzahl der Objekte, die für die Generierung von Interface-Objekten ausgewählt wurden.

    Die maximalen Puffergrößen, die alle generierten Interface-Objekte zum Senden und Empfangen von Daten vom Client benötigen.

  • Object List - Objektliste:
    Name und Typ (hier: N für Objekttyp Subprogramm) jedes generierten Interface-Objekts. Die Puffergrößen, die jedes Objekt zum Senden (Send Length) und Empfangen (Receive Length) von Daten vom Client benötigt. Ein möglicher Kommentar zu jeder Generierung eines Interface-Objekts in der Spalte Message. Im obigen Beispiel zeigt Compression=2 an, dass das Objekt RPCCALL2 nicht, wie im Kommando gefordert, mit der Komprimierung 1 erzeugt wurde. Die Objektliste ist in alphabetischer Reihenfolge nach Objektnamen sortiert.

Wenn die Aufforderung MORE erscheint, können Sie ENTER drücken, um zum Ende des Reports zu blättern.

Wenn die Generierung der Interface-Objekte für einzelne oder mehrere Objekte fehlschlägt, zeigt der Report die Anzahl der betroffenen Objekte und die entsprechenden Fehlermeldungen an.

Name und Komprimierungsart angeben

Sie können die Objekte (Subprogramme oder PDAs) angeben, die für die Generierung von Interface-Objekten 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. Die Angabe eines Objektnamens oder eines Namensbereichs ist optional.

Warnung:
Wenn Sie keinen Objektnamen oder einen Namensbereich angeben, werden bis auf wenige Ausnahmen (siehe unten) alle Subprogramme oder PDAs in der aktuellen Library in Interface-Objekte umgewandelt.

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.

Ausnahmen bei Namen

In der Natural System Library SYSRPC nimmt SYSRPC SGMASS alle Subprogramme von der Generierung von Interface-Objekten aus, deren Namen mit einem der folgenden Präfixe beginnen: RDS, RPC, NAT, NAD oder NSC.

In User Libraries nimmt SYSRPC SGMASS das Subprogramm NATCLTGS von der Generierung von Interface-Objekten aus.

Komprimierung

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.