Natural bietet Ihnen online verschiedene Hilfe-Informationen an:

• Allgemeine Informationen zu Natural-Sprachelementen und Natural-Komponenten
  Allgemeine Informationen zu Natural-Sprachelementen (z.B. Statements, Systemvariablen) und Komponenten der Entwicklungsumgebung, z.B. Editoren und Dienstprogramme (Utilities). Diese allgemeinen Informationen befinden sich in der Natural-Help-Utility, die Sie mit dem Systemkommando HELP aufrufen können. Diese Hilfetexte existieren nur in Englisch. Umfassende Informationen zum jeweiligen Hilfethema in deutscher Sprache können Sie aber den entsprechenden Dokumenten im vorliegenden Dokumentationspaket entnehmen:

  • Statements

  • Systemvariablen

  • Systemfunktionen

  • Systemkommandos

  • Editoren

  • Dienstprogramme (deutsch), Utilities (englisch)

  • Session-Parameter

  • Terminalkommandos

  Die Dokumentation zu Natural System Messages gibt es zurzeit nur in Englisch.

• Informationen zu Natural-Fehlermeldungen
  Ausführliche Informationen zu Natural-Systemfehlermeldungen (Natural System Messages) und benutzerdefinierten Meldungen (User-Defined Messages). Diese Informationen werden nach Absetzen der Systemkommandos HELP und LASTMSG als Kurztext (in Deutsch) angezeigt.

  Diese Hilfetexte existieren nur in Englisch.

• Spezifische Informationen zu Natural-Menüs und Eingabefeldern
  Spezifische Informationen zu Natural-Menüs und zu Eingabefeldern, die in den Natural-Editoren und Dienstprogrammen (Utilities) angezeigt werden. Diese Informationen werden durch umgebungsspezifische Hilfe-Funktionen angezeigt.

  Diese Hilfetexte existieren nur in Englisch.

Verwandte Themen:

• HELP - Systemkommandos-Dokumentation

• LASTMSG - Systemkommandos-Dokumentation

Dieser Abschnitt behandelt folgende Themen:

• Allgemeine Informationen – Natural-Help-Utility

• Hilfe zu Natural-Meldungen

• Hilfe zu Menüs und Feldern

---

Allgemeine Informationen – Natural-Help-Utility

Die Natural-Help-Utility bietet allgemeine Informationen in englischer Sprache zu Natural-Sprachelementen (z.B. Statements, Systemvariablen) und Komponenten der Entwicklungsumgebung, z.B. Systemkommandos, Editoren und Dienstprogrammen (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:

• Natural-Help-Utility über Menü benutzen

• Hilfethemen direkt aufrufen

Natural-Help-Utility über Menü benutzen

Um das Menü der Help-Utility aufzurufen

1. Geben Sie folgendes Systemkommando ein:

   HELP

   oder

   ?

2. Drücken Sie EINGABE.

   Es erscheint das Menü der Natural-Help-Utility mit einer Liste der zur Verfügung stehenden Hilfethemen, zum Beispiel:

   11:04:24 ***** NATURAL HELP UTILITY ***** 2022-11-23 - 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

3. Geben Sie im Feld Code den einbuchstabigen Code ein, der dem gewünschten Hilfethema entspricht.

4. 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.

Hilfethemen direkt aufrufen

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

1. Benutzen Sie folgende Systemkommando-Syntax:

   HELP command

   wobei command das Kommando ist, zu dem Sie Hilfe benötigen, zum Beispiel:

   HELP CATALL

2. Drücken Sie EINGABE.

   Es erscheint der Bildschirm zum gewünschten Thema, in diesem Beispiel mit Informationen zum Systemkommando CATALL:

   12:00:46 ***** NATURAL HELP UTILITY ***** 2022-11-23 - CATALL - Page 1 of 2 ------------------------------------------------------------------------------ Function: Store all objects in the current library in source and/or object form. Syntax: CATALL object-name TO object-name RECAT TYPES types SAVE options... XSET set-no SETU set-user ALL CATALOG XREFSET set-no STOW CHECK text-name Note: Enter CATALL command without any parameters, the CATALL screen will be displayed, on which every specification can be made. XSET and SETU mean Predict set and Set user. ------------------------------------------------------------------------------ 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 rechts oben der Hinweis Page 1 of n, wobei n die Zahl der letzten Seite ist.

3. Drücken Sie EINGABE oder drücken Sie PF8, um zu den Folgeseiten weiterzublättern.

   Oder:
   Drücken Sie PF7, wenn Sie rückwärts blättern möchten.

   Oder:
   Drücken Sie PF6, wenn Sie zur ersten Seite zurückkehren möchten.

Hilfe zu Natural-Meldungen

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 (deutsch) ist die einzeilige Meldung, die beim Auftreten eines Fehlers zusammen mit der Fehlernummer ausgegeben wird.

• Der Langtext (englisch) 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:

• Langtext einer Systemmeldung oder benutzerdefinierten Meldung anzeigen

• Informationen zum zuletzt aufgetretenen Fehler anzeigen

Langtext einer Systemmeldung oder benutzerdefinierten Meldung anzeigen

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.

• Langtext zu einer Natural-Systemmeldung
• Langtext zu einer benutzerdefinierten Meldung

Langtext zu einer Natural-Systemmeldung

Um den Langtext zu einer Natural-Systemmeldung anzuzeigen

1. Benutzen Sie folgende Systemkommando-Syntax:

   HELP NATnnnn

   oder

   ? nnnn

   Wobei Sie anstelle von nnnn die Nummer des Fehlers angeben.

2. 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).

Langtext zu einer benutzerdefinierten Meldung

Um den Langtext zu einer benutzerdefinierten Meldung anzuzeigen

1. Melden Sie sich in der Library an, in der die gewünschte benutzerdefinierte Meldung gespeichert ist.

2. Benutzen Sie folgende Systemkommando-Syntax:

   HELP USER nnnn

   oder

   ? Unnnn

   Wobei Sie anstelle von nnnn die vierstellige Nummer des Fehlers angeben.

3. 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).

Informationen zum zuletzt aufgetretenen Fehler anzeigen

Sie können sich den Kurz- und Langtext der in der aktuellen Sitzung 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.

• Langtext zur zuletzt aufgetretenen Systemmeldung
• Zuletzt aufgetretene Systemmeldung(en) und weitere Einzelheiten

Langtext zur zuletzt aufgetretenen Systemmeldung

Um den Langtext zur zuletzt aufgetretenen Systemmeldung anzuzeigen

• Benutzen Sie eine der folgenden Methoden:

  1. 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:

     12:25:40 ***** NATURAL HELP UTILITY ***** 2022-11-23 Library TEST - Natural System Message NAT0082 - Page 1 of 2 Ungueltiges Kommando; oder Programm PRGTEST nicht in der 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 processing of a Natural executable is not contained in the active library or in Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Print + Canc

     Drücken Sie PF8 (+), um die Fortsetzung des Hilfetextes anzuzeigen:.

     12:26:37 ***** NATURAL HELP UTILITY ***** 2022-11-23 Library TEST - Natural System Message NAT0082 - Page 2 of 2 Ungueltiges Kommando; oder Programm PRGTEST nicht in der Library. a library defined as a steplib. - Your Natural session is currently applying system files other than those containing the object you specified. Ac *** Recommended Action *** Enter 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. Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Print -- - Canc

  2. Oder:

     Wenn der Kurztext der Meldung in einem Menü-Bildschirm angezeigt wird, stellen Sie den Cursor in die Meldungszeile und drücken Sie PF1 (Help).

     Es erscheint das Fenster Current Natural Message, zum Beispiel:

     12:29:22 ***** NATURAL ***** 2022-11-23 Benutzer SAG - Hauptmenue - Library TEST +------------------- Current Natural Message NAT0082 -------------------+ ! Sh Ungueltiges Kommando; oder Programm PRGTEST nicht in der 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 processing of a Natural ! ! executable 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 Enter 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 Ungueltiges Kommando; oder Programm PRGTEST nicht in der Library. Kommando ===> PRGTEST Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---

     Anmerkung:
     Mit der User Exit Routine USR2002P (siehe Operations-Dokumentation) können Sie das Fenster Current Natural Message kundenspezifisch anpassen.

Zuletzt aufgetretene Systemmeldung(en) und weitere Einzelheiten

Um die zuletzt aufgetretene(n) Systemmeldung(en) und weitere Einzelheiten anzuzeigen

1. Geben Sie folgendes Systemkommando ein:

   LASTMSG

2. Drücken Sie EINGABE.

   Es erscheint das Fenster LASTMSG mit dem Kurztext zu der bzw. den zuletzt aufgetretenen Systemmeldungen, zum Beispiel:

   +---------------------------------- LASTMSG -------------------------Mehr: ++ ! MAINDF 2750 NAT4800 Geben Sie bitte einen gueltigen Funktionscode ein. ! ! NAT0082 Ungueltiges Kommando; oder Programm MAX nicht in der Library. ! ! NAT0082 Ungueltiges Kommando; oder Programm PRGTEST nicht in der Library. ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF1 ! ! Exit -- ++ << > Can ! +-----------------------------------------------------------------------------+ NAT0082 Ungueltiges Kommando; oder Programm PRGTEST nicht in der Library. Kommando ===> LASTMSG Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Canc

3. 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 for ..., zum Beispiel:

   +---------------------------------- LASTMSG -------------------------Mehr: ++ ! MAINDF 2750 NAT4800 Geben Sie bitte einen gueltigen Funktionscode ein. ! ! NAT0082 Ung +--- Detailed Information for NAT4800 ---+ n der Library. ! ! NAT0082 Ung ! Error Number .. 4800 ! ht in der Library. ! ! ! Error Line .... 2750 ! ! ! ! Object ........ MAINDF ! ! ! ! Object Type ... Program ! ! ! ! Level ......... 1 ! ! ! ! Library ....... SYSLIB ! ! ! ! DBID/FNR ...... 10 / 1760 ! ! ! ! Error Class ... System ! ! ! ! Error Type .... Runtime ! ! ! ! Error Time .... 2022-11-23 12:03:39 ! ! ! +----------------------------------------+ ! ! ! ! ! ! ! ! Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF1 ! ! Exit -- ++ << > Can ! +-----------------------------------------------------------------------------+

   Weitere Informationen finden Sie unter LASTMSG in der Systemkommandos-Dokumentation.

Hilfe zu Menüs und Feldern

Zusätzlich zu den in der Natural-Help-Utility angebotenen Hilfethemen (englisch) bietet Ihnen Natural spezifische Informationen (deutsch) zu allen Natural-Menüs und den dort vorhandenen Eingabefeldern.

• Hilfe zum Hauptmenü

• Hilfe zum aktuellen Menü oder Untermenü

• Hilfe zu einem Feld

Hilfe zum Hauptmenü

Um Hilfe zum Hauptmenü aufzurufen

• Geben Sie im Feld vor dem Menüeintrag Hilfe ein beliebiges Zeichen ein und drücken Sie EINGABE.

  Oder:
  Drücken Sie PF1 (Help).

  Der Bildschirm Hilfe für Hauptmenü mit einer deutschen Beschreibung der Menüfunktionen erscheint.

  Wenn Sie das Feld Markieren für weitere Hilfe .. _ markieren, wird das Menü der Natural Help Utility angezeigt.

Hilfe zum aktuellen Menü oder Untermenü

Um Hilfe zum aktuellen Menü oder Untermenü aufzurufen

• Geben Sie in der Kommandozeile oder im Feld Code ein Fragezeichen (?) ein und drücken Sie EINGABE.

  Oder:
  Drücken Sie PF1 (Help).

  Der entsprechende Bildschirm mit einer deutschen Beschreibung der Menüfunktionen erscheint, z.B. Hilfe für Entwicklungsfunktionen.

  Wenn Sie das Feld Markieren für weitere Hilfe .. _ markieren, wird das Menü der Natural Help Utility angezeigt.

Hilfe zu einem Feld

Um Hilfe zu einem Feld aufzurufen

1. Stellen Sie den Cursor in das betreffende Feld, z.B. Name, und geben Sie ein Fragezeichen (?) ein.

2. Drücken Sie EINGABE.

   Der entsprechende Bildschirm mit einer deutschen Beschreibung des Felds erscheint, z.B. Hilfe für Objektnamen.

   Wenn Sie das Feld Markieren für weitere Hilfe .. _ markieren, wird das Menü der Natural Help Utility angezeigt.