@Execute

Startet ein OS/2-EXE Programm OSPATH OSPATH1 mit den Parametern TEXT TEXT2 im Modus FN MODE3 als Child-Process der API-Engine.

MODE3:
0 = Start des Child-Process und parallele Fortführung des API-Engine
Programms.
1 = Start des Child-Process und Warten auf dessen Beendigung.

Wird die @Funktion mit zwei Parametern aufgerufen, wird für MODE3 der Wert 0 angenommen. Außerdem können mit @Execute auch OS/2-CMD-Dateien ausführt werden.

Return-Wert der @Funktion:
Bei der parallelen Ausführung wird die Process-ID des Child-Processes zurückgegeben, bei Ausführung mit Warten der Return-Code der OS/2-EXE.

Beispiel: @Execute(OSPATH1;TEXT2)

OSPATH1:="CLEAN.EXE";
TEXT2:="*.BAK";
@Execute(OSPATH1;TEXT2);

Entspricht dem Befehl "CLEAN.EXE *.BAK"
in einem OS/2-Gesamtbildschirm oder OS/2-Fenster.
Es wird nicht auf die Beendigung des XCOPY-Programms gewartet.

Beispiel: @Execute(OSPATH1;TEXTLIST2)

OSPATH1:="CLEAN.EXE";
TEXTLIST2:="*.BAK":"*.BK!":"*.OLD";
@Execute(OSPATH1;TEXTLIST2);

Entspricht dem Befehl "CLEAN.EXE *.BAK *.BK! *.OLD"
in einem OS/2-Gesamtbildschirm oder OS/2-Fenster.
Es wird nicht auf die Beendigung des XCOPY-Programms gewartet.

Beispiel: @Execute(OSPATH1;TEXT2;MODE3)

OSPATH1:="XCOPY.EXE";
TEXT2:="C:\\NOTES\\*.NSF H:\\BACKUP\\NSF /s/e";
MODE3:=0;
@Execute(OSPATH1;TEXT2;MODE3);

Entspricht dem Befehl "XCOPY C:\NOTES\*.NSF H:\BACKUP\NSF /s/e"
in einem OS/2-Gesamtbildschirm oder OS/2-Fenster.
Es wird nicht auf die Beendigung des XCOPY-Programms gewartet.

Beispiel: @Execute(OSPATH1;TEXTLIST2;MODE3)

OSPATH1:="XCOPY.EXE";
TEXTLIST2:="C:\\NOTES\\*.NSF":"H:\\BACKUP\\NSF":"/s/e";
MODE3:=1;
@Execute(OSPATH1;TEXTLIST2;MODE3);

Entspricht auch dem Befehl "XCOPY C:\NOTES\*.NSF H:\BACKUP\NSF /s/e"
in einem OS/2-Gesamtbildschirm oder OS/2-Fenster.
Hier wird auf die Beendigung des XCOPY-Programms gewartet.