Natural bietet Ihnen online verschiedene Hilfe-Informationen an:
Allgemeine Informationen zu Natural-Sprachelementen (z.B. Statements,
Systemvariablen) und Komponenten der Entwicklungsumgebung (z.B. Editoren und
Utilities). Diese allgemeinen Informationen befinden sich in der
Natural-Help-Utility, die Sie mit dem Systemkommando
HELP
aufrufen können.
Ausführliche Informationen zu Natural-Systemfehlermeldungen und
benutzerdefinierten Meldungen. Diese Informationen werden nach Absetzen der
Systemkommandos HELP
und
LASTMSG
angezeigt.
Spezifische Informationen zu Natural-Menüs und zu Eingabefeldern, die in den Natural-Editoren und Utilities angezeigt werden. Diese Informationen werden durch umgebungsspezifische Hilfe-Funktionen angezeigt.
Dieser Abschnitt behandelt folgende Themen:
Die Natural-Help-Utility bietet allgemeine Informationen zu Natural-Sprachelementen (z.B. Statements, Systemvariablen) und Komponenten der Entwicklungsumgebung (z.B. Systemkommandos, Editoren und Utilities) sowie zu Natural-Systemfehlermeldungen. Um die Hilfe zu einem bestimmten Thema aufzurufen, können Sie wahlweise durch die Natural-Help-Utility und ihre Menüs navigieren oder ein bestimmtes Hilfethema direkt aufrufen.
Dieser Abschnitt behandelt folgende Themen:
Um das Menü der Help-Utility aufzurufen
Geben Sie folgendes Systemkommando ein:
HELP
oder
?
Drücken Sie EINGABE.
Es erscheint das Menü der Natural-Help-Utility mit einer Liste der zur Verfügung stehenden Hilfethemen, zum Beispiel:
10:58:19 ***** NATURAL HELP UTILITY ***** 2009-05-20 - Menu - ------------------------------------------------------------------------------ Natural Help provides information on: S Natural Statements V Natural System Variables F Natural System Functions C Natural System Commands E Natural Editors U Natural Utilities P Natural Session Parameters T Natural Terminal Commands N Natural System Messages M User-Defined Messages . Exit Code .. _ ------------------------------------------------------------------------------ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Canc |
Geben Sie im Feld Code den einbuchstabigen Code ein, der dem gewünschten Hilfethema entspricht.
Drücken Sie EINGABE.
Es erscheint entweder ein Bildschirm mit Informationen zu dem gewünschten Thema oder ein Untermenü mit weiteren Hilfethemen, das Ihnen hilft, Ihre Suche einzugrenzen.
Anstatt durch die Menüs der Help-Utility zu navigieren, um ein bestimmtes Hilfethema anzuzeigen, können Sie auch direkt auf die Hilfe zu einem Natural-Systemkommando oder zu Elementen der Programmiersprache Natural zugreifen.
Um ein Hilfethema direkt aufzurufen
Benutzen Sie folgende Systemkommando-Syntax:
HELP command
wobei command das Kommando ist, zu dem
Sie Hilfe benötigen, z.B. das Systemkommando EDIT
:
HELP EDIT
Drücken Sie EINGABE.
Es erscheint der Bildschirm zum gewünschten Thema, in diesem
Beispiel mit Informationen zum Systemkommando
EDIT
:
15:20:54 ***** NATURAL HELP UTILITY ***** 2009-05-20 - EDIT - Page 1 ------------------------------------------------------------------------------ Function: Invoke a Natural editor for the purpose of editing a Natural object. Parameters: Object-type: Copycode(C), Description(D), Global(G), Helproutine(H), Local(L), Map(M), Parameter(A), Program(P), Subprogram(N), Subroutine(S), Text(T) or Class(4). -> Must be specified if object-name is not specified. Object-name: The name of the object to be edited, which will then be loaded in the edit work area. Library-ID : May only be specified if the object is contained in a library other than the one to which you are currently logged on. -> Must not start with 'SYS' except 'SYSTEM' -> Must not be specified if Natural Security is installed. ------------------------------------------------------------------------------ More ... Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit - + Canc |
Falls die Informationen mehr als eine Bildschirmseite umfassen,
erscheint links oben der Hinweis Page 1
und unten links der
Hinweis More ...
Drücken Sie EINGABE oder drücken Sie PF8, um zu den Folgeseiten weiterzublättern.
Wenn Sie die letzte Seite des Hilfetextes erreicht haben, erscheint
unten rechts der Hinweis Last page
.
Drücken Sie PF7, wenn Sie rückwärts blättern und zur
ersten Seite (Page 1
) zurückkehren möchten.
In Natural gibt es Systemmeldungen und benutzerdefinierte Meldungen.
Natural-Systemmeldungen erkennen Sie daran, dass sie mit
NAT
beginnen und eine vierstellige Zahl
nnnn aufweisen.
Zu jeder Natural-Systemmeldung gibt es einen Kurz- und einen Langtext:
Der Kurztext ist die einzeilige Meldung, die beim Auftreten eines Fehlers zusammen mit der Fehlernummer ausgegeben wird.
Der Langtext enthält eine Erläuterung und beschreibt Abhilfemaßnahmen,
die Sie zur Behebung des Fehlers ergreifen können. Er wird angezeigt, wenn Sie
das Systemkommando HELP
absetzen (siehe Langtext
einer Meldung anzeigen weiter unten).
Dieser Abschnitt behandelt folgende Themen:
Sie können sich den Langtext einer Natural-Systemmeldung oder benutzerdefinierten Meldung anzeigen lassen wie im folgenden Abschnitt beschrieben. Siehe auch die Anleitung zur Anzeige der zuletzt aufgetretenen Systemmeldung.
Um den Langtext zu einer Natural-Systemmeldung anzuzeigen
Benutzen Sie folgende Systemkommando-Syntax:
HELP NATnnnn
oder
? nnnn
Wobei Sie anstelle von nnnn die Nummer des Fehlers angeben.
Drücken Sie EINGABE.
Es erscheint der Bildschirm Natural System Message der Natural-Help-Utility mit dem Langtext zur angegebenen Fehlernummer (siehe Beispielschirm zur Natural-Systemmeldung NAT0082 weiter unten).
Um den Langtext zu einer benutzerdefinierten Meldung anzuzeigen
Melden Sie sich in der Library an, in der die gewünschte benutzerdefinierte Meldung gespeichert ist.
Benutzen Sie folgende Systemkommando-Syntax:
HELP USER nnnn
oder
? Unnnn
Wobei Sie anstelle von nnnn die vierstellige Nummer des Fehlers angeben.
Drücken Sie EINGABE.
Es erscheint der Bildschirm User Message der Natural-Help-Utility mit dem Langtext zur angegebenen benutzerdefinierten Fehlernummer (siehe Beispielschirm weiter unten).
Sie können sich den Kurz- und Langtext der in der aktuellen Session
zuletzt aufgetretenen Natural-Systemmeldung anzeigen lassen, indem Sie entweder
das Systemkommando HELP ERROR
absetzen oder indem
Sie den Cursor in die Meldungszeile stellen und wie weiter unten beschrieben
vorgehen.
Sie können sich den Kurztext der zuletzt aufgetretenen
Fehlermeldung(en) sowie zusätzliche Informationen zur Fehlersituation anzeigen
lassen, indem Sie das Systemkommando LASTMSG
benutzen. Die angezeigten Informationen enthalten zugehörige, eventuell vor der
letzten Meldung aufgetretene Fehlermeldungen.
Um den Langtext zur zuletzt aufgetretenen Systemmeldung anzuzeigen
Benutzen Sie eine der folgenden Methoden
Geben Sie folgendes Systemkommando ein:
HELP ERROR
Drücken Sie EINGABE.
Es erscheint der Bildschirm Natural System Message der Natural-Help-Utility. Er enthält den Langtext zu der Systemmeldung, zum Beispiel:
15:18:27 ***** NATURAL HELP UTILITY ***** 2009-05-20 Library SAG - Natural System Message NAT0082 - Page 1 Invalid command, or Program ANTON does not exist in library. Tx *** Short Text *** Invalid command, or ... ... does not exist in library. Ex *** Explanation *** One of the following has occurred: - You entered a value in the command line which is neither a Natural command nor the name of a Natural program contained in the active library or in a library defined as a steplib. - An object which is required during execution of a program, subprogram, subroutine or helproutine is not contained in More ... Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Print + Canc |
Oder:
Wenn der Kurztext der Meldung in einem Menüschirm angezeigt wird, stellen Sie den Cursor in die Meldungszeile und drücken Sie PF1 (Help).
Es erscheint das Fenster Current Natural Message, zum Beispiel:
11:22:48 ***** NATURAL ***** 2009-05-20 User SAG - Main Menu - Library TEST Function _ Development Functions _ Development Environment Settings _ Maintenance and Transfer Utilities _ Debugging and Monitoring Utilities _ Example Libraries +-------------------- Current Natural Message NAT0082 --------------------+ | Sh Invalid command, or Program ANTON does not exist in library. | | | | Tx Invalid command, or ... ... does not exist in library. | | Ex One of the following has occurred: | | - You entered a value in the command line which is neither a | | Natural command nor the name of a Natural program contained | | in the active library or in a library defined as a steplib. | | - An object which is required during execution of a program, | | subprogram, subroutine or helproutine is not contained in | | the active library or in a library defined as a steplib. | | - Your Natural session is currently applying system files other | | than those containing the object you specified. | | Ac Check to ensure that you entered a valid Natural command or the name | | of an existing Natural object. Use the command SYSPROF to check | | whether you are using the correct system file. | +-------------------------------------------------------------------------+ NAT0082 Invalid command, or Program ANTON does not exist in library. Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Exit Canc |
Anmerkung:
Mit der User Exit Routine
USR2002P (siehe
Operations-Dokumentation) können Sie das Fenster
Current Natural Message kundenspezifisch anpassen.
Um die zuletzt aufgetretene(n) Systemmeldung(en) und weitere Einzelheiten anzuzeigen
Geben Sie folgendes Systemkommando ein:
LASTMSG
Drücken Sie EINGABE.
Es erscheint das Fenster LASTMSG mit dem Kurztext zu der bzw. den zuletzt aufgetretenen Systemmeldungen.
Um weitere Informationen zu der bzw. den Meldungen zu erhalten:
Im Fenster LASTMSG: stellen Sie den Cursor in die gewünschte Meldungszeile und drücken Sie EINGABE.
Es erscheint das Fenster Detailed Information, zum Beispiel:
+---------------------------------- LASTMSG -------------------------More: ++ ! ERRTST1 0080 NAT0917 Error 920 in COPYCODE ERRTST2. ! ! ERRTST2 0090 NAT0917 Error 920 in COPYCODE ERRTST3. ! ! ERRTST3 0070 NAT0920 Program HUGO cannot be loaded (00000004). ! ! +--- Detailed Information for NAT0920 ---+ ! ! ! Error Number .. 920 ! ! ! ! Error Line .... 70 ! ! ! ! Object ........ ERRTST3 ! ! ! ! Object Type ... Copycode ! ! ! ! Level ......... 5 ! ! ! ! Library ....... SYSEXV ! ! ! ! DBID/FNR ...... 10 / 410 ! ! ! ! Error Class ... System ! ! ! ! Error Type .... Runtime ! ! ! ! Error Time .... 2003-02-27 15:58:01 ! ! ! +----------------------------------------+ ! ! ! ! Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF1 ! ! Exit -- ++ << > Can ! +-----------------------------------------------------------------------------+ Command ===> LASTMSG Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Canc |
Weitere Informationen finden Sie unter LASTMSG in der Systemkommandos-Dokumentation.
Zusätzlich zu den in der Natural-Help-Utility angebotenen Hilfethemen bietet Ihnen Natural spezifische Informationen zu allen Natural-Menüs und den dort vorhandenen Eingabefeldern.
Um Hilfe zum aktuellen Menü aufzurufen
Geben Sie in der Kommandozeile oder im Feld Code ein Fragezeichen (?) ein und drücken Sie EINGABE.
Oder:
Drücken Sie PF1 (Help).
Um Hilfe zu einem Feld aufzurufen
Stellen Sie den Cursor in das betreffende Feld und geben Sie ein Fragezeichen (?) ein.
Drücken Sie EINGABE.