# RUNQQ

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

## Module

USE IFPORT

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.

## Example

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

See also the example in NARGS.

Parent topic: Q to R

## See Also

NARGS
SYSTEM
NARGS