Starts (executes) the application as specified in
cmdline.
Parameters:
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:
1
The directory from which ooRexx was loaded.
2
The current directory.
3
The Windows system directory.
4
The Windows directory.
5
The directories listed in the PATH environment variable.
cmdshow
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.
SHOWNORMAL
Activates and displays a window.
SHOWNOACTIVATE
Displays the window while the current active window remains
active.
SHOWMINNOACTIVE
Displays the window as a minimized window, the current active
window remains active.
SHOWMINIMIZED
Activates the window and displays it as a minimized window.
SHOWMAXIMIZED
Activates the window and displays it as a maximized window.
HIDE
Hides the window and activates another window.
MINIMIZE
Minimizes the specified window and activates the next top-level
window in the Z order.
Return codes:
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 Windows 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.
