Alle SYSMAIN-Funktionen können bei benutzerdefinierten und bei Natural-System-Fehlermeldungen angewendet werden. Fehlermeldungen können von einer Library in eine andere verschoben werden, oder die Sprachtexte der einzelnen Fehlermeldungen können kopiert (Copy), verschoben (Move) oder ersetzt (Replace) werden. Darüber hinaus ist es möglich, eine einzelne Fehlermeldung oder einen Bereich von Fehlermeldungen mit Hilfe der Umbenennungsfunktion (Rename) neu zu nummerieren.
Wenn Natural Security installiert ist, dürfen nur autorisierte Benutzer die Fehlermeldungen des Natural-Systems bearbeiten.
Fehlermeldungen werden je nach Typ in den Systemdateien gespeichert:
Fehlermeldungen des Natural-Systems werden in der Systemdatei FNAT gespeichert.
Benutzerdefinierte Fehlermeldungen in der Systemdatei FUSER oder FNAT gespeichert.
Dieser Abschnitt beschreibt die Menüfunktionen und Auswahllistenoptionen, die für die Ausführung einer SYSMAIN-Funktion bei Fehlermeldungen zur Verfügung stehen, sowie die Syntax, die bei der Benutzung von Direktkommandos gilt.
SYSERR Utility-Dokumentation.
Die Error Message Texts-Menüs enthalten alle SYSMAIN-Funktionen, die für die Bearbeitung von Fehlermeldungen erforderlich sind. Die Felder, die in einem Menü vorhanden sein können, sind in der folgenden Tabelle beschrieben:
| Feld | Erläuterung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Code |
|
||||||||||||
| Sel. List |
|
||||||||||||
| No. From or Number | Nummer von oder Nummer: Die Nummer der zu verarbeitenden Fehlermeldung bzw. die Anfangsnummer eines Nummernkreises, wenn im Feld No. To eine Endnummer angegeben ist. Siehe auch Fehlermeldungen neu nummerieren. | ||||||||||||
| No. To | Nummer bis: Die Endnummer eines zu bearbeitenden Nummernbereichs von Fehlermeldungen, wenn im Feld No. From eine Startnummer eingegeben wird. Siehe auch Fehlermeldungen neu nummerieren. | ||||||||||||
| New From | Neu von: Gilt für die Funktion
Rename (Umbenennen).
Die neue Nummer, die einer bestehenden Fehlermeldung gegeben werden soll, oder die Startnummer eines Bereichs neuer Nummern, die einem Bereich bestehender Fehlermeldungen gegeben werden sollen. Siehe auch Fehlermeldungen neu nummerieren. |
||||||||||||
| New To | Neu bis: Gilt für die Funktion
Rename (Umbenennen).
Die Endnummer eines Bereichs neuer Fehlermeldungsnummern, die einem Bereich vorhandener Fehlermeldungen zugewiesen werden. Siehe auch Fehlermeldungen neu nummerieren. |
||||||||||||
| Library | Der Name einer Quell- oder Ziel-Library oder eines
Bereichs von Namen. Wenn Sie Natural System-Fehlermeldungen verarbeiten wollen,
lassen Sie das Feld Library leer.
Die Quell-Library enthält die zu verarbeitende(n) Fehlermeldung(en). Die Ziel-Library ist die Library, in die die Fehlermeldung kopiert oder verschoben werden soll, oder in der die Fehlermeldung neu nummeriert wird. Siehe auch Auflisten und Auswählen von Libraries. |
||||||||||||
| Lang. | Sprache: Der/die Code(s) der Sprache(n), in dem/denen
die Fehlermeldung verfügbar ist.
Die Sprachen können durch eine beliebige Kombination von
Sprachcodes angegeben werden. Informationen darüber, welcher Sprachcode welcher
Sprache zugeordnet ist, finden Sie unter
Sprachcode-Zuordnungen
in *LANGUAGE in der
Systemvariablen-Dokumentation. Für die erweiterten
(langen) Fehlermeldungen des Natural-Systems ist nur der Sprachcode
Siehe auch Sprachen angeben. |
||||||||||||
| Database | Datenbank: Die Datenbankkennung (DBID) einer Quell-
oder Zieldatenbank.
Die Quelldatenbank enthält die Library und die Systemdatei, in der die zu bearbeitende Fehlermeldung gespeichert ist. Die Zieldatenbank enthält die Library und die Systemdatei, in die die Fehlermeldung kopiert (Copy) oder verschoben (Move) werden soll, oder in der die Fehlermeldung neu nummeriert (Rename) wird. Gültige Datenbankkennungen: |
||||||||||||
| File | TDatei: Die Dateinummer (FNR) einer Quell- oder
Zielsystemdatei.
Gültige Dateinummern: Die Quelldatei enthält die Library, in der die zu bearbeitende Fehlermeldung gespeichert ist. Die Zieldatei enthält die Library, in die die Fehlermeldung kopiert (Copy) oder verschoben (Move) werden soll, oder in der die Fehlermeldung neu nummeriert (Rename) wird. |
||||||||||||
| Replace |
|
||||||||||||
Wenn die selektive Verarbeitung aktiviert ist, wird auf einem Auswahlbildschirm (Selection) eine Auswahlliste mit allen Fehlermeldungen angezeigt, die den angegebenen Auswahlkriterien entsprechen.
Dieser Abschnitt beschreibt, welche Spalten ein Auswahlbildschirm enthält und welche Zeilenkommandos zur Weiterverarbeitung einer Fehlermeldung zur Verfügung stehen:
Die folgenden Spalten werden auf einem Auswahlbildschirm (Selection) angezeigt:
| Spalte | Erläuterung |
|---|---|
| C | Eingabefeld für Zeilenkommandos (siehe unten). |
| Error | Fehler: Der Name der Fehlermeldung, die den angegebenen Auswahlkriterien entspricht. |
| Error Message Text | Fehlermeldungstext: Der Text der kurzen Fehlermeldung. |
| Type | Der Typ der Fehlermeldung: S (kurz)
und/oder E (erweitert/lang).
|
| Lang | Sprache: Der erste Sprachcode in fortlaufender oder
alphabetischer Reihenfolge, der für die Fehlermeldung existiert. Wenn Sie auf
einem Auswahlbildschirm (Selection) alle zu einer
Fehlermeldung existierenden Sprachen anzeigen wollen, geben Sie das
Zeilenkommando L ein oder verwenden Sie die
Auflistfunktion (List).
|
| Message | Meldung: Die Meldung, die den Bearbeitungsstatus
einer Fehlermeldung angibt.
Diese Spalte erscheint nur, wenn ein Zeilenkommando bei einer Fehlermeldung ausgeführt wurde. Mögliche Meldungen siehe Status-Meldungen. |
In der Spalte C (Command) eines Auswahlbildschirms (Selection) kann eines der folgenden Zeilenkommandos eingegeben werden:
| Zeilenkommando | Funktion |
|---|---|
A
|
Verarbeitet jeden in der Spalte
Type aufgeführten Meldungstyp. Der Typ kann sein: kurz
(S), erweitert/lang (E) oder kurz und erweitert
(S/E).
|
E
|
Verarbeitet die erweiterte (lange) Meldung, wenn die
entsprechende kurze Meldung in der Zielumgebung vorhanden ist.
Wenn |
S
|
Verarbeitet alle Kurzmeldungen. |
L
|
Überprüfen einer Fehlermeldung, bevor sie verarbeitet
wird. Die kurze und/oder erweiterte (lange) Fehlermeldung wird für alle
vorhandenen Sprachen angezeigt, je nach der zuvor im Menü Error
Message Texts (Fehlermeldungstexte) angegebenen Funktion.
Dieses Zeilenkommando kann auch auf einem Library Selection-Bildschirm verwendet werden (siehe auch Auflisten und Auswählen von Libraries). |
Sie können eine einzelne Fehlermeldung oder einen Bereich von Fehlermeldungen neu nummerieren.
Um eine einzelne Fehlermeldung neu zu nummerieren:
Geben Sie in das Feld No. From die Nummer der Fehlermeldung ein, die Sie neu nummerieren möchten, und geben Sie in das Feld New From die neue Fehlermeldungsnummer ein.
Geben Sie in das Feld Source Library den Namen der Library ein, die die umzunummerierende Fehlermeldung enthält.
Soll die umnummerierte Fehlermeldung in einer anderen Library abgelegt werden, geben Sie in das Feld Target Library den Library-Namen ein.
Um einen Bereich von Fehlermeldungen neu zu nummerieren:
Geben Sie in das Feld No. From die Anfangsnummer des neu zu nummerierenden Bereichs von Fehlermeldungen und in das Feld No. To die Endnummer ein.
Geben Sie in das Feld New From die Anfangsnummer eines neuen Bereichs von Fehlermeldungen und in das Feld New To die Endnummer ein.
Die Anzahl der Fehlermeldungen, die durch den Bereich in den
Feldern No. From und Nr. To der
Quell-Library angegeben wird, muss mit der Anzahl des Bereichs in den Feldern
New From und New To der Ziel-Library
übereinstimmen. Es ist beispielsweise nicht möglich, die Fehlermeldungsnummern
1 - 6 als neue Fehlermeldungsnummern 7 -
10 zu nummerieren.
Wenn Sie einen Bereich von Fehlermeldungen innerhalb einer
einzigen Library neu nummerieren möchten, dürfen sich die Werte des Bereichs
nicht überschneiden. Es ist beispielsweise nicht möglich, die
Fehlermeldungsnummern 1 - 6 als neue Meldungsnummern
5 - 10 zu nummerieren.
Geben Sie in das Feld Source Library den Namen der Library ein, die die neu zu nummerierenden Fehlermeldungen enthält.
Wenn die neu nummerierten Fehlermeldungen in einer anderen Library abgelegt werden sollen, geben Sie einen Namen in das Feld Target Library ein.
Siehe auch die Beispiele für Bereichsangaben unter RENAME in Direktkommando-Syntax für Fehlermeldungen.
Bei der Angabe von Sprachen ist Folgendes zu beachten:
Wenn die Auflistungsfunktion (List)
ausgeführt wird und der angegebene Sprachcode bei der Fehlermeldung nicht
existiert, verwendet SYSMAIN die in der Systemvariablen
*LANGUAGE angegebene Standardsprache (siehe
*LANGUAGE in
der Systemvariablen-Dokumentation).
Wenn bei einer Quellfehlermeldung ein Stern (*) angegeben wird, überschreiben alle für diese Fehlermeldung definierten Sprachcodes alle für die Zielfehlermeldung definierten Sprachcodes.
Beispiel: Wenn die Quellfehlermeldung nur in den Sprachen
1, 2 und 3 existiert und für die
Zielfehlermeldung nur die Sprachen 1, 4 und
6 definiert sind, existiert die resultierende Zielfehlermeldung
nach Ausführung einer Kopierfunktion (Copy) nur in den
Sprachen 1, 2 und 3.
Wenn die Sprachen als einzelne Codes angegeben sind, wird jede Ausprägung des Sprachcodes einzeln verarbeitet.
Beispiel: Wenn die Quellfehlermeldung die Sprachen
1, 2 und 3 enthält und die Sprachcodes
auf 123 gesetzt sind, und wenn die Zielfehlermeldung die Sprachen
1, 4 und 6 enthält und die Sprachcodes
ebenfalls auf 123 gesetzt sind, enthält die resultierende
Zielfehlermeldung nach Ausführung einer Kopierfunktion
(Copy) die Sprachen 1, 2,
3, 4 und 6, aber nur die englische
Zielfehlermeldung (Sprache 1) wird durch den englischen Text der
Quellfehlermeldung überschrieben.
Wenn für die Quellfehlermeldung ein einziger Sprachcode und für die Zielfehlermeldung mehrere Sprachcodes angegeben sind, ist die resultierende Zielfehlermeldung nach Ausführung der Kopierfunktion (Copy) in der ersten für das Ziel angegebenen Sprache.
Dieser Abschnitt zeigt die Syntax, die bei der Ausführung einer SYSMAIN-Funktion für Fehlermeldungen mit Direktkommandos im Online- oder Batch-Modus gilt. Allgemeine Anleitungen zur Verwendung von Direktkommandos finden Sie im Abschnitt Kommandos ausführen.
Erläuterungen zu den Schlüsselwörtern und Variablenwerten, die in den folgenden Syntax-Diagrammen verwendet werden, finden Sie unter Schlüsselwörter und Variablen in Direktkommandos. Die Symbole in den Syntax-Diagrammen entsprechen den Syntax-Symbolen, die für Systemkommandos verwendet werden. Diese Symbole werden unter Systemkommando-Syntax in der Systemkommandos-Dokumentation erläutert.
Die Syntax der where-Klausel (where-clause) und der With-Klausel (with-clause) ist für alle Kommandos gleich.
Wichtig:
Bei Systemfehlermeldungen geben Sie als
lib-name NATURAL-SYSTEM
oder NATURAL-SYS an.
In diesem Abschnitt werden die folgenden Themen behandelt:
|
|
|
ERROR
|
|||
| number | [THRU
number]
|
||||
FM [LIBRARY]
lib-name
[where-clause]
|
|||||
TO [LIBRARY]
lib-name
[where-clause]
[with-clause]
|
COPY ERROR 1 FM ACCOUNTS TO ACCOUNTS1 REP WITH TYPE A
C ERROR 1 THRU 50 FM ACCT WHERE DBID 1 FNR 10 LANG 123456 TO ACCT WHERE DBID 5 FNR 26 LANG 234567 WITH REP HELP
MOVE E 200 THRU 210 FM ACCT FNR 10 LANG 123 TO ACCT LANG 123 TYPE S
M E 376 TYPE E FM ACCT LANG E TO ACCT LANG G
DELETE
|
ERROR
|
number | [THRU number]
|
||||
|
|
IN [LIBRARY]
lib-name
|
|
[where-clause] | [with-clause] | |||
DELETE ERROR 1 THRU 10 IN LIBRARY ACCT WHERE DBID 1 FNR 2 PSW GUESS CIPH 137561 WITH TYPE E MON HELP
D E 100 IN ACCT
FIND
|
ERROR
|
number |
|
IN [LIBRARY]
lib-name
|
|
[where-clause] | [with-clause] |
FIND E 4280 IN A* MON
F ERROR 10 IN LIB ACCT WHERE DBID 1 FNR 3 WITH TYPE E
LIST
|
ERROR
|
number | [THRU
number]
|
|
IN [LIBRARY]
lib-name
|
|
[where-clause] | [with-clause] |
LIST E 1 THRU 10 IN ACCT
L ERROR 100 THRU 150 IN LIB ACCT WHERE DBID 12 FNR 5
Wenn innerhalb einer einzelnen (Quell-)Library ein Bereich von Fehlermeldungen neu nummeriert wird, dürfen sich die Wertebereiche nicht überschneiden. Siehe Beispiele für ungültige Nummernbereiche.
RENAME
|
ERROR
|
number | [THRU
number]
AS new-number
|
[THRU
new-number]
[with-clause]
|
|||
IN [LIBRARY]
lib-name
[where-clause]
|
|||
TO [LIBRARY]
lib-name
[where-clause]
|
RENAME ERR 1 AS 101 IN ACCT
R ERROR 1 THRU 100 AS 101 THRU 200 IN CLAIMS
R ERROR 101 THRU 200 AS 1 THRU 100 IN CLAIMS
RENAME ERROR 1 THRU 50 AS 11 THRU 60 WITH TYPE A REP HELP MON RCOP IN LIBRARY ACCT WHERE DBID 1 FNR 2 TO LIB ACCOUNT WHERE FNR 3
Die folgenden Beispiele sind ungültig, weil sich die Nummernbereiche überlappen:
R ERROR 1 THRU 100 AS 51 THRU 150 IN CLAIMS
R ERROR 101 THRU 200 AS 51 THRU 150 IN CLAIMS
[WHERE] [DBID
dbid]
[FNR fnr]
[NAME
vsam-name]
[CIPHER
cipher]
|
|||||||
|
|
|
|
|
password |
|
[LANGUAGE
language]
|
[SEC
(dbid,fnr,password,cipher)]
|
Kommas müssen als Trennzeichen zwischen den Werten nach dem
Schlüsselwort SEC verwendet werden, oder wenn ein Wert fehlt. Zum
Beispiel: SEC (10,,secret,2a). Wenn der Session-Parameter
ID (siehe ID -
Input-Begrenzungszeichen in der
Parameter-Referenz-Dokumentation) auf Komma
(,) gesetzt wurde, verwenden Sie einen Schrägstrich
(/) als Trennzeichen zwischen den Werten.
[WITH] [TYPE
type]
[REPLACE] [ RCOP]
|
|
|
|
|
[HELP]
|
