RUNQQ

 

Portability Function: Executes another program and waits for it to complete.

Module

USE IFPORT

Syntax

result = RUNQQ (filename,commandline)

filename

(Input) Character*(*). File name of a program to be executed.

commandline

(Input) Character*(*). Command-line arguments passed to the program to be executed.

Results

The result type is INTEGER(2). If the program executed with RUNQQ terminates normally, the exit code of that program is returned to the program that launched it. If the program fails, -1 is returned.

The RUNQQ function executes a new process for the operating system using the same path, environment, and resources as the process that launched it. The launching process is suspended until execution of the launched process is complete.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

Example

USE IFPORT

INTEGER(2) result

result = RUNQQ('myprog', '-c -r')

END

See also the example in NARGS.

See Also