Hilfe benutzen

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.

Verwandte Themen:

  • HELP - Systemkommandos-Dokumentation

  • LASTMSG - Systemkommandos-Dokumentation

Dieser Abschnitt behandelt folgende Themen:


Allgemeine Informationen – Natural-Help-Utility

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:

Natural-Help-Utility über Menü benutzen

Beginn der AnweisungslisteUm 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:

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

Beginn der AnweisungslisteUm ein Hilfethema direkt aufzurufen

  1. 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
  2. Drücken Sie EINGABE.

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

    11:36:16               ***** NATURAL HELP UTILITY *****              2011-10-20
                                       - EDIT -                        Page 1 of 3 
                                                                                   
    ------------------------------------------------------------------------------ 
                                                                                   
    Function: Invoke a Natural editor for the purpose of editing a Natural object. 
                                                                                   
    Parameters:                                                                    
      Object-type: Class(4), Copycode(C), Description(D), Function(7), Global(G),  
                   Helproutine(H), Local(L), Map(M), Parameter(A), Program(P),     
                   Subprogram(N), Subroutine(S) or Text(T).                        
                   -> 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.      
                                                                                   
    ------------------------------------------------------------------------------ 
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    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 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:

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.

Beginn der Anweisungsliste 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).

Beginn der AnweisungslisteUm 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 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.

Beginn der Anweisungsliste 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:37:15               ***** NATURAL HELP UTILITY *****              2011-10-20
      Library TEST          - Natural System Message NAT0082 -           Page 1 of 2 
                                                                                     
         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 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
    2. 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:41:44                    *****  NATURAL  *****                    2009-08-25
      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 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 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.

Beginn der Anweisungsliste 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.

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

Informationen zu Menüs und Felder

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.

Beginn der Anweisungsliste 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).

Beginn der Anweisungsliste Um Hilfe zu einem Feld aufzurufen

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

  2. Drücken Sie EINGABE.