In diesem Kapitel enthält Beschreibungen der Natural-Textmodule NATTEXT,
NATTXT2, NATTXT2U, NATTXT3 und das Natural-Makro
NTERMSG.
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
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.
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.
 |
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.
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.
|
STATNAM NTKEY FIND
NTALT BROWSE
NTALT GET
NTALT ACCEPT
NTALT REJECT
NTALT HISTOGRAM
STATNAM NTKEY FIND
NTSYN RECHERCHE
NTALT BROWSE
NTSYN LISEZ
NTALT %
NTALT ACCEPT
NTALT REJECT
NTALT %
|
Das Modul NATTXT2 enthält die Makros NTKEYT,
NTALTT und NTSYNT, die Folgendes definieren:
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.
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.
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.
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.
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.
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.
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.