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 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.

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.