RunEMUEScript |
Top Previous Next |
×V4.0Ø
Syntax - RunEMUEScript <ScriptToExecute> <WaitType> <TimeOut> Where: <ScriptToExecute> is a literal string or a variable containing a literal string. <WaitType> is a literal string or a variable that contains a literal string of value "Wait" or "NoWait." <TimeOut> is an integer or a variable containing an integer.
Description: This command is used to execute a EMUE script from inside the current script. The first parameter, <ScriptToExecute>, is the path and file name of the EMUE script to be launched. The second parameter, <WaitType>, determines if EMUE is to wait for the completion of the application.
The last parameter, <TimeOut>, is the maximum number of milliseconds that EMUE is to wait for the completion of the launched script before EMUE terminates the processing of the script with an error. If the launched script finishes before the specified timeout, then EMUE will immediately continue processing. The TimeOut option only applies if the WaitType is set to WAIT, otherwise it is ignored. If not provided, the default value for the <TimeOut> option is zero, which causes EMUE to wait indefinitely for the launched script to finish executing.
Note: If the Wait option is used with <TimeOut> unvalued or not included and the launched script never closes, then the script will hang indefinitely.
Note: For the <ScriptToExecute> parameter if there are spaces or parentheses in the path or file name, then the path and file name should appear in single quotes inside of the double quotes. These single quotes will be replaced by double quotes before the application is run. If this is not done EMUE will not be able to accurately parse the command statement and the application will not execute as expected. Files that contain spaces in the path or name should be enclosed in single quotes.
Note: If the application requires that the Current Path is set in a particular configuration. The SetCurrentPath command is used to accomplish this.
Note: This command was introduced in EMUE V4 and will not work with previous versions.
Sample 1: The following statement instructs EMUE to launch the EMUE script and wait up to 30 seconds for this script to complete. RunEMUEScript "C:\EMUE\Script.emue" Wait 30000
Sample 2: The following statement instructs EMUE to launch the EMUE script and will not wait for the launched script to complete. RunEMUEScript "C:\EMUE\Script.emue" NoWait
|