Dieser Abschnitt beschreibt, wie Sie das Dienstprogramm SYSMAIN online, im Batch oder über eine Anwendungsprogrammierschnittstelle aufrufen und beenden.
Dieses Kapitel behandelt die folgenden Themen:
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 .
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.
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 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.
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.