Mehrere Interface-Objekte generieren

#### Search Results

Search

# 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

- Name und Komprimierungsart angeben

## 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

- SYSRPC SGMASS-Report

### 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

- Komprimierung

### 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.

### On this page

- Direktkommando SYSRPC SGMASS benutzen
- Name und Komprimierungsart angeben