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:
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.
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 und DL/I-Sub-Dateien. Ausführen der Funktion 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 , , oder (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. |
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 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:
Benutzen Sie das Kommando SYSMAIN
und geben Sie eine Kommandozeichenfolge auf eine der beiden folgenden Arten
an:
Die Kommandozeichenfolge folgt dem
SYSMAIN-Kommando in derselben Eingabezeile; jedes
Schlüsselwort in der Kommandozeichenfolge kann durch ein Leerzeichen anstelle
des Begrenzungszeichens abgegrenzt werden.
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.
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.
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.
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: .
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 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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. |
|||||||||||||||
| 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: |
|||||||||||||||
| 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. |
|||||||||||||||
| 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 |
|||||||||||||||
| 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. |
|||||||||||||||
|
|||||||||||||||
| 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. |
|||||||||||||||
| 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:
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:
Geben Sie in einem SYSMAIN-Menü im Feld
Replace ein Y ein.
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.
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.
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.
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.
Um eine Liste von Libraries für Debug-Umgebungen
aufzurufen:
Im Menü :
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.
Um eine Liste von Libraries für Fehlermeldungen
aufzurufen:
Wählen Sie eine der folgenden Methoden:
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.
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.
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:
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.
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.
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:
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.
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.
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.
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:
Geben Sie in einem SYSMAIN-Menü in das Feld Sel.
List (Auswahlliste) ein N ein, um die automatisierte
Verarbeitung zu aktivieren.
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.
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.)
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 |
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.
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:
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
|
Geben Sie in das Feld Code den aus einem Buchstaben bestehenden Code ein, der dem gewünschten Hilfethema entspricht.
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.