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