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.
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.
 |
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 % |
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:
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.