RUNQQ

Run-Time Function: Executes another program and waits for it to complete.

Module: USE DFLIB

Syntax

result = RUNQQ (filename, commandline)

filename
(Input) Character*(*). Filename of a program to be executed.

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

Results:

The result is of type 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

See Also: SYSTEM, NARGS

Example

See example in NARGS.

 USE DFLIB
 INTEGER(2) result
 result = RUNQQ('myprog', '-c -r')
 END