Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

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 operating system process 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.

See Also