SYSMAIN aufrufen und beenden

#### Search Results

Search

# SYSMAIN aufrufen und beenden

Dieser Abschnitt beschreibt, wie Sie das Dienstprogramm SYSMAIN online, im Batch oder über eine Anwendungsprogrammierschnittstelle aufrufen und beenden.

Dieses Kapitel behandelt die folgenden Themen:

- SYSMAIN online oder im Batch aufrufen

- SYSMAIN mittels Anwendungsprogrammierschnittstelle aufrufen

- SYSMAIN beenden

## SYSMAIN online oder im Batch aufrufen

Die folgenden Anweisungen beschreiben die Methoden zum Aufrufen des SYSMAIN-Dienstprogramms über ein Direktkommando (Online oder Batch) oder über Menüfunktionen.

Um SYSMAIN online aufzurufen:

- Geben Sie in einer beliebigen Library das folgende Natural-Systemkommando ein:

      SYSMAIN

  Oder:
  Rufen Sie aus dem Natural-Hauptmenü (Natural Main Menu) das Menü Maintenance and Transfer Utilities auf und wählen Sie Transfer Objects to Other Libraries.

  Es erscheint ein SYSMAIN-Hauptmenü (Main Menu) ähnlich dem folgenden Beispiel:

       16:33:22             ***** NATURAL SYSMAIN UTILITY *****            2022-09-16
       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 .. _

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

  Die aktuelle Einstellung der Systemvariablen `*LIBRARY-ID` wird an SYSMAIN übergeben und als Standard Source Library für die Verarbeitung von Programmierobjekten und Debug-Umgebungen verwendet.

Um SYSMAIN im Batch aufzurufen:

- Benutzen Sie das folgende Direktkommando:

      SYSMAIN

  gefolgt von einer oder mehreren Kommandozeichenfolgen. Siehe auch Direktkommandos absetzen.

## SYSMAIN mittels Anwendungsprogrammierschnittstelle aufrufen

MAINUSER ist eine Anwendungsprogrammierschnittstelle (API), mit der SYSMAIN-Funktionen direkt aus einem beliebigen vom Benutzer geschriebenen Objekt (z.B. aus einer Subroutine, einem Programm oder Subprogramm) ausgeführt werden können, ohne die normalen Schritte des Aufrufs von SYSMAIN zu durchlaufen.

Nach Abschluss der Verarbeitung der SYSMAIN-Funktionen wird das Dienstprogramm beendet und die Kontrolle an das Programm, Subprogramm oder die Subroutine zurückgegeben, von dem/der aus die Anforderung gestellt wurde.

MAINUSER wird als katalogisiertes Objekt vom Typ Subprogramm in der System Library SYSMAIN bereitgestellt. MAINUSER kann sowohl im Online- als auch im Batch-Modus verwendet werden.

Anmerkung
MAINUSER darf sich nicht in einer User Library befinden. Kopieren Sie ihn daher in die Library SYSTEM in der Systemdatei FNAT oder FUSER oder in eine beliebige Library mit Präfix SYS, die als Steplib für die Anwendung dient.

### MAINUSER aufrufen

MAINUSER wird mit dem Statement CALLNAT und den entsprechenden Parametern aufgerufen (siehe Statements-Dokumentation). MAINUSER darf nicht aus der Library SYSMAIN heraus aufgerufen werden.

Um MAINUSER aufzurufen:

- Setzen Sie ein `CALLNAT`-Statement ab, das die folgenden Syntaxelemente enthält:

  `CALLNAT 'MAINUSER' command error message library`

  wobei die variablen Werte die folgenden Parameter bezeichnen:

  Parameter | Natural-Datenformat/Länge | Erläuterung
  --- | --- | ---
  command | A250 | Die Direktkommandozeichenfolge, die von SYSMAIN ausgeführt werden soll.
  error | N4 | Der Rückgabecode, der von SYSMAIN am Ende der Verarbeitung ausgegeben wird, um eine normale Beendigung der Verarbeitung oder einen Fehler anzuzeigen.
  message | A72 | Die Meldung, die dem online angezeigten Fehler entspricht.
  library | A8 | Die Library, die SYSMAIN enthält. Wenn nicht angegeben, ist die Vorgabe SYSMAIN.

  Ein Beispiel für eine aufrufbare Routine ist das Programm `MAINCALL` in der Library SYSMAIN.

## SYSMAIN beenden

Um SYSMAIN zu beenden:

- Geben Sie in der Kommandozeile eines beliebigen SYSMAIN-Bildschirms eines der folgenden Direktkommandos ein:

      .

  (ein Punkt)

  oder

      END

  oder

      QUIT

  Oder:
  PF3 (Exit) drücken, ggf. wiederholt.

  Oder:
  Verwenden Sie im Batch-Modus eines der folgenden Direktkommandos:

      END

  oder

      QUIT

  Siehe auch Direktkommandos absetzen im Abschnitt Menüfunktionen und Kommandos benutzen.

Wichtig
Beenden Sie das Dienstprogramm SYSMAIN nicht mit dem Terminalkommando `%%`, da die Umgebung möglicherweise nicht korrekt zurückgesetzt wird.

### On this page

- SYSMAIN online oder im Batch aufrufen
- SYSMAIN mittels Anwendungsprogrammierschnittstelle aufrufen
- SYSMAIN beenden