Natural-Text-Module und Makros

#### Search Results

Search

# Natural-Text-Module und Makros

In diesem Kapitel enthält Beschreibungen der Natural-Textmodule `NATTEXT`, `NATTXT2`, `NATTXT2U`, `NATTXT3` und das Natural-Makro `NTERMSG`.

- Funktion und Verwendung von Textmodulen

- NATTEXT - Natural-Schlüsselwort-Definitionen

- NATTXT2 - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Groß- un Kleinschreibung)

- NATTXT2U - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Großbuchstaben)

- NATTXT3 - Textfragmente für Platzhalter in Natural-Fehlermeldungen

- NTERMSG - Natural-Beendigungsmeldungen und Rückgabecodes

## Funktion und Verwendung von Textmodulen

Alle Natural-Schlüsselwörter, alternative Schlüsselwörter und Standard-Ausgabetexte sind in den Modulen `NATTEXT` und `NATTXT2` enthalten. Natural-Systemkommandos und alternative Systemkommandos sind ebenfalls als Schlüsselwörter und alternative Schlüsselwörter in diesen Modulen enthalten. Ersetzungstextfragmente für Natural-Fehlermeldungen sind im Modul `NATTXT3` enthalten. Die Module sind als Quellcode in der Natural Source Library und als Lademodul in der Natural Load Library enthalten.

Bei Bedarf können Sie Natural-Schlüsselwörter, alternative Schlüsselwörter und den in diesen Modulen enthaltenen Text ändern. Zum Beispiel können Natural-Sitzungsabbruchmeldungen von Englisch in eine andere Sprache geändert werden, Natural-Schlüsselwörter können deaktiviert oder Synonyme hinzugefügt werden.

Wenn Änderungen an einem `NATTEXT`-, `NATTXT2`- oder `NATTXT3`-Modul vorgenommen werden, muss jedes geänderte Modul assembliert, verlinkt und in das ausführbare Natural-Modul eingebunden werden. Siehe die entsprechende Natural-Installation-Dokumentation.

## NATTEXT - Natural-Schlüsselwort-Definitionen

The `NATTEXT` module contains the macros `NTKEY`, `NTALT` and `NTSYN` for each keyword and alternative keyword to be recognized by Natural.

Das Modul `NATTEXT` enthält die Makros `NTKEY`, `NTALT` und `NTSYN` für jedes Schlüsselwort und alternative Schlüsselwort, das von Natural erkannt werden soll.

### NATTEXT ändern

| Warnung: Es wird empfohlen, das Modul `NATTEXT` nur aus sehr wichtigen Gründen zu modifizieren, da es nach einer Änderung nicht mehr ordnungsgemäß vom Support gewartet werden kann.

Es gelten die folgenden Regeln:

- Ein Schlüsselwortwert für ein `NTKEY`- oder `NTALT`-Makro kann geändert werden, indem der aktuelle Schlüsselwortwert durch den gewünschten Wert ersetzt wird.

- Ein Schlüsselwort oder alternatives Schlüsselwort kann deaktiviert werden, indem der Schlüsselwortwert durch das Prozentzeichen (%) ersetzt wird.

- Die Position jedes `NTKEY`- und `NTALT`-Makros innerhalb des Moduls ist fest und darf nicht verschoben werden. Zusätzliche `NTKEY`- und `NTALT`-Makros dürfen nicht eingefügt werden.

- Mit dem Makro `NTSYN` können für jedes Schlüsselwort oder alternative Schlüsselwort Synonyme zugewiesen werden. Ein oder mehrere `NTSYN`-Makros können nach einem `NTKEY`- oder `NTALT`-Makro eingefügt werden. Das Makro `NTSYN` enthält einen Parameter, nämlich den Wert, der als Synonym verwendet werden soll. Wenn das Synonym eingebettete Leerzeichen enthält, muss der gesamte Wert in Hochkommata eingeschlossen werden.

### Beispiel für das Ändern des NATTEXT-Moduls

Das folgende Beispiel veranschaulicht, wie ein `NATTEXT`-Modul geändert wird. In diesem Beispiel

- soll das Synonym `RECHERCHE` für das Schlüsselwort `FIND` verwendet werden,

- das Synonym `LISEZ` soll für das alternative Schlüsselwort `BROWSE` verwendet werden,

- die Schlüsselwörter `GET` und `HISTOGRAM` sollen deaktiviert werden.

`NATTEXT` vor Änderung:
    STATNAM NTKEY FIND
            NTALT BROWSE
            NTALT GET
            NTALT ACCEPT
            NTALT REJECT
            NTALT HISTOGRAM
`NATTEXT` nach Änderung:
    STATNAM NTKEY FIND
            NTSYN RECHERCHE
            NTALT BROWSE
            NTSYN LISEZ
            NTALT %
            NTALT ACCEPT
            NTALT REJECT
            NTALT %

## NATTXT2 - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Groß- un Kleinschreibung)

The `NATTXT2` module contains the macros `NTKEYT`, `NTALTT` and `NTSYNT` which define the following:

Das Modul `NATTXT2` enthält die Makros `NTKEYT`, `NTALTT` und `NTSYNT`, die Folgendes definieren:

- Standard-Natural-Ausgabetexte

- Schlüsselwörter und alternative Schlüsselwörter für Natural Systemkommandos und Dienstprogramme (Utilities)

- Benutzerdefinierte Abbruchmeldungen

### Standard-Natural-Ausgabetexte

Das Modul `NATTXT2` enthält die folgenden Standard-Natural-Ausgabetexte, die jeweils auch in einer anderen Sprache ausgegeben werden können, wenn der Sprachcode entsprechend gesetzt ist (siehe auch unten):

- das Literal `Page` (Seite), das im Seitenkopf der Standardausgabe verwendet wird,

- der Name jedes Monats, wie er in der Natural-Systemvariablen `*DATG` (gregorianisches Datum) und in den Datums-Eingabemasken (L) verwendet wird, und der Name jedes Tages, wie er in den Datums-Editiermasken (N) verwendet wird,

- die Meldung `ENTER INPUT DATA` und die Skelett-Fehlermeldungen für die Fehlernummern 1104, 1105 und 1106 (die bei der Online-Eingabeverarbeitung verwendet werden),

- die Fehlermeldung, die verwendet wird, wenn eine Systemdatei nicht geöffnet werden konnte (die nicht aus der Systemdatei abgerufen werden kann); eine Fehlernummer der Form `NAT8xxx` (wobei `xxx` der dezimale Adabas-Antwortcode ist) wird dieser Fehlermeldung durch Natural hinzugefügt,

- die Konstanten `More`, `Top` und `Bottom`, die in Fenstern für die Anzeige von Positionsinformationen in Textform verwendet werden,

- die Tabelle zur Definition von Reports und die Report-Behandlung von Reports > 33.

Alle in `NATTXT2` enthaltenen Werte können geändert werden, indem der aktuelle Text durch den gewünschten Text ersetzt wird. Wenn ein Monatsnamen-Synonym länger als neun Zeichen ist, werden nur die ersten neun Stellen von der Systemvariablen `*DATG` verwendet.

`NTSYNT`-Makro-Statements können wie für das Modul `NATTEXT` beschrieben hinzugefügt werden. Mit `NATTXT2` kann jedoch ein zweiter Parameter angegeben werden. Dieser Parameter ist optional und steht für das Sprachkennzeichen, das für das Synonym verwendet werden soll. Die Angabe des Sprachkennzeichens bewirkt, dass Natural Meldungen ausgibt, die aus der Verwendung dieses Synonyms in der entsprechenden Sprache resultieren. Wenn Fehlermeldungstexte in der Natural-Systemdatei unter Verwendung eines anderen Sprachkennzeichens als 1 (dem Standardwert für Englisch) gespeichert wurden, werden Fehlermeldungen in der entsprechenden Sprache ausgegeben. Informationen darüber, welcher Sprachcode für welche Sprache steht, finden Sie beim Profilparameter `ULANG`.

### Schlüsselwörter und alternative Schlüsselwörter für Natural Systemkommandos und Dienstprogramme (Utilities)

Das Modul `NATTXT2` enthält `NTKEYT`- und `NTALTT`-Makros für jedes Schlüsselwort und jedes alternative Schlüsselwort, das von Natural für die folgenden Natural-Systemkommandos und -Dienstprogramme erkannt werden soll, sowie für die Parameter der Kommandos und gegebenenfalls deren Werte. Jedes dieser Makros kann auch in einer anderen Sprache verwendet werden, wenn der Sprachcode entsprechend eingestellt ist (siehe auch unten):

- alle Natural-Systemkommandos im Allgemeinen,

- für das Systemkommando `GLOBALS` die Parameter und ggf. deren Werte,

- für das Systemkommando `COMPOPT` die Parameter und ggf. deren Werte,

- allgemein zugängliche Systemkommandos (diese Systemkommandos sind permanent gültig und können weder durch Natural Security noch durch den Natural-Profilparameter `NC` gesperrt werden,)

- Natural-Dienstprogramme (Utilities).

Die Statements der Makros `NTKEYT` und `NTALTT` können ähnlich wie die Statements der Makros `NTKEY` und `NTALT` verwendet werden, wie für das Modul `NATTEXT` beschrieben.

Die Makro-Statements `NTSYNT` können wie unter Standard-Natural-Ausgabetexte beschrieben verwendet werden.

### Benutzerdefinierte Abbruchmeldungen

Mit dem Makro `NTERMSG` können benutzerdefinierte Abbruchmeldungen für alle Rückgabewerte (`1` - `255`) hinzugefügt werden, die mit einem `TERMINATE`-Statement ausgegeben werden können und die normalerweise zu der Natural-Abbruchmeldung NAT9987 führen.

Mit dem ersten Parameter wird der Text der Abbruchmeldung und mit dem zweiten Parameter der entsprechende Rückgabecode angegeben.

#### Beispiel:

    NTERMSG 'USR0077 THIS IS A SAMPLE USER MESSAGE FOR RETURN CODE 77',77

Ein Statement `TERMINATE 77` in einer Natural-Anwendung führt zu der folgenden Abbruchmeldung: `USR0077 THIS IS A SAMPLE USER MESSAGE FOR RETURN CODE 77`.

## NATTXT2U - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Großbuchstaben)

Das Modul `NATTXT2U` enthält die gleichen Elemente wie das Modul `NATTXT2`. Der Unterschied besteht darin, dass bestimmte Schlüsselwörter für die englische Sprache in `NATTXT2` in gemischter Großschreibung enthalten sind, während sie in `NATTXT2U` in Großbuchstaben geschrieben sind. Dies betrifft die Schlüsselwörter `MORE`, `TOP`, `BOTTOM`, `PAGE` und alle Monats- und Wochentagsnamen.

`NATTXT2U` sollte in Umgebungen, in denen die Kleinbuchstaben-Codepunkte `H'81'` bis `H'A9'` zur Darstellung nationaler Zeichen verwendet werden, anstelle von `NATTXT2` mit dem Natural-Nukleus verlinkt werden, z. B. wenn die Codepage 930 mit Katakana-Zeichen halber Breite verwendet wird.

## NATTXT3 - Textfragmente für Platzhalter in Natural-Fehlermeldungen

Das Modul `NATTXT3` enthält die Makros zur Definition von Textfragmenten, die in Natural-Fehlermeldungen den Platzhalter `:n:` ersetzen sollen.

Jedes Textfragment kann in verschiedenen Sprachen definiert werden. Welcher Sprachcode für welche Sprache steht, können Sie der Beschreibung des Profilparameters `ULANG` entnehmen.

Die Textfragmente werden in EBCDIC- und Unicode-Schreibweise erzeugt.

Anmerkung
Um das Modul NATTXT3 zu assemblieren, muss ein High-Level-Assembler verwendet werden, der die Makrofunktion `UPPER` und die Definition von Unicode-Zeichen (`DC CU’unicode text’`) unterstützt.

Beispiel:

Der Text für den Natural-Fehler NAT0082 (beim Versuch, ein nicht vorhandenes Programm auszuführen) sieht wie folgt aus:

    Invalid command, or :1: :2: does not exist in library.

Der Versuch, das Objekt `NOTEXIST` auszuführen, führt zu folgendem Ergebnis:

    NAT0082 Invalid command, or Program NOTEXIST does not exist in library.

`:2:` wurde durch den Objektnamen (`NOTEXIST`) ersetzt.

`:1:` wurde durch das Textfragment `Program` ersetzt.

Das Textfragment wurde im Modul `NATTXT3` wie folgt deklariert:

    *===============================================================
    *              PROGRAM                  0002
    *===============================================================
          MSGSDEF  &LC_PGM
             SPACE
    *---------------------------------------------------------------
          MSGSLAN  01,Program           1   ENGLISH
          MSGSLAN  02,Programm          2   GERMAN
          MSGSLAN  03,programme         3   FRENCH
          MSGSLAN  04,programa          4   SPANISH
             SPACE
    *---------------------------------------------------------------
          MSGSGEN

Textfragmentwerte für zusätzliche Sprachen können durch Hinzufügen weiterer `MSGSLAN`-Makros eingegeben werden.

## NTERMSG - Natural-Beendigungsmeldungen und Rückgabecodes

Natural verfügt über eine Reihe von Standard-Session-Termination-Meldungen (NAT99...), die im Makro `NTERMSG` ausgeliefert werden und dort geändert werden können (z.B. um sie in eine andere Sprache zu übersetzen). Die Gesamtlänge von ID und Text kann bis zu 72 Zeichen betragen. Nachdem das Makro `NTERMSG` geändert wurde, muss das Natural-Parametermodul neu assembliert und verlinkt werden.

Neben der Meldungskennung und dem Text enthält jede Standardbeendigungsmeldung auch einen der folgenden Natural-System-Rückgabecodes, die ebenfalls im Makro `NTERMSG` definiert sind:

Code | Erläuterung
--- | ---
`0` | Normale Beendigung.
`4` | Fehler bei der Ausführung/Kompilierung (nur Batch-Modus).
`8` | Beendigung aufgrund eines schweren Laufzeitfehlers.
`12` | Sitzungsinitialisierungsfehler.
`16` | Abnormale Beendigung aufgrund eines Abbruchs oder eines schweren Umgebungsfehlers.

Wenn der Profilparameter `TS` auf `ON` gesetzt ist, werden die Abbruchmeldungen mit Hilfe der Großbuchstabentabelle `NTUTAB1`, die im Modul `NATCONFG` bereitgestellt wird, in Großbuchstaben umgesetzt, bevor sie angezeigt werden.

Zusätzlich zu `TS=ON` werden weitere Parameter für die Umsetzung von Meldungen in Großbuchstaben von mehreren Natural-Komponenten bereitgestellt. Weitere Informationen finden Sie unter Weitere Parameter für die Umsetzung in Großbuchstaben in der Beschreibung des Profilparameters `TS`.

### On this page

- Funktion und Verwendung von Textmodulen
- NATTEXT - Natural-Schlüsselwort-Definitionen
- NATTXT2 - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Groß- un Kleinschreibung)
- NATTXT2U - Ausgabetext, Schlüsselwörter und Benutzerabbruchmeldungen (in Großbuchstaben)
- NATTXT3 - Textfragmente für Platzhalter in Natural-Fehlermeldungen
- NTERMSG - Natural-Beendigungsmeldungen und Rückgabecodes