| Navigation: Language Reference > 13 - Built-in Functions >====== RUNCODE (return program exit code) ====== |    |
RUNCODE( )
The RUNCODE procedure returns the exit code passed to the operating system from the command executed by the RUN statement. This is the exit code passed by the HALT statement in Clarion programs and is the same as the DOS ERRORLEVEL. RUNCODE returns a LONG integer which may be any value that is returned to DOS as an exit code by the child program.
The child program may only supply a BYTE value as an exit code, therefore negative values are not possible as exit codes. This fact allows RUNCODE to reserve these values to handle situations in which an exit code is not available:
0 normal termination
-1 program terminated with Ctrl-C
-2 program terminated with Critical error
-3 TSR exit
-4 program did not run (check ERROR())
Return Data Type: LONG
Example:
RUN('Nextprog.exe') !Run next program
IF RUNCODE() = -4
IF ERROR() = 'Not Enough Memory' !If program didn't run for lack of memory
MESSAGE('Insufficient memory') !display a message
RETURN !and terminate the procedure
ELSE
STOP(ERROR()) !terminate program
END
END
See Also: