Equinox Online Help - Language Reference - A to Z
ExecuteWaitForTask |
| Applies to |    |
| Syntax | ExecuteWaitForTask TaskHandle [, WaitExpression] |
| Action | [Statement] Waits until a remotely executed task has completed. |
| Scope | Usable anywhere |
| Notes | The TaskHandle parameter is the value returned in SysReply after a task was successfully started remotely using the ExecuteSetMode and Execute statements.
The WaitExpression parameter allows you to specify how to wait for the remote client to finish, and may take one of the following values:
-1
0
1
2
return immediately.
wait and display an hourglass (default).
wait and display the Equinox running dialog.
wait and display a dialog with Halt, Continue and Abort buttons.
The system workarea SysError is set to a non-zero value if an error occurs, otherwise zero.
SysResult contains the status of the task:
-4
-3
-2
-1
0
1
2+
Operational error. The remote client is improperly configured or installed.
Unable to execute. For example, the parameter file did not exist.
Did not start. The remote client executed and logged in, but was unable to initialise.
Running
Finished ok
Finished with an error. SysError was nonzero after the task finished in the remote client.
Finished with a user defined result. The remote task executed a statement SysResult = value.
|
| Category | Remote task handling |
| See Also | Execute, ExecuteFalTorPan, ExecuteGetStatus, ExecuteMindMeld, ExecuteSetDataIn, ExecuteSetData, ExecuteSetDataOut, ExecuteSetMode, ExecuteWaitForTask |
| Example | |
