Fehlermeldungen bearbeiten

#### Search Results

Search

# Fehlermeldungen bearbeiten

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.

- Felder in den Menüs für Fehlermeldungen

- Auswahllisten für Fehlermeldungen

- Fehlermeldungen neu nummerieren

- Sprachen angeben

- Direktkommando-Syntax für Fehlermeldungen

#### Verwandtes Thema:

SYSERR Utility-Dokumentation.

## Felder in den Menüs für Fehlermeldungen

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 |
Gibt an, ob eine kurze und/oder eine erweiterte (lange) Fehlermeldung verarbeitet werden soll. Mögliche Werte:
`A` | Jede Fehlermeldung, für die eine kurze und/oder eine erweiterte (lange) Meldung vorliegt, wird verarbeitet.
`E` | Jede Fehlermeldung, zu der eine erweiterte (lange) Fehlermeldung vorliegt, wird verarbeitet. Es werden nur erweiterte Fehlermeldungen mit zugehörigen kurzen Fehlermeldungen verarbeitet. Eine erweiterte Fehlermeldung kann nicht in eine Zielumgebung übertragen werden, wenn keine entsprechende kurze Fehlermeldung in der Zielumgebung vorhanden ist.
`S` | Jede Fehlermeldung, zu der eine kurze Fehlermeldung vorhanden ist, wird verarbeitet.
Sel. List |
Gibt an, ob selektive oder automatisierte Verarbeitung verwendet wird:
`Y` | Ja: Selektive Verarbeitung ist aktiviert. Bei der Verarbeitung von Fehlermeldungen wird eine Auswahlliste angezeigt. Dies ist die Standardeinstellung. Welche Spalten und Zeilenkommandos auf einer Auswahlliste zur Verfügung stehen, erfahren Sie unter Auswahllisten für Fehlermeldungen.
`N` | Nein: Die selektive Verarbeitung ist ausgeschaltet.
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 `1` verfügbar. Geben Sie einen Stern (*) ein, um Fehlermeldungen in allen vorhandenen Sprachen auszuwählen. 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: `1` bis `65535`.
File | TDatei: Die Dateinummer (FNR) einer Quell- oder Zielsystemdatei. Gültige Dateinummern: `1` bis `65535`. 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 |
Ersetzen: Gibt an, ob eine Fehlermeldung bei der Funktion Verschieben (Move), Kopieren (Copy) oder (Rename) ersetzt werden soll:
`Y` | Ja: Eine Fehlermeldung mit derselben Nummer, die in der Zielumgebung vorhanden ist, wird ersetzt.
`N` | Nein: Eine Fehlermeldung mit der gleichen Nummer, die in der Zielumgebung vorhanden ist, wird nicht ersetzt. Dies ist die Standardeinstellung.
Siehe auch Option Replace (Ersetzen) verwenden.

## Auswahllisten für Fehlermeldungen

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:

- Spalten

- Zeilenkommandos

### Spalten

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.

### Zeilenkommandos

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 `E` bei einer Meldung angegeben wird, die nur als Kurzmeldung existiert, wird ein Fehler zurückgegeben.
`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).

## Fehlermeldungen neu nummerieren

Sie können eine einzelne Fehlermeldung oder einen Bereich von Fehlermeldungen neu nummerieren.

Um eine einzelne Fehlermeldung neu zu nummerieren:

1. 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.

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

1. 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.

2. 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.

## Sprachen angeben

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.

## Direktkommando-Syntax für Fehlermeldungen

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:

- COPY und MOVE

- DELETE

- FIND

- LIST

- RENAME

- where-clause

- with-clause

### COPY und MOVE

| `COPY` `MOVE` |  | `ERROR` |  |
number | [`THRU` number]
| `FM` [`LIBRARY`] lib-name [where-clause]
|  |  |  |  | `TO` [`LIBRARY`] lib-name [where-clause] [with-clause]

#### Beispiele:

    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

`DELETE` | `ERROR` | number | [`THRU` number] |  |
|  |  |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Beispiele:

    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

`FIND` | `ERROR` | number |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Beispiele:

    FIND E 4280 IN A* MON

    F ERROR 10 IN LIB ACCT WHERE DBID 1 FNR 3 WITH TYPE E

### LIST

`LIST` | `ERROR` | number | [`THRU` number] |  | `IN` [`LIBRARY`] lib-name |  | [where-clause] | [with-clause]

#### Beispiele:

    LIST E 1 THRU 10 IN ACCT

    L ERROR 100 THRU 150 IN LIB ACCT WHERE DBID 12 FNR 5

### RENAME

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]

#### Beispiele:

    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

#### Beispiele für ungültige Nummernbereiche:

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

[`WHERE`] [`DBID` dbid] [`FNR` fnr] [`NAME` vsam-name] [`CIPHER` cipher]
|  | `PASSWORD` `PSW` |  | password |  | [`LANGUAGE` language] | [`SEC` (dbid,fnr,password,cipher)]

#### Trennzeichen

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

[`WITH`] [`TYPE` type] [`REPLACE`] [ `RCOP`] |  | `PROMPT` `NOPROMPT` |  |  | `MON` `NOMON` |  | [`HELP`]

### On this page

- Felder in den Menüs für Fehlermeldungen
- Auswahllisten für Fehlermeldungen
- Fehlermeldungen neu nummerieren
- Sprachen angeben
- Direktkommando-Syntax für Fehlermeldungen