Top
PowerCOBOL V11.0 Reference
FUJITSU Software

5.41 Execute Method

Description:

Executes an application.

Used in controls:

DDE

Used in objects:

Form

Parameters:

1. VT_BSTR - CommandLineX(8192)
2.[VT_I4 - ShowWindowS9(9) COMP-5]

Description of Parameters:

CommandLine: The command line for the application to be executed.
Includes the application name, command line parameters and, if necessary, the full path name if that is different from the current directory and the path is not set in the PATH environment variable.

ShowWindow: The manner in which the application should be invoked.
This parameter can be omitted in calling from the Form object. If it is omitted PowerCOBOL uses POW-SWSHOWNORMAL as default.
Use the following constants to set the value of ShowWindow:
POW-SWHIDE: Starts the application in the background - it does not display a window.
POW-SWSHOWNORMAL: (Default) Activates the application using its default window size.
POW-SWNORMAL: Same as POW-SWSHOWNORMAL.
POW-SWSHOWMINIMIZED: Activates the application in the minimized state.
POW-SWSHOWMINNOACTIVE: Starts the application in the minimized state but leaves an active window unchanged.
POW-SWSHOWMAXIMIZED: Activates the application with the window maximized.

Return value:

Only the DDE control returns the return value.

VT_I4 - ReturnValueS9(9) COMP-5

Zero or greater indicates normal completion.
Negative indicates an error.

Examples:

See the Execute method examples

Backward compatibility
method name:

EXECAPL

Backward compatibility
arguments:

1. X(520)
2. S9(9)COMP-5