Freigeben über

SYS(16) - Dateiname des ausgeführten Programms

  • Artikel

Gibt den Dateinamen des ausgeführten Programms zurück.

SYS(16 [, nProgramLevel])

Rückgabewerte

Zeichen

Parameter

  • nProgramLevel
    Gibt an, von wie vielen Programmebenen zurück der Name ermittelt werden soll. Dieser Wert kann von 1 bis zu der Stufe reichen, auf der die Programme verschachtelt sind.

    Ist nProgramLevel 0 oder 1, gibt SYS(16) den Namen des Hauptprogramms (des zuerst ausgeführten Programms) zurück. Wenn nProgramLevel weggelassen wird, wird der Name des gerade ausgeführten Programms zurückgegeben. Wenn nProgramLevel größer als die Programmverschachtelungstiefe ist, wird eine leere Zeichenfolge zurückgegeben.

Hinweise

Diese Funktion erweist sich beim Zurückverfolgen von Fehlern als nützlich. SYS(16) entspricht PROGRAM( ). SYS(16) gibt jedoch mit dem Programmnamen einen Pfad zurück, während PROGRAM( ) nur den Programmnamen liefert.

Wird eine Prozedur oder Funktion ausgeführt, liefert SYS(16) nach dem Namen der Prozedur oder Funktion den Namen der Datei, in der die Prozedur oder Funktion enthalten ist.

Ist das ausgeführte Programm Teil einer Anwendung (APP), gibt SYS(16) nur den Namen des Programms zurück. Der Pfad wird hierbei nicht zurückgegeben.

Beispiel

Die Programmverschachtelung wird in dem folgenden kurzen Programmbeispiel zurückgegeben:

STORE 1 TO gnX
DO WHILE LEN(SYS(16,gnX)) != 0
   ? SYS(16,gnX)
   STORE gnX+1 TO gnX
ENDDO

Siehe auch

LINENO( ) | ON ERROR | PROGRAM( ) | SYS( ) - Funktionen - Überblick