executorexecute
executorexecute |
Purpose
Synopsis
function executorexecute(exec:Executor, inputfname:text, modelparams:array(set of string) of text):ModelExecution
function executorexecute(exec:Executor, inputfname:text):ModelExecution
Arguments
|
exec
|
The Executor with which to interact
|
|
inputfname
|
The filename containing the input data to submit to the execution. If an empty string, execution will be submitted with an empty input data file. May reference a Mosel I/O driver, e.g.
"mmsystem.text:myinputdata"
|
|
modelparams
|
Values of any additional model parameter to set for this execution. Module parameters such as
mmxprs.xprs_verbose may not be set using this array.
|
Return value
A record containing the execution id and the initial status.
Example
myexecution := executorexecute( myexecutor, "inputdata.dat" )
if myexecutor.status<>EXECUTOR_OK then
writeln("Error returned by Executor: ",myexecutor.lasterror)
exit(1)
end-if
Further information
1. After calling, check the value of
exec.status for any errors.
2. The procedure will not return until the execution has been submitted to the component or an error was detected.
3. Once submitted, the execution will be executed asynchronously. Use
executorpoll or
executorwaitfor to check the execution status.
4. Once deleted, the execution result, status and run log will not be available.
Related topics
getstatus,
executordelete,
executorwaitfor,
executorpoll,
executorfetchinput,
executorfetchresult,
executorfetchrunlog