RxWinExec (Windows only)

>>-RxWinExec(-cmdline--+------------+--)-----------------------><
                       +-,--cmdshow-+

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 Object Rexx 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 Windows system error codes. 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.

Common error returns for this function are as follows.

2

The specified file was not found.

3

The specified path was not found.

11

The EXE file is invalid.

-53

The network path is invalid.