C$SYSTEM

The C$SYSTEM library routine executes a program from an isCOBOL application.

On Linux/Unix the C$SYSTEM library routine uses Java API. In order to make it reflect the system() C library function behavior, set the iscobol.system.exec property to the special value “c”.

Syntax:

CALL "C$SYSTEM" USING commandLine                        [flags]                 GIVING systemStatus

Parameters:

commandLine	PIC X(n)	Specifies the operating system command to be executed.
flags	any numeric data item	It specifies a value that affect the behavior of the library routine. The value is calculated by combining one or more of the following values, defined in iscobol.def:
		CSYS-ASYNC	The command specified in commandLine is executed asynchronously.
		CSYS-MAXIMIZED	The command window, if any, is shown maximized. It works only on Windows.
		CSYS-MINIMIZED	The command window, if any, is shown minimized. It works only on Windows.
		CSYS-HIDDEN	The command window, if any, is not shown. It works only on Windows.
		CSYS-SHELL	Only on Windows, the system command interpreter (usually cmd.exe) is used to run the command specified in commandLine.
		CSYS-DESKTOP	The command is executed client side in thin client environment. This flag is supported for compatibility. It’s preferable to call the routine using CALL CLIENT in order to obtain the same result.

Note - The flags CSYS-MAXIMIZED, CSYS-MINIMIZED and CSYS-HIDDEN require jna libraries (installed along with isCOBOL) in the Classpath.

Return code:

systemStatus can be any signed numeric data item. It receives the exit status of commandLine.

Examples:

Example - Run notepad.exe and wait for it to finish

call "c$system" using "notepad.exe"