Starts (executes) the application as specified in cmdline.
A string containing a file name and optional parameters for the application to be executed. If the name of the executable file in cmdline does not contain a directory path, RxWinExec searches for the executable file in this sequence:
The directory from which Object Rexx was loaded.
The current directory.
The Windows system directory.
The Windows directory.
The directories listed in the PATH environment variable.
Specifies how a Windows-based application window is to be shown. For a non-Windows-based application, the PIF file, if any, for the application determines the window state.
Activates and displays a window.
Displays the window while the current active window remains active.
Displays the window as a minimized window, the current active window remains active.
Activates the window and displays it as a minimized window.
Activates the window and displays it as a maximized window.
Hides the window and activates another window.
Minimizes the specified window and activates the next top-level window in the Z order.
If the application is started successfully, the process id (PID) is returned. If an error occurs the returned value is less than 32.
Error return codes correspond to a Windows System Error code. If the Windown system error code is greater than 32 it is negated. This is to prevent confusion between a legitimate error code and a PID.
Some common error returns for this function are as follows.
The specified file was not found.
The specified path was not found.
The EXE file is invalid.
The network path is invalid.