Menüfunktionen und Kommandos benutzen

#### Search Results

Search

# Menüfunktionen und Kommandos benutzen

Eine SYSMAIN-Funktion kann entweder im Menü- oder im Kommandomodus ausgeführt werden.

In diesem Kapitel wird beschrieben, wie Sie ein SYSMAIN-Menü oder ein Direktkommando benutzen und welche Optionen bei der Ausführung einer SYSMAIN-Funktion zur Verfügung stehen.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Menüfunktionen ausführen

- Kommandos ausführen

- Beschreibung der Funktionen

- Funktionsverarbeitung und Reporting

- SYSMAIN-Online-Hilfe

## Menüfunktionen ausführen

Im Menümodus führen Sie eine SYSMAIN-Funktion aus, indem Sie Codes für den zu bearbeitenden Objekttyp und die auszuführende Funktion eingeben. Alternativ zur Eingabe eines Funktionscodes können Sie auch eine entsprechend belegte PF-Taste drücken.

Um eine SYSMAIN-Menüfunktion auszuführen:

- Geben Sie im Hauptmenü (Main Menu) des SYSMAIN-Dienstprogramms im Feld Object Code den aus einem Buchstaben bestehenden Code ein, der den gewünschten Objekten entspricht (im Beispiel unten: `A` für Programmierobjekte), und im Feld Function Code den aus einem Buchstaben bestehenden Code, der der gewünschten Funktion entspricht (im Beispiel unten: `C` für Kopieren). Alternativ zur Eingabe des Funktionscodes können Sie auch die PF-Taste drücken, die der Funktion entspricht (hier: PF4); siehe auch die Liste der PF-Tasten.

        12:41:50             ***** NATURAL SYSMAIN UTILITY *****            2013-04-05
        User SAG                       - Main Menu -

                    Code  Object                             Code  Function

                      A   Programming Objects                  C   Copy
                      D   Debug Environments                   D   Delete
                      E   Error Message Texts                  F   Find
                      P   Profiles                             L   List
                      R   Rules                                M   Move
                      S   DL/I Subfiles                        R   Rename
                      V   DDMs                                 ?   Help
                      X   Predict Sets
                      ?   Help                                 .   Exit
                      .   Exit

      Object Code .. A                       Function Code .. C

       Command ===>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Menu  Exit  Copy  Del   Find  List  Move  Ren

  Es wird dann das entsprechende, objekttypspezifische Menu angezeigt, in diesem Beispiel das Menü Copy Programming Objects:

        17:28:52             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
        User SAG                 - Copy Programming Objects -

                            Code  Function

                              A   Copy All/Individual Objects
                              C   Copy only Cataloged Objects
                              S   Copy only Saved Objects
                              W   Copy only Stowed Objects
                              ?   Help
                              .   Exit

                  Code ...... A           Sel. List ... Y
          Object  Name ...... *________   Type ........ _______________
                                          Set Number .. __     XREF .. N
          Source  Library ... OLDLIB__    Database .... 10___  File .. 50___
          Target  Library ... NEWLIB__    Database .... 10___  File .. 60___
          Options Replace ... N           Criteria .... N

       Command ===>
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Menu  Exit  Copy  Del   Find  List  Move  Ren   Fsec  Fdic  Fnat

  Die in einem objekttypspezifischen Menü angebotenen Felder hängen von der ausgeführten SYSMAIN-Funktion ab. Felder, die für eine bestimmte Funktion nicht zutreffen, werden im zugehörigen Bildschirm nicht angezeigt.

  Die Felder werden zur Angabe von Objektauswahlkriterien und Bearbeitungsoptionen verwendet. Erläuterungen zu den Feldern finden Sie in den objekttypspezifischen Kapiteln dieser Dokumentation.

### PF-Tasten benutzen

Mit den PF-Tasten können Sie Funktionen des SYSMAIN-Menüs ausführen. PF-Tasten, die innerhalb eines Menüs nicht gültig sind, werden für dieses Menü nicht angezeigt. Die PF-Tasten sind in der nachstehenden Tabelle zusammengefasst:

PF-Taste | Name | Funktion
--- | --- | ---
PF1 | Help | Hilfe Anzeige der Online-Hilfe in Abhängigkeit von der aktuellen Cursorposition. Befindet sich der Cursor im Feld Object Code oder Function Code, wird die allgemeine SYSMAIN-Hilfe angezeigt. Befindet sich der Cursor in einem anderen Feld, wird die feldspezifische Hilfe angezeigt. Siehe auch SYSMAIN Online-Hilfe.
PF2 | Menu | Menü Anzeige des Hauptmenüs (Main Menu) des SYSMAIN-Dienstprogramms.
PF3 | Exit | Beenden Rückkehr zum vorherigen Bildschirm. Wenn Sie PF3 im Hauptmenü (Main Menu) des SYSMAIN-Dienstprogramms drücken, wird SYSMAIN beendet.
PF4 | Copy | Kopieren Ausführen der Kopierfunktion (Copy) für das angegebene Objekt.
PF5 | Del | Entfernen Ausführen der Löschfunktion (Delete) für das angegebene Objekt.
PF6 | Find | Suchen Gilt nur bei Programmierobjekten und Fehlermeldungen. Ausführen der Suchfunktion (Find) für das angegebene Objekt.
PF7 | List | Liste Ausführen der Funktion List für das angegebene Objekt.
PF8 | Move | Verschieben Ausführen der Funktion Move für das angegebene Objekt.
PF9 | Ren | Umbenennen Gilt nicht bei DDMs. Ausführen der Funktion Rename für das angegebene Objekt aus.
PF10 | Fsec | Ruft den Security-Bildschirm zum Angeben der Adabas-Sicherheitsinformationen für die FSEC-Systemdatei auf, wenn Natural Security installiert ist.
PF11 | Fdic | Gilt nicht bei Debug-Umgebungen, Fehlermeldungen und Profilen. Gilt nur bei Programmierobjekten, Rules und DDMs. Ruft den Security-Bildschirm zum Angeben der Adabas-Sicherheitsinformationen für die FDIC-Systemdatei auf. Wenn Predict installiert ist, können Sie auch einen Predict Set-Benutzer angeben, wenn Sie die Funktionen Copy, Delete, Move oder Rename (Kopieren, Löschen, Verschieben oder Umbenennen) bei Programmierobjekten ausführen.
PF12 | Fnat | Gilt nicht bei Debug-Umgebungen, Fehlermeldungen, Predict Sets und Profilen. Ruft den Security-Bildschirm auf, um die Systemdatei-Informationen der Systemdateien FNAT und/oder FUSER anzugeben.

## Kommandos ausführen

Dieser Abschnitt enthält Anleitungen zum Ausführen einer SYSMAIN-Funktion mit Hilfe eines Direktkommandos oder eines Systemkommandos innerhalb des SYSMAIN-Dienstprogramms.

Ein Direktkommando wird verwendet, um eine SYSMAIN-Funktion entweder im Online- oder im Batch-Modus auszuführen.

Im Batch-Modus wird automatisch ein Report erstellt, der den Status der verarbeiteten Objekte anzeigt. Dieser Report kann auch im Online-Modus angezeigt werden. Siehe Online Report-Modus.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Direktkommandos absetzen

- SYSMAIN-Kommandozeile benutzen

### Direktkommandos absetzen

Direktkommandos bestehen aus einer Reihe von Schlüsselwörtern, die Parameter darstellen. Ein Punkt (.) kennzeichnet das Ende eines Kommandos. Wenn dieses Zeichen irgendwo in einer Kommandozeichenfolge erkannt wird, werden alle nachfolgenden Daten ignoriert.

Die für Direktkommandos geltende Syntax ist in den objekttypspezifischen Abschnitten der SYSMAIN Utility-Dokumentation beschrieben. Die entsprechenden Schlüsselwörter und Variablen werden in Schlüsselwörter und Variablen in Direktkommandos erläutert. Beispiele für Direktkommandos finden Sie in den objekttypspezifischen Abschnitten, in der SYSMAIN-Online-Hilfe und auf einem Auswahl-Bildschirm (siehe den Beispielbildschirm in Selektive Verarbeitung).

Um ein Direktkommando online abzusetzen:

- Geben Sie an einer beliebigen Natural-Eingabeaufforderung Folgendes ein:

      SYSMAIN

  gefolgt von einer Kommandozeichenfolge, wobei jedes Schlüsselwort durch ein Leerzeichen anstelle des Trennzeichens abgegrenzt werden kann.

  Oder:
  Geben Sie in der Kommandozeile eines beliebigen SYSMAIN-Menüs eine Direktkommandozeichenfolge ein, bei der jedes Schlüsselwort durch ein Leerzeichen anstelle des Begrenzungszeichens getrennt werden kann.

  Oder:
  Rufen Sie aus einem Natural-Objekt heraus das Subprogramm `MAINUSER` mit der Direktkommandozeichenfolge als Parameter auf, wobei jedes Schlüsselwort durch ein Leerzeichen anstelle des Begrenzungszeichens getrennt werden kann.

Um ein Direktkommando im Batch auszuführen:

1. Benutzen Sie das Kommando `SYSMAIN` und geben Sie eine Kommandozeichenfolge auf eine der beiden folgenden Arten an:

   1. Die Kommandozeichenfolge folgt dem `SYSMAIN`-Kommando in derselben Eingabezeile; jedes Schlüsselwort in der Kommandozeichenfolge kann durch ein Leerzeichen anstelle des Begrenzungszeichens abgegrenzt werden.

   2. Die Kommandozeichenfolge folgt dem `SYSMAIN`-Kommando in der nächsten Eingabezeile. Jedes Schlüsselwort in der Kommandozeichenfolge muss durch das Begrenzungszeichen und nicht durch ein Leerzeichen abgegrenzt werden.

      Wenn die Direktkommandozeichenfolge länger als eine Zeile ist, müssen die Zeichen `CF` (siehe auch den Session-Parameter `CF`, der in CF - Steuerzeichen für Terminalkommandos in der Parameter-Referenz-Dokumentation beschrieben ist) an das Ende der Zeile gesetzt werden, um mit dem Direktkommando in der nächsten Zeile fortzufahren.

2. Wenn Sie nach dem/den `SYSMAIN`-Kommandos andere Natural-Befehle ausführen wollen, müssen Sie SYSMAIN zunächst mit dem Direktkommando `END` oder `QUIT` beenden.

### SYSMAIN-Kommandozeile benutzen

In der Kommandozeile eines beliebigen SYSMAIN-Menüs können Sie eines der folgenden Kommandos eingeben:

- Ein Direktkommando zur Ausführung einer SYSMAIN-Funktion.

- Ein spezielles Kommando an das SYSMAIN-Dienstprogramm, das in An SYSMAIN absetzbare spezielle Kommandos beschrieben wird.

- Ein Systemkommando. Wenn der Befehl nicht eindeutig als Systemkommando identifizierbar ist, müssen ihm zwei Schrägstriche (//) vorangestellt werden. Siehe auch Bemerkungen in MAINEX05 - User-Exit-Routine zur Verifizierung von Direktkommandos.

## Beschreibung der Funktionen

Die Funktionen, die in einem SYSMAIN-Menü oder als Direktkommando zur Verfügung stehen, werden im folgenden Abschnitt beschrieben. Zu jeder Funktion, die in einem Menü angeboten wird, gibt es ein entsprechendes Direktkommando mit demselben Namen. Ausnahme: Help.

Die für Direktkommandos geltende Syntax finden Sie in den objekttypspezifischen Abschnitten dieser Dokumentation.

Die speziellen Kommandos, die an das SYSMAIN-Dienstprogramm abgesetzt werden können, finden Sie unter An SYSMAIN absetzbare spezielle Kommandos.

Funktion/Kommando | Erläuterung
--- | ---
Copy | Kopieren Kopiert ein Natural-Objekt oder ein Predict Set aus einer Quellumgebung in eine Zielumgebung. Das Objekt bleibt in der Quellumgebung unverändert. Wenn die Zielumgebung bereits ein Objekt mit dem gleichen Namen (oder im Falle einer Fehlermeldung oder eines Predict Set, mit der gleichen Nummer) wie das zu kopierende Objekt enthält, wird das angegebene Objekt nicht kopiert. Mit der Option Replace/Ersetzen (siehe Option Replace (Ersetzen) verwenden) können Sie ein Objekt in der Zielumgebung überschreiben.
Delete | Löschen Löscht ein Natural-Objekt oder ein Predict Set aus einer Quellumgebung. Bei der automatisierten Online-Verarbeitung (siehe Funktionsverarbeitung und Reporting) wird ein Bestätigungsfenster angezeigt, in dem Sie die Möglichkeit haben, die Funktion fortzusetzen oder abzubrechen. Bei Fehlermeldungen: Wenn Natural Security installiert ist, ist die Löschfunktion bei Systemfehlermeldungen nicht erlaubt. Wenn Sie versuchen, eine Systemfehlermeldung zu löschen, wird die folgende Natural-Systemmeldung angezeigt: `4897:Invalid error application specified` (Ungültige Fehleranwendung angegeben).
Find | Suchen Gilt nur bei Programmierobjekten und Fehlermeldungen. Findet ein oder mehrere Programmierobjekte oder Fehlermeldungen in einer Quellumgebung. Während der Online-Verarbeitung wird ein Fenster mit der aktuell durchsuchten Library angezeigt. Im Menümodus bietet die Suchfunktion auch die Möglichkeit, Libraries aufzulisten und auszuwählen oder die Anzahl der in einer Auswahlliste angezeigten Objekte zu reduzieren. Siehe Auflisten und Auswählen von Libraries bzw. Auswahlliste benutzen > Um eine Auswahlliste zu verkürzen.
List | Auflisten Zeigt einen Bereich von Natural-Objekten oder Predict Sets in einer Quellumgebung an. Bei Programmierobjekten, Debug-Umgebungen und Fehlermeldungen: Im Menümodus bietet die Auflistfunktion auch die Möglichkeit, Libraries aufzulisten und auszuwählen oder die Anzahl der in einer Auswahlliste angezeigten Objekte zu reduzieren. Siehe Auflisten und Auswählen von Libraries bzw. Auswahlliste benutzen > Um eine Auswahlliste zu verkürzen. Bei Programmierobjekten: Im Batch-Modus können Sie sich mit dem Direktkommando `LISTLIB` eine Liste der Library-Namen anzeigen lassen.
Move | Verschieben Überträgt ein Natural-Objekt oder ein Predict Set aus einer Quellumgebung in eine Zielumgebung. Das Objekt wird in der Quellumgebung gelöscht und in der Zielumgebung hinzugefügt. Wenn die Zielumgebung bereits ein Objekt mit demselben Namen (oder im Falle einer Fehlermeldung mit derselben Nummer) wie das zu verschiebende Objekt enthält, wird das angegebene Objekt nicht verschoben. Während der automatisierten Online-Bearbeitung wird ein Bestätigungsfenster angezeigt, das Ihnen die Möglichkeit gibt, die Funktion fortzusetzen oder abzubrechen. Mit der Ersetzungsoption (siehe Option Replace (Ersetzen) verwenden) können Sie das Objekt in der Zielumgebung überschreiben.
Rename |
Umbenennen Das Ergebnis der Umbenennungsfunktion hängt vom Typ des aufgerufenen Objekts ab:
Objekttyp | Ergebnis der Umbenennungsfunktion
Error Message | Fehlermeldung: Es wird eine neue Nummer zugewiesen.
Predict Set | Es wird eine neue Nummer und/oder ein neuer Benutzer und/oder eine neue Library zugewiesen.
Alle anderen | Das Objekt wird umbenannt.
Beachten Sie, dass die Funktion auf die folgenden Arten verwendet werden kann: Sie führen die Umbenennungsfunktion bei einem Objekt in der Quellumgebung aus. Sie führen die Umbenennungsfunktion bei einem Objekt in der Quellumgebung aus und kopieren/verschieben es in eine andere (d.h. Ziel-) Umgebung. Beachten Sie, dass die Umbenennungsfunktion jeweils nur für eine Umgebung ausgeführt werden kann. Die Umbenennungsfunktion löscht das ursprüngliche Objekt in der Quellumgebung. Deshalb werden Sie gefragt, ob Sie das ursprüngliche Objekt beibehalten wollen. Wenn das ursprüngliche Objekt beibehalten werden soll, wird es nicht gelöscht. Wenn in der Zielumgebung bereits ein Objekt mit dem gleichen Namen (oder im Falle einer Fehlermeldung oder eines Predict Set mit der gleichen Nummer) wie das angegebene Objekt vorhanden ist, wird die Umbenennungsfunktion nicht ausgeführt. In diesem Fall können Sie stattdessen die Option Replace (Ersetzen) verwenden (siehe Option Replace (Ersetzen) verwenden), um das Objekt in der Zielumgebung zu überschreiben. Bei automatisierter Verarbeitung kann die Umbenennungsfunktion keine Objektbereiche verarbeiten. Verwenden Sie stattdessen die Selektive Verarbeitung. Bei Fehlermeldungen: Wenn Sie einen Bereich von Fehlermeldungen innerhalb einer einzelnen (Quell-) Library neu nummerieren, dürfen sich die Werte des Bereichs nicht überschneiden. Es ist zum Beispiel nicht möglich, die Fehlernummern 1 - 6 in die neuen Fehlernummern 5 - 10 umzubenennen. Ein Bereich von Fehlermeldungen kann mit automatisierter Verarbeitung umbenannt werden. Wenn große Bereiche von Fehlermeldungen verarbeitet werden, kann die Verarbeitung der Meldungen erhebliche Ressourcen erfordern. In solchen Fällen ist die Verarbeitung im Stapelverarbeitungsmodus möglicherweise vorzuziehen.
Help | Hilfe Bietet Hilfeinformationen zu SYSMAIN. Siehe SYSMAIN Online-Hilfe. Die Hilfefunktion ist nur in einem SYSMAIN-Menü verfügbar. Ein entsprechendes Direktkommando gibt es nicht.
Exit | Beenden Beendet das SYSMAIN-Dienstprogramm. PF3 (Exit) beendet SYSMAIN ebenfalls, wenn Sie die Taste im Hauptmenü des SYSMAIN-Dienstprogramms drücken.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Option Replace (Ersetzen) verwenden

- Auflisten und Auswählen von Libraries

### Option Replace (Ersetzen) verwenden

Wenn die Zielumgebung bereits ein Objekt mit demselben Namen wie das zu kopierende, zu verschiebende oder umzubenennende Objekt enthält, wird das angegebene Objekt nicht verarbeitet und die Verarbeitung mit dem nächsten Objekt fortgesetzt. Mit der Replace-Option können Sie diese Standardfunktionalität außer Kraft setzen und das Objekt in der Zielumgebung überschreiben.

Wenn ein Programmierobjekt ersetzt wird, wird es auch aus dem Natural Buffer Pool gelöscht. Eventuell vorhandene Cross-Referenz-Datensätze werden ebenfalls gelöscht, wenn Predict installiert ist.

Um die Replace-Option im Kommandomodus zu aktivieren:

- Geben Sie in der Kommandozeichenfolge das Schlüsselwort `REPLACE`.

Um die Replace-Option im Menümodus zu aktivieren:

1. Geben Sie in einem SYSMAIN-Menü im Feld Replace ein `Y` ein.

2. Führen Sie eine Funktion aus. Wenn die Option Sel. List (Auswahlliste) auf `N` gesetzt wurde, erscheint ein Fenster, in dem Sie wählen können, ob Sie jeden Ersetzungsvorgang bestätigen möchten, bevor er ausgeführt wird: Geben Sie ein `Y` ein, um jeden Ersetzungsvorgang zu bestätigen, oder drücken Sie ENTER, um die Verarbeitung ohne Bestätigung fortzusetzen.

3. Wenn Sie ein `Y` zur Bestätigung einer Ersetzung eingegeben haben, erscheint für jedes zu ersetzende Objekt ein Fenster, in dem Sie eines der folgenden Zeichen eingeben können:

   - Bei Eingabe von `Y` wird das im Fenster angegebene Objekt ersetzt,

   - bei `N` wird das im Fenster angegebene Objekt nicht ersetzt (dies ist die Standardeinstellung)

   - Ein Punkt (`.`) beendet die Funktionsverarbeitung. Alternativ können Sie auch PF3 drücken.

### Auflisten und Auswählen von Libraries

Diese Option gilt nur bei Programmierobjekten, Debug-Umgebungen und Fehlermeldungen.

Wenn Sie die Auflistfunktion verwenden, können Sie eine Auswahlliste der Libraries aufrufen, die das (oder die) angegebene(n) Objekt(e) enthalten. Dies gilt auch für die Suchfunktion, wenn das angegebene Objekt in mehreren Libraries enthalten ist.

- Liste von Libraries für Programmierobjekte aufrufen
- Liste von Libraries für Debug-Umgebungen aufrufen
- Liste von Libraries für Fehlermeldungen aufrufen

#### Liste von Libraries für Programmierobjekte aufrufen

Um eine Liste von Libraries für Programmierobjekte aufzurufen:

- Geben Sie in einem List-Menü im Feld Library einen Bereich von Library-Namen ein (siehe auch Angabe eines Namensbereichs) und im Feld Name einen Objektnamen oder einen Namensbereich.

  Wenn Sie einen Stern (*) in das Feld Library eingeben (nur List-Funktion), wird eine Liste aller in der angegebenen Systemdatei verfügbaren Libraries angezeigt.

  In dem unten gezeigten Beispiel eines Library Selection-Bildschirms werden alle Libraries, deren Namen mit `LIB` beginnen, ausgewählt:

       21:23:03             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
       User SAG                   -   Library Selection  -

      LIST ALL * IN LIB* WHERE DBID 10 FNR 32

        C Library   S/C     C Library   S/C     C Library   S/C     C Library   S/C
        - --------  ---     - --------  ---     - --------  ---     - --------  ---
        _ LIB1      S/C     _ LIB2      S/C     _ LIB3        C     _ LIB4      S/C
        _ LIB5        S     _ LIB6      S/C     _ LIB7      S/C     _ LIB8      S/C
        _ LIB9      S/C     _ LIB10     S/C     _ LIB11     S/C     _ LIB12     S/C
        _ LIB13     S       _ LIB14     S/C     _ LIB15       C     _ LIB16     S/C
        _ LIB17     S/C     _ LIB18     S/C     _ LIB19     S/C     _ LIB20     S/C

                                                      Object Start Value: *

                   Enter options (above), or '?' (Help) or '.' (Exit): _
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  Copy  Del   Find  List  Move  Ren               Canc

  In der Spalte Library werden alle Libraries aufgelistet, die dem angegebenen Bereich entsprechen. Die Spalte S/C zeigt an, ob eine Library gespeicherte (Quellcode-)Objekte und/oder katalogisierte Objekte enthält.

  Eine Liste der Zeilenkommandos, die auf dem Bildschirm Library Selection verfügbar sind, finden Sie unter Auswahllisten für Programmierobjekte.

Wenn Sie die Suchfunktion (Find) verwenden, wird der Bildschirm Library Selection angezeigt, wenn das angegebene Objekt in mehreren Libraries gefunden wird.

Der Bildschirm Library Selection erscheint auch, wenn Sie einen Find Selection- oder List Selection-Bildschirm durch Drücken von PF3 (Quit) verlassen.

#### Liste von Libraries für Debug-Umgebungen aufrufen

Um eine Liste von Libraries für Debug-Umgebungen aufzurufen:

- Im Menü Debug Environments:

  Geben Sie in das Feld Code ein `L` und in das Feld Environment Name den Namen einer Debug-Umgebung oder einen Bereich von Namen und in das Feld Source Library einen Bereich von Library-Namen ein (siehe auch Angabe eines Namensbereichs).

  Wenn Sie in den Feldern Environment Name und Source Library einen Stern (*) eingeben, wird eine Liste aller Libraries angezeigt, die Debug-Umgebungen in der angegebenen Systemdatei enthalten.

  In dem unten gezeigten Beispiel eines Library Selection-Bildschirms wurden alle Libraries, deren Namen mit `L` beginnen, ausgewählt:

      09:55:08             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
       User SAG                   -   Library Selection  -
      LIST DEBUG * IN LIB* FROM DBID 10 FNR 32

        C Library           C Library           C Library           C Library
        - --------          - --------          - --------          - --------
        _ LIB1              _ LIB5              _ LIB9              _ LIB11
        _ LIB20

                                                 Object Start Value ... *
                    Enter options (above), or '?' (Help) or '.' (Exit): _

      Command ===>
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help  Menu  Exit  Copy  Del   Find  List  Move  Ren               Canc

  In der Spalte Library werden alle Libraries aufgelistet, die die angegebene(n) Debug-Umgebung(en) enthalten. Eine Liste der Zeilenkommandos, die auf dem Bildschirm Library Selection verfügbar sind, finden Sie unter Auswahllisten für Debug-Umgebungen.

#### Liste von Libraries für Fehlermeldungen aufrufen

Um eine Liste von Libraries für Fehlermeldungen aufzurufen:

- Wählen Sie eine der folgenden Methoden:

  1. Geben Sie in einem List-Menü in das Feld No. From eine Fehlermeldungsnummer ein (im untenstehenden Beispiel `1`) oder geben Sie einen Nummernbereich an, indem Sie eine Startnummer in das Feld No. From und eine Endnummer in das Feld No. To eingeben.

     Geben Sie im Feld Library einen Bereich von Library-Namen ein (siehe auch Angabe eines Namensbereichs).

     Es erscheint ein Library Help-Fenster ähnlich dem folgenden Beispiel:

          14:02:47             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
          User SAG                 - List Error Message Texts -
                                        +---------------------------+
                                        !  --- Library Help ---     !
                              Code  Fun !       - Source -          !
                                        !                           !
                                A   Lis !   1   system messages     !
                                E   Lis !   2   LIB1                !
                                S   Lis !   3   LIB2                !
                                ?   Hel !   4   LIB3                !
                                .   Exi !   5   LIB4                !
                                        !   6   LIB5                !
                    Code ...... A       !   7   LIB6                !
                                        !   8   LIB7                !
           Error    No. From .. 1___    !                           !
           Source   Library ... LIB*_   !                           ! 0___ FNR .. 32___
                                        !   Enter selection or      !
                                        !    '.' to Exit: 8_        !
                                        +---------------------------+

         Command ===>
         Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
               Help  Menu  Exit  Copy  Del   Find  List  Move  Ren   Fsec        Fnat

     Wählen Sie im Fenster eine Library aus, indem Sie die Nummer eingeben, die der gewünschten Library entspricht, wie im obigen Beispiel gezeigt, in dem `8` eingegeben wurde, um `LIB7` auszuwählen. Wenn Sie die richtige FNAT-Systemdatei angegeben haben, können Sie auch Systemfehlermeldungen auswählen. Drücken Sie bei Bedarf die Eingabetaste, um an das Ende der Liste zu gelangen.

  2. In einem Find-Menü geben Sie in das Feld Number eine Fehlermeldungsnummer und in das Feld Library einen Bereich von Library-Namen ein (siehe auch Angabe eines Namensbereichs).

     Für den angegebenen Library-Bereich (hier: `LIB*`) wird ein Find Selection-Bildschirm ähnlich dem folgenden Beispiel angezeigt:

          19:09:34             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
          User SAG                      - Find Selection -

         FIND ERR 1 TYPE A FROM LIB* LANG * WHERE DBID 10 FNR 32

          C   Library   Error Message Text(s) for Error number: 1                  Type
          -   --------  ---------------------------------------------------------  ----
          _   LIB1      Short message of Error 1: wrong input value.               S
          _   LIB2      Short message of Error 1: incorrect syntax.                S
          _   LIB3      Short message of Error 1: undefined variable.              S
          _   LIB4      Short message of Error 1: timeout error.                   S
          _   LIB5      Short message of Error 1: initialization failed.           S/E
          _   LIB6      Short message of Error 1: invalid format.                  S/E
          _   LIB7      Short message of Error 1: wrong password.                  S/E
          _   LIB8      Short message of Error 1: input missing.                   S/E
          _   LIB9      Short message of Error 1: undefined keyword.               S/E
          _   LIB10     Short message of Error 1: invalid command.                 S

                 Enter options (above), or '?' (Help) or '.' (Exit): __
         Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
               Help  Menu  Exit  Copy  Del         List  Move  Ren               Canc

     In der Spalte Library werden alle Libraries aufgelistet, die die angegebene(n) Fehlermeldung(en) enthalten (hier: `1`). Die Spalte Type zeigt an, ob die kurze (`S`) und/oder die erweiterte (`E`) Fehlermeldung für die angegebene Meldung verfügbar ist.

     Eine Liste der auf dem Bildschirm Find Selection verfügbaren Zeilenkommandos finden Sie unter Auswahllisten für Fehlermeldungen.

## Funktionsverarbeitung und Reporting

Es gibt zwei Arten der Verarbeitung, die bei der Ausführung einer SYSMAIN-Funktion verwendet werden können: selektive Verarbeitung und automatisierte Verarbeitung.

Dieser Abschnitt beschreibt die beiden Arten der Funktionsverarbeitung und wie Sie einen Statusbericht über die Funktionsverarbeitung erhalten:

- Automatisierte Verarbeitung

- Selektive Verarbeitung

- Auswahlliste benutzen

- Online-Report-Modus

### Automatisierte Verarbeitung

Die automatisierte Verarbeitung ist die vorgegebene Art der Verarbeitung, wenn Sie online im Kommandomodus arbeiten. Im Batch-Modus wird automatisierte Verarbeitung standardmäßig verwendet.

Bei der automatisierten Verarbeitung handelt es sich um eine Online- oder Batch-Funktionalität, die Objekte ohne Anzeige einer Auswahlliste verarbeitet. Dies erfordert wenig oder gar keine Eingabe/Ausgabe am Terminal, nachdem eine Funktion ausgewählt wurde.

Bei der automatisierten Online-Verarbeitung wird der Status der einzelnen Objekte nicht angezeigt, sondern es wird nach Abschluss der Verarbeitung eine entsprechende Meldung angezeigt. Wenn eine der folgenden Fehlermeldungen des Natural-Systems angezeigt wird, wurden einige oder alle der angegebenen Objekte nicht verarbeitet:

4867 | Für diesen Anforderung wurde nichts gefunden.
4810 | Alle Daten wurden nach diesen Auswahlkriterien abgelehnt.
4893 | Normaler Abschluss, aber einige Daten wurden abgelehnt.

Der erweiterte (lange) Meldungstext des Fehlers NAT4810 listet Gründe auf, warum ein Objekt möglicherweise nicht verarbeitet wurde. Die Gründe, warum ein Objekt nicht verarbeitet werden konnte, werden auch im Abschnitt Statusmeldungen und Fehlerbenachrichtigungen bearbeiten behandelt.

Der Batch-Modus oder die selektive Verarbeitung sollte verwendet werden, wenn es notwendig ist, den Status jedes Objekts nach seiner Verarbeitung zu sehen.

Bei Bedarf können Sie im Online-Betrieb einen Batch-Report mit dem Verarbeitungsstatus aller Objekte anfordern, wie unter Online Report-Modus beschrieben.

### Selektive Verarbeitung

Die selektive Verarbeitung ist die vorgegebene Art der Verarbeitung, wenn Sie im Menümodus arbeiten.

Die selektive Bearbeitung ist eine Online-Funktionalität, die eine Auswahlliste mit allen Objekten anzeigt, die den angegebenen Auswahlkriterien entsprechen. Eine Auswahlliste bietet die folgenden Optionen:

- Einzelne oder mehrere Objekte für die weitere Verarbeitung auswählen.

- Vor der Bearbeitung eines Objektes eine zusätzliche Funktion (z.B. Anzeige des Quelltextes) ausführen. Siehe Auswahlliste benutzen).

- Einzelne Meldungen über den Bearbeitungsstatus jedes Objekts bekommen (z.B. `Moved` oder `Copied`).

- Anzeige des Direktkommandos, das den im SYSMAIN-Menü eingegebenen Eingabewerten entspricht (siehe das Beispiel eines Auswahlbildschirms unten). Dies kann bei der Benutzung von Direktkommandos anstelle von Menüfunktionen hilfreich sein.

### Auswahlliste benutzen

Dieser Abschnitt enthält Anleitungen zum Aufrufen einer Auswahlliste, um einzelne oder mehrere Objekte weiter zu verarbeiten. Außerdem wird in diesem Abschnitt beschrieben, wie Sie eine Auswahl verkürzen können, wenn Sie die List- oder Find-Funktion verwenden. Diese Option ist bei großen Libraries nützlich, um die Anzahl der angezeigten Objekte zu begrenzen.

Um eine Anweisungsliste online zu benutzen:

1. Im Menümodus: Geben Sie in einem SYSMAIN-Menü im Feld Sel. List ein `Y` ein (dies ist die Standardeinstellung), um die selektive Bearbeitung zu aktivieren. Die Eingabe eines `N` deaktiviert die selektive Bearbeitung.

   Oder:
   Im Kommandomodus: Fügen Sie das Schlüsselwort `HELP` in die With-Klausel (with-clause) des Direktkommandos ein oder geben Sie ein Fragezeichen (`?`) unmittelbar nach dem Objektnamen ein. Siehe auch die Syntax-Diagramme in den objekttypspezifischen Abschnitten der SYSMAIN Dienstprogramm-Dokumentation.

   Wenn die selektive Verarbeitung aktiviert wurde, erscheint ein Selection-Fenster ähnlich dem folgenden Beispiel:

        11:05:22             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
        User SAG                   -    Copy   Selection  -

       COPY ALL * WITH XREF N FROM OLDLIB WHERE DBID 10 FNR 50 TO NEWLIB WHERE DBID
       10 FNR 60

       C  Name     Type   S/C  Message        C  Name     Type   S/C  Message
       -  -------- ------ ---  ------------   -  -------- ------ ---  ------------
       _  AA       Copycd S/C                 _  G0000001 Global S
       _  G0000002 Global S/C                 _  G0000003 Global S/C
       _  L0000001 Local  S/C                 _  L0000002 Local  S/C
       _  L0000003 Local  S                   _  M0000001 Map    S
       _  M0000002 Map    S/C                 _  M0000003 Map    S/C
       _  P0000001 Progrm S                   _  P0000002 Progrm   C
       _  P0000003 Progrm S/C                 _  P0000004 Progrm S/C
       _  P0000005 Progrm S                   _  P0000006 Progrm S/C
       _  P0000007 Progrm S/C                 _  S0000001 Subpgm S/C
       _  S0000002 Subpgm S/C                 _  S0000003 Subpgm S
       _  T0000001 Text   S                   _  T0000002 Text
                                                              Listed Library: OLDLIB

                     Enter options (above), or '?' (Help) or '.' (Exit) _
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Menu  Exit  Copy  Del   Find  List  Move  Ren               Canc

   Die Liste enthält die Namen und die Typen der angegebenen Objekte und zeigt an, ob gespeicherte Objekte (`S`) und/oder katalogisierte Objekte (`C`) vorhanden sind.

   In den Zeilen oberhalb der Auswahlliste (im obigen Beispiel hervorgehoben) wird das SYSMAIN-Direktkommando angezeigt, das den von Ihnen in den Menüfeldern eingegebenen Werten entspricht.

   Dieses Kommando entspricht der Kommandosyntax, die beim Arbeiten im Kommandomodus gilt, wobei einige Schlüsselwörter optional sind, wie in den Syntax-Diagrammen in den objekttypspezifischen Abschnitten der SYSMAIN-Dokumentation gezeigt.

2. Wählen Sie ein oder mehrere Objekte für die weitere Bearbeitung aus:

   Geben Sie in der Spalte C (Kommando) neben dem/den gewünschten Objekt(en) eines der in den objekttypspezifischen Abschnitten dieser Dokumentation beschriebenen Zeilenkommandos ein.

3. Drücken Sie ENTER, um ein oder mehrere Zeilenkommandos auszuführen.

   Die Zeilenkommandos werden in alphabetischer Reihenfolge der angegebenen Objektnamen ausgeführt, wobei Kommandos, die eine SYSMAIN-Pflegefunktion ausführen (z.B. Löschen), immer zuletzt ausgeführt werden.

   Wurde für ein Objekt keine SYSMAIN-Pflegefunktion (z.B. Anzeigen von Quellcode) ausgeführt, können Sie für ein beliebiges Objekt erneut ein Zeilenkommando eingeben. Sobald jedoch eine SYSMAIN-Pflegefunktion für ein oder mehrere Objekte ausgeführt wurde, sind die Felder der Spalte C nicht mehr eingabebereit.

   Wenn ein Zeilenkommando ausgeführt wurde, wird der Status des/der bearbeiteten Objekts/Objekte in der Spalte Message (Meldung) angezeigt, wie im folgenden Beispiel dargestellt:

        11:05:22             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
        User SAG                   -    Copy   Selection  -

       COPY ALL * WITH XREF N FROM OLDLIB WHERE DBID 10 FNR 50 TO NEWLIB WHERE DBID
       10 FNR 60

       C  Name     Type   S/C  Message        C  Name     Type   S/C  Message
       -  -------- ------ ---  ------------   -  -------- ------ ---  ------------
       _  AA       Copycd S/C  Copied         _  G0000001 Global S    Copied
       _  G0000002 Global S/C  Copied         _  G0000003 Global S/C  Copied
       _  L0000001 Local  S/C  Copied         _  L0000002 Local  S/C  Copied
       _  L0000003 Local  S    Replaced       _  M0000001 Map    S    Replaced
       _  M0000002 Map    S/C  Replaced       _  M0000003 Map    S/C  Replaced
       _  P0000001 Progrm S                   _  P0000002 Progrm   C
       _  P0000003 Progrm S/C                 _  P0000004 Progrm S/C
       _  P0000005 Progrm S                   _  P0000006 Progrm S/C
       _  P0000007 Progrm S/C                 _  S0000001 Subpgm S/C
       _  S0000002 Subpgm S/C                 _  S0000003 Subpgm S
       _  T0000001 Text   S                   _  T0000002 Text
                                                              Listed Library: OLDLIB

                     Enter options (above), or '?' (Help) or '.' (Exit) _
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Menu  Exit  Copy  Del   Find  List  Move  Ren               Canc

   Mögliche Meldungen siehe Status-Meldungen im Abschnitt Statusmeldungen und Fehlerbenachrichtigungen bearbeiten.

Um eine Auswahlliste zu verkürzen:

- Geben Sie in einem List Selection- oder Find Selection-Bildschirm im Feld Reposition to den Namen eines Objekts ein oder geben Sie einen Namensbereich an (siehe Angabe eines Namensbereichs) und drücken Sie ENTER.

  Wenn Sie einen Namen angegeben haben, beginnt die Liste nun mit dem angegebenen Namen. Wenn Sie einen Namensbereich angegeben haben, werden in der Liste nur noch Objekte innerhalb dieses Bereichs angezeigt.

  Die Option Reposition to ist nur im Online-Modus gültig. Sie ist kein Auswahlkriterium für die List-Funktion.

### Online-Report-Modus

Der Online-Report-Modus kann verwendet werden, um statt einer Auswahlliste einen SYSMAIN-Batch-Report online abzurufen. Ein Online-Report listet alle Objekte auf, die von einer SYSMAIN-Funktion betroffen waren, und gibt an, welche Aktion an jedem dieser Objekte durchgeführt wurde.

Um einen Batch-Report online zu benutzen:

1. Geben Sie in einem SYSMAIN-Menü in das Feld Sel. List (Auswahlliste) ein `N` ein, um die automatisierte Verarbeitung zu aktivieren.

2. Geben Sie in der Kommandozeile eines der folgenden Direktkommandos ein:

       BATCH

   oder

       BAT

   Es erscheint eine Meldung, die bestätigt, dass der Batch-Modus aktiviert wurde.

3. Bei Bedarf können Sie eine Hardcopy des Berichts anfordern, indem Sie das folgende Terminalkommando eingeben:

       %H

   (Siehe auch %H — Hardcopy-Ausgabe in der Terminalkommandos-Dokumentation.)

4. Führen Sie eine SYSMAIN-Funktion aus. SYSMAIN verarbeitet nun die Funktion wie im Batch-Modus. Daher wird nur das Ergebnis jeder Aktion in einem reportartigen Format ausgegeben, wie im folgenden Beispiel gezeigt:

       10:50:30              ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
       User SAG                   - Copy   Function -

       COPY ALL * WITH XREF N FROM TESTLIB1 WHERE DBID 10 FNR 30 TO TESTLIB2 WHERE
       DBID 10 FNR 40

       Saved     Progrm TEST1    has now been Copied
       Saved     Progrm TEST2    has now been Copied
       Saved     Progrm TEST3    has now been Copied
       Stowed    Progrm TEST4    has now been Copied
       Stowed    Progrm TEST5    has now been Copied
       Stowed    Progrm TEST6    has now been Copied
       Stowed    Progrm TEST7    has now been Copied
       Saved     Record TEST8    has now been Copied
       Saved     Text   TEST9    has now been Copied
       Cataloged Progrm TEST10   has now been Copied
       Saved     Progrm TEST11   has now been Copied
       Stowed    Progrm TEST12   has now been Copied
       MORE
       Stowed    Progrm TEST13   has now been Copied
       Cataloged Progrm TEST14   has now been Copied
       Stowed    Progrm TEST15   has now been Copied

5. Bei Bedarf können Sie die Bearbeitung der Funktion unterbrechen, indem Sie an einer `MORE`-Eingabeaufforderung ein System- oder Terminalkommando eingeben. Andernfalls drücken Sie ENTER, bis Sie das Ende der Liste erreicht haben und kehren zum SYSMAIN-Menü zurück, wo eine Meldung die erfolgreiche Ausführung der Funktion bestätigt.

## SYSMAIN-Online-Hilfe

Die SYSMAIN-Online-Hilfe bietet Informationen zu allen Funktionen von SYSMAIN, einschließlich detaillierter Erklärungen der Syntax der Direktkommandos und Beispiele für Direktkommandos.

Zusätzlich zur Hilfe bietet SYSMAIN individuelle Informationen zu jedem Eingabefeld, das in jedem SYSMAIN-Bildschirm verfügbar ist.

Um die SYSMAIN-Hilfethemen aufzurufen:

1. Positionieren Sie im Hauptmenü des SYSMAIN-Dienstprogramms (SYSMAIN Utility Main Menu) den Cursor im Feld Object Code oder Function Code und drücken Sie PF1 (Hilfe) oder geben Sie ein Fragezeichen (`?`) ein.

   Das Hilfemenü (Help Menu) des Dienstprogramms SYSMAIN wird ähnlich wie im folgenden Beispiel angezeigt. Es enthält eine Liste von Hilfethemen:

        15:54:28             ***** NATURAL SYSMAIN UTILITY *****            2005-08-10
        User SAG                       - Help Menu -
                                                                    Help Name SHT-0001

                         Code  Topic

                           A   SYSMAIN General Overview
                           C   Command Mode
                           E   Environment Definition
                           F   Functions / Commands
                           S   Security Environment
                           .   Exit

                  Code ... _

       Select a function code.

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                   Menu  Exit                                                  Canc

2. Geben Sie in das Feld Code den aus einem Buchstaben bestehenden Code ein, der dem gewünschten Hilfethema entspricht.

3. Drücken Sie ENTER.

   Es erscheint ein Ergebnisbildschirm mit Informationen zu dem gewählten Hilfethema, oder es wird ein weiteres Menü mit weiteren Hilfethemen aufgerufen, die Ihre Suche eingrenzen.

Um die Hilfe zu einem Eingabefeld aufzurufen:

- Positionieren Sie den Cursor in das betreffende Feld und drücken Sie PF1 (Hilfe) oder geben Sie ein Fragezeichen (`?`) ein und drücken Sie ENTER.

  Es erscheint ein Fenster mit feldspezifischen Anleitungen und ggf. einer Liste der gültigen Eingabewerte.

### On this page

- Menüfunktionen ausführen
- Kommandos ausführen
- Beschreibung der Funktionen
- Funktionsverarbeitung und Reporting
- SYSMAIN-Online-Hilfe