callCmd()

Die Systemfunktion 'sysLib.callCmd()' führt einen Systembefehl aus und wartet, bis der Befehl fertig abgeschlossen ist, bevor die Verarbeitung fortgesetzt wird. Diese Funktion ist mit der I4GL-Anweisung RUN kompatibel. Sie können diese Funktion verwenden, um Nicht-EGL-Programme oder -Scripts zu starten.

Der ausgeführte Systembefehl muss für das aktuell ausgeführte Programm sichtbar sein. Betrachten Sie beispielsweise die folgende Anweisung:
sysLib.callCmd("mySpecialProgram.exe")
Das Programm "mySpecialProgram.exe" muss sich in einem Verzeichnis befinden, auf das die Umgebungsvariable PATH zeigt. Sie können auch die vollständige Verzeichnisposition angeben, wie im folgenden Beispiel:
sysLib.callCmd("program files/myWork/mySpecialProgram.exe")

Verwenden Sie die Funktion 'sysLib.startCmd()', um einen Systembefehl zu initiieren und die Verarbeitung ohne Wartezeit fortzusetzen.

Sowohl 'sysLib.callCmd()' als auch 'sysLib.startCmd()' ordnen den vom Systembefehl zurückgegebenen Wert der Systemvariablen 'sysVar.returnCode' zu. Der Systembefehl muss einen Wert zurückgeben, der mit dem Typ INT zuordnungskompatibel ist.

Syntax

  sysLib.callCmd(
    Befehl STRING in
    [, Modus STRING in] )
Befehl
Gibt den Namen des aufzurufenden Betriebssystembefehls oder Programms an.
Modus
Hierbei kann es sich um ein Literal oder eine Variable handeln, das/die eines der folgenden Wörter enthält:
form
Kurzform für 'formatted' (formatiert), wird auch als unaufbereiteter Modus bezeichnet. Jedes Zeichen der Eingabe wird dem Programm während der Eingabe bereitgestellt, und jeder Anschlag auf der Tastatur wird direkt an den angegebenen Befehl übergeben.
line
Informationen werden erst dann an den angegebenen Befehl gesendet, wenn die Eingabetaste gedrückt wird.

Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität für 'callCmd()'
Plattform Problem
COBOL-Generierung Die Funktion 'sysLib.callCmd()' wird unter iSeries, nicht jedoch unter zSeries oder VSE unterstützt.
JavaScript-Generierung Die Funktion 'sysLib.callCmd()' wird nicht unterstützt.

Feedback